Голосовые вебхуки
События звонка и запросы к инструментам, которые голосовой сервис отправляет во время телефонного разговора с агентом, как они проверяются и какие у них ограничения.
Когда агент принимает телефонные звонки, голосовой сервис (Speko) во время каждого звонка общается с Veyra через два вебхука:
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/events
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/tools- events сообщают о ходе звонка: начат, принят, завершён.
- tools передают запросы голосовой сессии к инструментам агента во время звонка.
Проверка
Каждый обратный вызов проверяется по исходным байтам с помощью подписи сервиса и разрешения конкретной сессии. Эту проверку ничто не обходит — даже вошедший в систему человек.
Ответы и ограничения
| Код | Значение |
|---|---|
200 |
Обработано; JSON в теле — ответ для сервиса. |
400 |
Некорректный обратный вызов. |
401 |
Неверная подпись. |
403 |
Голосовые подключения выключены. |
413 |
Слишком большое тело обратного вызова. |
429 |
Более 600 обратных вызовов в минуту с одного адреса. |
Ответы никогда не кешируются (Cache-Control: no-store).
Звонки и задачи
Звонок привязывается к задаче, поэтому расшифровка и итог остаются вместе с работой. Звонящие, не являющиеся подтверждёнными участниками, попадают только в настроенный вами ограниченный гостевой приём; для приватной работы нужен аутентифицированный абонент.
Голосовые настройки управляются из консоли. Методы, которые за ними стоят, работают только в сессии консоли с выполненным входом, поэтому они не входят в справочник API по ключам.