Diagnóstico: Los eventos de conversaciones no se reflejan en el webhook o CRM externo

Los eventos de conversaciones y mensajes generados en Waclis Inbox no se registran en el Webhook receptor, servidor de base de datos o CRM externo configurado. Esta guía detalla cómo diagnosticar fallos en la entrega de Webhooks salientes.

Síntoma y Significado

Síntoma

Ocurren interacciones en Waclis Inbox pero el servidor externo no recibe los paquetes HTTP POST o reporta errores continuos en su consola de logs.

Significado técnico

El despachador de Webhooks de Waclis Inbox intentó entregar el evento en la URL configurada pero la petición falló debido a un error de red, certificado SSL inválido, timeout en la respuesta o código de estado HTTP de error (4xx o 5xx) devuelto por el servidor receptor.

Comprobación rápida y Causas

Comprobación rápida

• En Waclis Inbox, ve a Ajustes > Integraciones > Webhooks y revisa el indicador de estado del webhook.
• Haz clic en el botón de prueba para enviar un payload simulado y observar la respuesta del servidor.

Causas principales

1. Fallo en la verificación de firma HMAC: El servidor receptor calcula incorrectamente el hash SHA256 o utiliza un Secret Token desactualizado.
2. Timeout en el endpoint externo: El servidor receptor demora más del tiempo de espera permitido en responder con HTTP 200 OK.
3. Filtro de firewall o bloqueo de IP: El servidor de destino bloquea peticiones de agentes de red no autorizados.

Solución paso a paso

Paso 1: Auditar los registros de entrega

1. En Ajustes > Webhooks, abre la configuración del webhook afectado y consulta el historial de entregas recientes.
2. Examina el código HTTP retornado (ej. HTTP 500 Internal Server Error o HTTP 403 Forbidden).

Paso 2: Probar el endpoint receptor

1. Verifica en el servidor receptor que la función de procesamiento responda con HTTP 200 OK de inmediato al recibir la carga, procesando tareas pesadas de forma asíncrona.
2. Verifica que la comprobación de la cabecera X-Waclis-Signature utilice el raw body sin modificaciones ni formateos previos.
3. Guarda la configuración y presiona Reenviar evento de prueba.

Comprobación

Dispara un mensaje de prueba en un chat y confirma en la pestaña de entregas del webhook que la petición figure con estado exitoso (200 OK).

Límites y buenas prácticas

Si el servidor de destino devuelve reiterados errores 5xx de forma continua, el motor de Waclis Inbox aplicará reintentos automáticos con retroceso exponencial antes de pausar temporalmente el webhook.

Artículos relacionados

• Webhooks salientes en tiempo real y verificación de firma de seguridad HMAC-SHA256