Webhook entrantes

Los webhook permiten a yourang.ai notificar a tu sistema externo en cuanto sucede algo, sin necesidad de polling. El modelo es sencillo: tú registras una URL, yourang.ai le envía una petición HTTP POST en cada evento de interés.

Por qué webhook en lugar de polling

Sin webhook, tu sistema tendría que llamar a la API repetidamente para preguntar '¿ha sucedido algo nuevo?'. Es ineficiente, costoso e introduce retrasos. Con los webhook recibes la notificación en pocos milisegundos desde el evento, con el payload ya preparado.

Eventos disponibles

• Llamada finalizada (con transcripción, resumen, resultado)
• Nueva reserva
• Modificación de reserva
• Cancelación de reserva
• Nuevo pedido
• Actualización de estado de pedido
• Nuevo contacto creado
• Actualización de campos de contacto
• Resultado de criterio de evaluación
• Workflow completado

Configurar un webhook

1. 1

   Implementa el endpoint en tu sistema

   Una URL pública HTTPS que reciba POST. Debe responder 200 OK cuando el evento haya sido aceptado.

2. 2

   Registra la URL en yourang.ai

   Ve a Administración → API → Webhook, introduce la URL y selecciona los eventos de interés.

3. 3

   Verifica la firma

   Cada payload se firma con un secreto compartido. Tu endpoint debe validar la firma para garantizar que el mensaje proviene realmente de yourang.ai.

4. 4

   Prueba con eventos reales

   El panel muestra el log de las últimas entregas con su resultado (200 OK, errores). Usa este log para depurar.

Reintentos y fiabilidad

Si tu endpoint responde con error o no responde a tiempo, yourang.ai reintenta automáticamente siguiendo una estrategia con backoff exponencial (p. ej. 30 segundos, 5 minutos, 1 hora, ...). Tras varios intentos fallidos, el evento termina en una dead letter queue para intervención manual. En el endpoint, conviene responder 200 OK enseguida y procesar de forma asíncrona para evitar timeouts.