Голосовые вебхуки

События звонка и запросы к инструментам, которые голосовой сервис отправляет во время телефонного разговора с агентом, как они проверяются и какие у них ограничения.

Veyra Docs TeamОбновлено 1 мин чтенияВерсия 2 · История

Когда агент принимает телефонные звонки, голосовой сервис (Speko) во время каждого звонка общается с Veyra через два вебхука:

HTTP
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 по ключам.

ВебхукиВходящиеГолос