call_initiatedSe inicia una llamada.
Todas las funciones
Webhooks
Eventos del servicio. Acciones en tu aplicación.
Conecta eventos de llamadas, SMS, contactos y buzón de voz con tu aplicación mediante datos documentados, solicitudes firmadas e historial de entrega.
Del evento a tu proceso de trabajo
Evento de IllyVoIP
call_completedTu aplicaciónVerificar · Evitar duplicados · Procesar
Los eventos que
ponen en marcha tu trabajo.
Elige una categoría para consultar los eventos documentados actualmente. Es una referencia, no un flujo de eventos en directo.
call_ringingLa llamada pasa a la fase de timbre.
call_answeredSe contesta una llamada.
call_completedTermina una llamada; se incluye la duración final.
sms_sentSe envía un mensaje.
sms_deliveredSe notifica un resultado de entrega como entregado.
sms_failedSe notifica un fallo de entrega.
contact_addedSe añade un contacto.
voicemail_receivedSe recibe un mensaje de voz nuevo.
Cómo funciona
Ocurre un evento.
Tu aplicación responde.
IllyVoIP envía solicitudes POST con JSON al endpoint que configures.
Elige tus suscripciones
Crea un endpoint en los ajustes de Webhooks de la cuenta. Suscríbelo a los eventos de llamadas, SMS, contactos o buzón que necesite tu aplicación.
Verifica antes de procesar
Comprueba la cabecera Illyvoip-Signature con el secreto del webhook, la marca de tiempo y el cuerpo original de la solicitud, tal como indica la documentación.
Confirma y encola
Devuelve pronto una respuesta 2xx satisfactoria. Encola el trabajo más largo para que no retrase la confirmación de entrega.
Gestiona las entregas repetidas
Guarda el identificador del evento incluido en el cuerpo e ignora los ya procesados. Un reintento puede entregar el mismo evento otra vez.
Diseña para las condiciones
reales de entrega.
El portal incluye historial de entregas; la documentación de la API explica los datos, las firmas y los reintentos.
- Investiga los fallos
- Revisa el estado de entrega, la respuesta HTTP y los errores para distinguir un problema del receptor de uno de tu lógica de negocio.
- Separa los entornos de SMS
- Un endpoint puede recibir eventos de todos los identificadores de remitente o solo de los seleccionados. Cada endpoint coincidente recibe el evento; los filtros no reproducen eventos antiguos.
- Mantén los secretos en tu servidor
- La gestión de webhooks abarca endpoints, secretos y registros de entrega de toda la cuenta. Concede ese permiso de forma deliberada. Leer la especificación actual de webhooks
Algunos detalles
útiles.
Consulta a nuestro equipo¿Hay un webhook para cada acción del portal?+
No. Consulta el catálogo de eventos de la API. Suscríbete solo a los eventos disponibles para el proceso que quieras implementar.
¿Puede llegar el mismo evento más de una vez?+
Sí. Los reintentos conservan el mismo identificador de evento. Evita duplicados utilizando el campo id del cuerpo, no el identificador del trabajo de entrega.
¿Qué fallos se reintentan?+
La documentación actual considera reintentables los fallos de red y las respuestas HTTP 408, 429 y 5xx. Las redirecciones y los demás errores 4xx detienen la entrega. Consulta la especificación vigente antes de implementar el receptor.
Deja que los eventos impulsen tu trabajo.
Empieza por la documentación actual de eventos y configura después tu endpoint receptor.