Webhooks de Llamadas Entrantes

Webhooks de Llamadas Entrantes

Los webhooks de llamadas entrantes permiten que tu aplicación reciba notificaciones en tiempo real cada vez que se recibe una llamada en tus números de cliente. Esto te permite procesar, enrutar, registrar o gestionar las llamadas de manera programática a medida que llegan.

Cómo Funciona

1. Registra una URL de webhook en tu cuenta.

2. Cada llamada entrante a tus números de cliente dispara una solicitud POST a la URL configurada.

3. Tu servidor debe responder con HTTP 200 OK dentro de 5 segundos para confirmar la recepción.

Importante: La URL del webhook debe ser HTTPS y accesible públicamente desde Internet.

Registrar una URL de Webhook

Endpoint:

Cuerpo de la solicitud (JSON):

Notas:

• La URL debe ser HTTPS y accesible públicamente.

• Debe responder con HTTP 200 OK en menos de 5 segundos.

Ejemplo de respuesta exitosa (200 OK):

Consultar Webhook Registrado

Endpoint:

Ejemplo de respuesta (200 OK):

Ejemplo de Payload del Webhook

Cuando se recibe una llamada entrante, tu endpoint de webhook recibirá una solicitud POST con un payload JSON como este:

Campos del Payload:

• caller_id_name: Nombre del llamante (si está disponible).

• caller_id_number: Número de teléfono del llamante.

• destination_number: Número de cliente que recibe la llamada.

Respuestas Comunes de Error

• 401 Unauthorized

• 403 Forbidden

• 404 Not Found

• 500 Internal Server Error

Buenas Prácticas

• Usa siempre HTTPS para tus URLs de webhook.

• Responde con HTTP 200 OK dentro de 5 segundos para confirmar la recepción del evento.

• Mantén tu token Bearer seguro y no lo compartas públicamente.

• Asegúrate de que tu endpoint pueda manejar múltiples llamadas concurrentes.