Webhooks de voz
Eventos de llamada y solicitudes de herramientas que envía el proveedor de voz durante una llamada telefónica con un agente, cómo se verifican y sus límites.
Cuando un agente atiende llamadas telefónicas, el proveedor de voz (Speko) se comunica con Veyra mediante dos webhooks durante cada llamada:
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/events
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/tools- events informa del ciclo de vida de la llamada: iniciada, contestada, finalizada.
- tools transporta las solicitudes que la sesión de voz hace a las herramientas del agente durante la llamada.
Verificación
Cada retrollamada se verifica sobre sus bytes originales con la firma del proveedor y una autorización propia de la sesión. Nada se salta esta comprobación, ni siquiera una persona con sesión iniciada.
Respuestas y límites
| Estado | Significado |
|---|---|
200 |
Procesada; el cuerpo JSON es la respuesta para el proveedor. |
400 |
La retrollamada está mal formada. |
401 |
La firma no es válida. |
403 |
Las conexiones de voz están desactivadas. |
413 |
El cuerpo de la retrollamada es demasiado grande. |
429 |
Más de 600 retrollamadas por minuto desde una misma dirección. |
Las respuestas nunca se almacenan en caché (Cache-Control: no-store).
Llamadas y tareas
Una llamada se vincula a una tarea, así que su transcripción y su resultado se quedan con el trabajo. Quienes llaman sin ser miembros verificados solo llegan a la recepción restringida para invitados que configuraste; el trabajo privado requiere una persona autenticada.
La configuración de voz se gestiona desde la consola. Los endpoints que la sostienen solo funcionan en una sesión de consola iniciada, por lo que no forman parte de la referencia de la API basada en claves.