Webhooks
Ejecucion de pruebas, logging, configuracion asistida por IA y analiticas de webhooks.
Ejecucion de Pruebas
Antes de activar un webhook en produccion, puedes ejecutar una prueba manual para verificar que el endpoint destino responde correctamente:
POST /api/v1/integrations/webhooks/{webhook_id}/test
{
"sample_payload": { "event": "task.created", "task_id": "test_123" }
}La prueba envia el payload al endpoint configurado y retorna el resultado:
| Campo | Descripcion |
|---|---|
status_code | Codigo HTTP de respuesta del destino |
response_body | Cuerpo de la respuesta (truncado a 1 KB) |
latency_ms | Tiempo de respuesta en milisegundos |
success | true si el status esta entre 200-299 |
Logging de Entregas
Cada entrega de webhook se registra con informacion detallada para depuracion:
| Campo | Tipo | Descripcion |
|---|---|---|
delivery_id | string | Identificador unico de la entrega |
webhook_id | string | Webhook que origino la entrega |
event_type | string | Tipo de evento disparador |
payload | object | Payload enviado |
status_code | int | Codigo de respuesta HTTP |
attempt | int | Numero de intento (1-5) |
latency_ms | int | Latencia de la entrega |
created_at | datetime | Momento de la entrega |
Los logs se conservan por 30 dias y se consultan via:
GET /api/v1/integrations/webhooks/{webhook_id}/deliveries?limit=50&skip=0Reintentos Automaticos
Cuando una entrega falla (status >= 400 o timeout), el sistema reintenta automaticamente:
| Intento | Delay |
|---|---|
| 1 | Inmediato |
| 2 | 30 segundos |
| 3 | 5 minutos |
| 4 | 30 minutos |
| 5 | 2 horas |
Despues del quinto intento fallido, el webhook se marca como failing y se
notifica al administrador. No se desactiva automaticamente.
Configuracion Asistida por IA
El asistente de IA puede sugerir configuraciones de webhook basandose en la descripcion del caso de uso:
POST /api/v1/integrations/webhooks/ai-config
{
"description": "Notificar a Slack cuando se complete una tarea critica"
}El sistema analiza la descripcion y sugiere:
- Eventos a suscribir
- Filtros recomendados
- Formato del payload
- Headers de autenticacion
El usuario revisa y aprueba la configuracion antes de activarla.
Analiticas de Webhooks
El dashboard de analiticas muestra metricas agregadas por webhook:
- Tasa de exito — Porcentaje de entregas exitosas (ultimos 7 dias)
- Latencia promedio — Tiempo medio de respuesta del destino
- Entregas por dia — Volumen de entregas en el periodo
- Errores frecuentes — Top 5 codigos de error recibidos
Las metricas se consultan via GET /api/v1/integrations/webhooks/{webhook_id}/analytics.