Skip to main content
Los webhooks avisan a tus sistemas cada vez que ocurre un evento de llamada. Jelou envía una petición POST a la URL que registres, lo que te permite llevar el resultado de cada llamada a tu CRM, tu almacén de datos o cualquier flujo interno sin tener que consultar el registro manualmente. Están en la pestaña Webhooks de Voice.
Sección Registrar un webhook con el campo de URL y el botón Registrar, y debajo la tabla de webhooks con su URL, tipo y fecha de creación

Pestaña Webhooks con el registro de una URL

​
Registrar un webhook

Pegas la URL de tu endpoint en el campo y confirmas con Registrar. Jelou enviará una petición POST a esa URL por cada evento de llamada de tu organización. La tabla de abajo lista los webhooks ya registrados con tres datos:
El alcance es toda la organización, no un agente o un número concreto. Un webhook registrado aquí recibe los eventos de llamada de todos tus agentes.

​
Preparar tu endpoint

Tu endpoint debe aceptar peticiones POST con cuerpo JSON y responder rápido. Algunas consideraciones que aplican a cualquier receptor de webhooks: Responde antes de procesar. Devuelve una respuesta exitosa en cuanto recibas el evento y haz el trabajo pesado de forma asíncrona. Si tu endpoint tarda, arriesgas reintentos y duplicados. Diseña para la idempotencia. Un mismo evento puede llegar más de una vez ante un error temporal. Usa el identificador de la llamada o de la conversación para reconocer lo que ya procesaste. Usa HTTPS y no confíes solo en el secreto de la URL. El panel no expone un secreto de firma ni documenta un encabezado de verificación, así que la URL es lo único que separa tu endpoint del exterior. Protégelo por tu cuenta: usa una ruta difícil de adivinar, restringe el acceso por IP si tu arquitectura lo permite y trata todo lo que recibas como no confiable hasta validarlo contra tus propios datos.
Si necesitas verificación criptográfica del origen, confírmalo con el equipo de Jelou antes de construir sobre este webhook: no hay un mecanismo de firma documentado en esta pantalla.
Registra lo que recibes. Guardar el evento crudo junto con la respuesta que diste ahorra mucho tiempo cuando algo no cuadra.
Los eventos de llamada pueden incluir datos de la conversación y del interlocutor. Trata el endpoint y lo que almacenes con el mismo cuidado que cualquier otro dato personal de tus clientes.

​
Qué hacer con los eventos

El evento de fin de llamada es el punto natural para cerrar el ciclo con tus sistemas: registrar el resultado del contacto, actualizar el estado de un caso o disparar el siguiente paso de un proceso. Si has definido criterios de evaluación y recolección de datos en el agente, ese análisis es lo que convierte una llamada en un registro utilizable: el motivo del contacto, la clasificación del resultado, si hubo transferencia.
Antes de construir la integración completa, registra un endpoint que solo guarde el cuerpo de la petición y haz una llamada de prueba. Ver un evento real es más rápido que deducir su forma.

​
Desde el CLI

jelou voice webhooks

Lista, consulta, crea y elimina webhooks desde la terminal, indicando el tipo de evento.