Problemas de entrega de webhooks
Webhooks que no llegan, fallan la verificación, llegan tarde o llegan dos veces, y qué revisar en Recent deliveries.
Qué conseguirá
Averiguará por qué falta un webhook o por qué se rechaza.
Mire primero Recent deliveries
Abra el webhook y lea Recent deliveries. La fila de una llamada muestra el código de estado y cualquier error, y le dice casi todo lo que necesita.
Síntomas
| Síntoma | Causa probable | Solución |
|---|---|---|
| No hay entregas | El agente no envía a este webhook, o Webhook está desactivado en sus Tools | Abra el agente, Tools, Built-in, active Webhook y elíjalo en Send to |
| No se envió para una llamada | La llamada no terminó, o la revisión aún no se ejecutó | Espere a que se revise la llamada; call.completed se envía cuando lo está |
call.started o tool.called nunca llegan | El evento no está marcado en Events, el webhook está en pausa, la llamada empezó antes de marcarlo, o el agente no envía a este webhook | Márquelo, active el webhook, guarde y haga una llamada nueva |
Faltan algunos tool.called de una llamada muy activa | Había más de 50 eventos esperando porque su punto de conexión respondía despacio | Responda 2xx rápido y haga el trabajo después |
| Estado 401 o 403 en la fila | Su punto de conexión rechazó la solicitud | Revise su autenticación; los 4xx no se reintentan |
| Estado 5xx o tiempo agotado | Su servidor falló o fue demasiado lento | Arréglelo, o aumente Timeout; los 5xx y los tiempos agotados se reintentan hasta Attempts |
| Un error sobre la dirección | URL privada o interna, o que no es http(s) | Use una dirección pública |
| La firma no coincide | Cuerpo reserializado, cabecera equivocada o secreto equivocado | Consulte Verifique las firmas de los webhooks |
| La prueba funciona, las llamadas reales no | El agente no envía a este webhook, el webhook está en pausa, o la llamada empezó antes de guardar | Revise Send to del agente y que el webhook esté activo, y haga una llamada nueva |
| La misma llamada llega dos veces | Un reintento tras una respuesta lenta | Responda 2xx rápidamente e ignore un call_id repetido |
| Al payload le falta una sección | No se marcó en What to send | Márquela y guarde |
Llega con review.status igual a pending | La revisión no había terminado | Consulte la llamada más tarde por la API para obtener la revisión completa |
Prueba
Elija Send test y observe la nueva fila en Recent deliveries. Después haga una llamada real corta.
Resultado esperado
Una fila marcada como correcta con estado 200 por cada llamada terminada.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.