Webhooks

Los webhooks te permiten recibir notificaciones en tiempo real cuando ocurren eventos en tu espacio de trabajo.

Crear un Webhook

1. Ve a Configuración → Administrar Webhooks
2. Haz clic en Registrar Webhook
3. Ingresa la URL donde se enviarán las notificaciones
4. Opcionalmente agrega un secreto para la verificación de firma
5. Haz clic en Crear

Tipos de Eventos

Los webhooks se activan para estos eventos:

Evento	Cuándo se Dispara
ingestion.completed	Un trabajo de ingestión de datos finaliza
ingestion.failed	Un trabajo de ingestión de datos falla
kpi.computed	Se calcula un valor de KPI
kpi.alert	Se detecta una anomalía en un KPI
analysis.completed	Una investigación finaliza
dashboard.ready	Se completa la construcción de un dashboard

Formato del Payload

{
  "event": "ingestion.completed",
  "timestamp": "2025-01-15T10:30:00Z",
  "tenantId": "tenant_abc123",
  "data": {
    "jobId": "job_xyz",
    "table": "sales_data",
    "rowsIngested": 15234,
    "duration": 3200
  }
}

Verificación de Firma

Si configuraste un secreto, cada webhook incluye un encabezado X-Webhook-Signature con una firma HMAC-SHA256 del cuerpo:

X-Webhook-Signature: sha256=abc123...

Verifícalo en tu servicio:

const crypto = require('crypto')
const signature = crypto
  .createHmac('sha256', YOUR_SECRET)
  .update(requestBody)
  .digest('hex')
const isValid = signature === receivedSignature

Administrar Webhooks

Acciones

Acción	Descripción
Probar	Enviar un evento de prueba para verificar la conectividad
Historial de Entregas	Ver entregas anteriores con códigos de estado y marcas de tiempo
Eliminar	Eliminar el webhook

Historial de Entregas

Cada entrega muestra:

• Código de estado — 200 = éxito, otro = fallo
• Marca de tiempo — Cuándo se envió el evento
• Tiempo de respuesta — Cuánto tardó tu servidor en responder
• Reenviar — Volver a entregar un evento específico

Cola de Mensajes Fallidos (DLQ)

Las entregas fallidas van a la Cola de Mensajes Fallidos después de múltiples intentos de reintento. Desde la DLQ puedes:

• Ver eventos fallidos con mensajes de error
• Reproducir eventos individuales
• Reproducir Todos para reintentar todos los eventos fallidos

info

Política de reintentos: Las entregas fallidas se reintentan hasta 3 veces con retroceso exponencial (1 min, 5 min, 15 min). Después de que todos los reintentos fallen, el evento va a la DLQ.