Problemas con webhooks
El Incoming Webhook no responde, faltan valores en la conversación, el saludo se retrasa o las estadísticas muestran errores.
Cuando suena el teléfono, el Incoming Webhook carga datos de tu sistema, por ejemplo el nombre de quien llama desde tu CRM. Después, la respuesta está disponible como variables en el saludo y en el prompt. Las Estadísticas del Webhook de las últimas 24 horas y las Últimas llamadas webhook en la pestaña Personalidad muestran si funciona bien.
El webhook falla
| Posible causa | Solución |
|---|---|
| Tu endpoint no responde con el estado 200 | Solo una respuesta con 200 cuenta como éxito. Revisa el log de tu sistema |
| La respuesta no es un objeto JSON | Responde con un objeto, por ejemplo {"name": "Lucía García"}. Una lista o texto plano no se toma como variables |
| Faltan headers o son incorrectos | Comprueba el nombre y el valor en Headers HTTP, por ejemplo Authorization: Bearer … |
| La Plantilla del cuerpo de solicitud no es un JSON válido | El panel muestra Formato JSON inválido. Deja el campo vacío y bhomy enviará todas las variables disponibles |
| Tu endpoint solo permite determinadas direcciones IP | El agente llama desde la nube, sin una dirección IP fija. Protege el endpoint con un header en lugar de con una lista de IP permitidas |
Cómo comprobarlo: haz clic en Probar webhook › Enviar prueba. bhomy envía una solicitud con datos de ejemplo y muestra la respuesta.
El saludo llega con retraso
El saludo espera a que tu webhook responda, porque puede contener valores de la respuesta. Si tu sistema no responde a tiempo, bhomy lo intenta 2 veces más. Solo después empieza la conversación con los Valores de respaldo.
| Solución | Efecto |
|---|---|
| Bajar el timeout, se recomiendan de 3000 a 5000 milisegundos | Un sistema lento retrasa menos el saludo |
| Responder rápido | Lee solo los campos que necesitas y usa un índice para buscar por número de teléfono |
| Definir valores de respaldo | La conversación suena natural aunque no haya respuesta |
Faltan valores en la conversación
| Posible causa | Solución |
|---|---|
| El marcador no se llama igual que el campo de la respuesta | {{first_name}} necesita exactamente "first_name" en la respuesta |
| El valor está dentro de un objeto anidado | Responde con una estructura plana, por ejemplo {"customer_name": "…"} en lugar de {"customer": {"name": "…"}} |
| El webhook falló y no hay valor de respaldo | Define un sustituto en Valores de respaldo. El panel muestra las variables sin respaldo en Valores de respaldo faltantes |
Las estadísticas muestran una tasa de error alta
El aviso ¡Tasa de error alta! aparece cuando muchas llamadas al webhook de las últimas 24 horas han fallado. Abre Últimas llamadas webhook: ahí ves en cada llamada si funcionó y cuánto tardó. Si se acumulan los tiempos de espera agotados, tu sistema es demasiado lento. Si se acumulan los códigos de error, revisa la dirección y los headers.
El webhook después de la llamada no llega
Es la herramienta Ticket CRM en Automatización. Consulta Integraciones.
Más ayuda
Envíanos la hora de la llamada, el tiempo de respuesta que aparece en Últimas llamadas webhook y el código de estado de tu sistema, consulta Informar de un problema.
¿Te ha sido útil esta página?