Integraciones

Conecta tu pipeline. Lleva la evidencia.

Claves API, disparadores de escaneo, webhooks de despliegue y webhooks salientes. Conecta Crawlens a tu pipeline.

WebhooksClaves APIDeploy Webhooks
API

Superficies de Integración para Operaciones

Copia, pega y dispara verificaciones visuales desde tu pipeline CI/CD en menos de 5 minutos.

01

Webhooks

Recibe notificaciones en tiempo real al completarse los escaneos. Los payloads incluyen resultados de detección de cambios y diffs visuales.

02

Claves API

Genera claves de API propias para acceder al sistema.

03

Deploy Webhooks

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

webhook-payload.json
{
  "event": "crawl.success",
  "timestamp": "2026-01-15T10:30:00Z",
  "url_id": "67d0f9ab12cd34ef56a7b890",
  "url": "https://example.com/checkout",
  "snapshot_id": "67d0f9ab12cd34ef56a7b891"
}
scan-trigger.sh
curl -X POST "$API_BASE/api/projects/$PROJECT_ID/scan" \
  -H "Authorization: Bearer $CRAWLENS_API_KEY" \
  -H "X-Org-ID: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"triggered_by":"ci"}'
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.

FREE

Los webhooks y las reglas de alerta están desactivados en Free; la documentación de la API está abierta.

PRO

Hasta 2 webhooks y 10 reglas de alerta, incluyendo escaneos por CI/CD.

AGENCY

Capacidad de webhooks y alertas para una cartera de sitios (25 webhooks / high-capacity reglas de alerta), con historial de evidencia más largo y más asientos.

Webhooks

Ejemplos Reales de API

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

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"}
  }'
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"}'
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
Seguridad y garantías de entrega
  • 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.
Endpoints

Arquitectura webhook verificada

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

01

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
02

Trigger inbound de escaneo

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

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

Webhook de marcador de despliegue

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

POST /api/projects/{project_id}/deployments
04

Panel de evidencia operativa

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

Estadísticas de entrega · 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
}
Reenvío · 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"
Catálogo

Cobertura de Integraciones

Cobertura actual por herramienta. GA = soporte directo hoy, Próximamente = roadmap.

GA

GitHub Actions

Activa pruebas desde tu CI/CD.

GA

GitLab CI

Dispara scans desde GitLab vía API/webhook.

GA

Jenkins

Checks visuales post-build usando scan trigger API.

GA

CircleCI

Ejecuta pruebas visuales en CircleCI vía API/webhook.

GA

Slack

Entrega de alertas por canal webhook de Slack.

GA

Vercel

Pruebas durante deploy.

GA

Netlify

Deploy hooks funcionales.

Próximamente

Discord

El adapter específico para Discord está planificado.

Próximamente

PagerDuty

El conector dedicado de PagerDuty está planificado.

GA — Las integraciones GA son soportadas directamente mediante endpoints de API/escaneo/despliegue.Próximamente — Las integraciones Próximamente quedan visibles en roadmap y pasarán de uso genérico webhook/API a soporte nativo.

Lleva la evidencia.

Claves API, disparadores de escaneo, webhooks de despliegue y webhooks salientes. Conecta Crawlens a tu pipeline.

Obtén soporte ↗