Incoming Webhook
Cargar datos de tu CRM o tu sistema al sonar el teléfono y usarlos como variables en el saludo y el prompt. Solicitud, respuesta, valores de respaldo y estadísticas.
Con el Incoming Webhook, tu agente sabe quién llama en cuanto suena el teléfono. bhomy envía el número de quien llama a tu URL, tu sistema responde con datos como el nombre, el número de cliente o el último pedido, y el agente los usa como variables. Así saluda por su nombre a los clientes habituales o conoce el estado de un pedido.
Cómo funciona
- Entra una llamada.
- bhomy envía una solicitud con los datos de la llamada a tu URL.
- Tu sistema busca a quien llama y responde con un objeto JSON.
- Cada campo de la respuesta está disponible como variable, por ejemplo
{{name}}. - El agente saluda a quien llama con los valores de tu respuesta.
El webhook funciona en las llamadas entrantes. En las salientes, pasas los datos directamente en el context de la API Outbound.
Configurarlo
- Abre tu agente y quédate en la pestaña Personalidad.
- Abre la sección Webhook entrante y activa Webhook activado.
- Elige el Método:
POSToGET. - Introduce la URL del webhook, por ejemplo la URL de producción de un webhook de n8n.
- Ajusta el Timeout (ms). Se recomiendan de 3000 a 5000 milisegundos.
- Opcional: introduce Headers HTTP, por ejemplo
Authorizationcon un token secreto. - Opcional: define una Plantilla del cuerpo de solicitud. Si la dejas vacía, bhomy envía todas las variables disponibles.
- Define Valores de respaldo por si tu sistema no responde.
- Comprueba todo con Probar webhook › Enviar prueba y guarda.
La solicitud
Sin plantilla propia, bhomy envía estos campos. Con POST como JSON en el cuerpo; con GET, como parámetros de consulta:
| Campo | Contenido |
|---|---|
callId | ID único de la llamada |
fromNumber | número de quien llama en formato E.164 |
toNumber | número llamado en formato E.164 |
roomName | identificador interno de la sesión de conversación |
participantIdentity | identificador interno de quien llama en la sesión |
assistantId | ID de tu agente |
assistantName | nombre de tu agente |
{
"callId": "call_8f2a1c",
"fromNumber": "+491701234567",
"toNumber": "+494012345678",
"roomName": "call-8f2a1c",
"participantIdentity": "sip_+491701234567",
"assistantId": "6a90…",
"assistantName": "Recepción Clínica Sommer"
}
Con tu propia Plantilla del cuerpo de solicitud defines tú la estructura e insertas los campos como marcadores, por ejemplo:
{ "phone": "{{fromNumber}}", "line": "{{toNumber}}", "source": "bhomy" }
La respuesta
Responde con el estado 200 y un objeto JSON plano. Cada campo se convierte en una variable:
{
"name": "Anna Berger",
"customer_number": "K-10442",
"last_appointment": "12 de octubre",
"open_invoice": "no"
}
En el prompt y en el saludo usas los valores con llaves dobles:
Saludo: Buenos días, {{name}}, gracias por llamar. ¿En qué puedo ayudarle?
Tiempos y valores de respaldo
El saludo espera a que tu webhook responda. Si tu sistema no responde con 200 o no lo hace dentro del timeout, bhomy lo intenta 2 veces más tras una breve pausa. Si sigue sin respuesta, la conversación empieza con los Valores de respaldo. Cada valor de respaldo se aplica también si tu respuesta no incluye un campo.
| Variable | Respaldo | Saludo sin respuesta |
|---|---|---|
name | estimado cliente | «Buenos días, estimado cliente…» |
En Valores de respaldo faltantes, el panel muestra cada variable que aparece en el prompt o en el saludo y no tiene respaldo. Sin respaldo y sin respuesta, bhomy quita el marcador.
Seguridad
| Punto | Recomendación |
|---|---|
| Autenticación | Comprueba en tu sistema un header secreto, por ejemplo Authorization: Bearer …. No hay direcciones IP fijas, el agente llama desde la nube |
| Cifrado | Usa una dirección HTTPS |
| Minimización de datos | Responde solo con los campos que el agente necesita en la conversación. Todo lo que haya en la respuesta puede decírselo a quien llama |
Estadísticas y últimas llamadas
En Estadísticas del Webhook ves, para las últimas 24 horas, el número de llamadas, la tasa de éxito, el tiempo medio de respuesta y los errores. Últimas llamadas webhook muestra cada llamada por separado. Las estadísticas empiezan a llenarse con la primera llamada real. Si hay muchos errores, consulta Problemas con webhooks.
¿Te ha sido útil esta página?