Integraciones

Superficies de Integración para Operaciones

Claves API, trigger de workflows, webhooks de deploy y webhooks salientes. Conecta Crawlens al pipeline sin sobreprometer adaptadores nativos.

Webhooks

Recibe notificaciones al instante cuando los escaneos terminen. Con agrupación inteligente y Core Web Vitals.

Claves API

Genera claves de API propias para acceder al sistema.

Deploy Webhooks

Conecta hooks de implementación de Vercel o Netlify para activar pruebas automáticamente después de cada implementación.

Ver Documentación API

webhook-payload.json

{
  "event": "crawl.success",
  "timestamp": "2026-01-15T10:30:00Z",
  "url_id": "67d0f9ab12cd34ef56a7b890",
  "url": "https://example.com/checkout",
  "snapshot_id": "67d0f9ab12cd34ef56a7b891"
}

Acceso de integraciones según plan

Las integraciones son por organización. Los límites y controles avanzados se aplican por plan para escalar con gobierno técnico.

Starter

Documentación API y referencias básicas de setup. Webhooks salientes y reglas de alerta no están habilitados.

Pro

Hasta 5 webhooks y 10 reglas de alerta, con workflows por CI/CD y enrutamiento de notificaciones.

Enterprise

Capacidad de políticas de webhooks y alertas (high-capacity webhooks / high-capacity reglas), soporte de integraciones personalizadas y controles de rollout con gobernanza.

CI/CD

Ejemplos Reales de API

Copia, pega y activa pruebas visuales desde tu flujo de trabajo de CI/CD existente en menos de 5 minutos.

workflow-trigger.sh

curl -X POST "$API_BASE/api/workflows/$WORKFLOW_ID/trigger" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"triggered_by":"webhook"}'

deployment-webhook.sh

curl -X POST "$API_BASE/api/projects/$PROJECT_ID/deployments" \
  -H "Content-Type: application/json" \
  -H "X-Webhook-Secret: $WEBHOOK_SECRET" \
  -d '{
    "version":"v1.4.2",
    "author":"release-bot",
    "commit_msg":"checkout css fixes",
    "commit_sha":"1a2b3c4d",
    "environment":"production"
  }'

webhook-register.sh

curl -X POST "$API_BASE/api/webhooks" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "provider":"custom",
    "url":"https://hooks.example.com/crawlens",
    "events":["crawl.success","crawl.failed"],
    "secret":"whsec_prod_123",
    "headers":{"X-Env":"production"}
  }'

Eventos webhook salientes soportados

crawl.success - se envía cuando el crawl termina correctamente
crawl.failed - se envía cuando el crawl falla
alert.rule_triggered - se envía cuando se dispara una regla de alerta

Headers de entrega

X-Webhook-Event: <event_name>
X-Webhook-Delivery: <delivery_id>
X-Webhook-Idempotency-Key: <event:id>
X-Webhook-Signature: sha256=<hmac>   # only when secret is set

inbound-webhook-trigger.sh

curl -X POST "$API_BASE/api/webhook/trigger" \
  -H "Content-Type: application/json" \
  -H "X-Hub-Signature-256: sha256=<hmac_signature>" \
  -d '{"project_id":"$PROJECT_ID"}'

Arquitectura webhook verificada

Esta sección está alineada con rutas activas del backend y comportamiento real de entrega.

Webhooks salientes (por organización)

Crea/gestiona suscripciones salientes e inspecciona historial de entregas. Limitado por plan.

POST /api/webhooks
GET /api/webhooks
PATCH /api/webhooks/{id}
DELETE /api/webhooks/{id}
GET /api/webhooks/{id}/deliveries
GET /api/webhooks/stats
POST /api/webhooks/{id}/deliveries/{delivery_id}/redrive

Trigger inbound de workflow

Acepta llamadas webhook entrantes firmadas e inicia scans/workflows desde sistemas externos.

POST /api/webhook/trigger
GET /api/webhook/status/{task_id}

Webhook de marcador de despliegue

Registra eventos de deploy para correlacionar releases con cambios visuales y de performance.

POST /api/projects/{project_id}/deployments

Seguridad y garantías de entrega

El comportamiento de entrega está diseñado para confiabilidad operativa y trazabilidad.

Entrega firmada: X-Webhook-Signature (HMAC SHA-256) cuando hay secret configurado.
Protección inbound: verificación X-Hub-Signature-256 para trigger y X-Webhook-Secret opcional para deploy.
Retries asíncronos con backoff, soporte de redrive endpoint e historial de entregas para triage de incidentes.

GA Las integraciones GA se soportan hoy directamente con endpoints de API/workflow/deploy.

Próximamente Las integraciones Próximamente quedan visibles en roadmap y pasarán de uso genérico webhook/API a soporte nativo.

Panel de evidencia operativa

Salidas concretas de webhook stats y flujos de redrive para que operaciones actúe durante incidentes.

webhook-stats-response.json

{
  "window_hours": 24,
  "totals": {
    "pending": 2,
    "success": 183,
    "failed": 7,
    "completed": 190
  },
  "success_rate": 0.9632,
  "p95_delivery_latency_ms": 842.5,
  "avg_attempts": 1.18,
  "retry_ratio": 0.091
}

webhook-redrive.sh

curl -X POST "$API_BASE/api/webhooks/$WEBHOOK_ID/deliveries/$DELIVERY_ID/redrive" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID"