Перейти к основному содержанию

Вебхуки

Вебхуки отправляют результаты звонков в ваши системы — CRM, службу поддержки, собственные отчёты — без запроса с вашей стороны. На этой странице — что приходит и как это читать.
  • Где завести — на агенте, в разделе «Вебхуки» его настроек: см. «Вебхуки». Вебхук принадлежит одному агенту; для нескольких агентов заведите адрес у каждого.
  • Как устроена доставка — подпись, повторы, дубли и порядок: см. Вебхуки в Web API.

Два события

  • call_ended — сразу после окончания звонка: исход, транскрипт, переменные. Оно приходит рано, поэтому разбора после звонка в нём ещё нет, а запись обычно ещё обрабатывается.
  • call_analyzed — когда готовы разбор после звонка и запись. В нём тоже весь звонок целиком, так что если вам нужна только итоговая картина, подпишитесь на одно это событие.

Пример: звонок завершён

Ниже пример webhook-сообщения call_ended, которое HubTalk AI v4 может отправить на ваш endpoint:

Пример: аналитика готова

Тот же блок звонка, что в call_ended, плюс результаты анализа:

Поля событий

Время везде — секунды Unix-эпохи (дробные). Пустое значение строки — "", отсутствие числа — null.

Общие поля

Блок call — в обоих событиях

Запись разговора — recording

В call_ended блок лежит внутри call, в call_analyzed — на верхнем уровне. Поля нет, если запись у звонка не велась.

Только в call_analyzed

Оба события несут поле error_code — числовой код отказа, присвоенный оператором связи (например 486 при status_reason = busy). Он равен null, если оператор кода не отдал. Трактовки кодов у операторов различаются — не строите на них жёсткую логику без сверки со своим оператором. Учтите также, что busy и user_declined — разные причины: занято и отбой абонента различаются. Если анализ был пропущен или завершился ошибкой, call_analysis пуст, а в payload добавляется поле reason, объясняющее причину, например voicemail или no_speech. Если у звонка есть запись, call_analyzed также содержит поле верхнего уровня recording_url и объект recording — уже с готовой ссылкой на запись. call_ended несёт тот же блок записи, но на этот момент она обычно ещё обрабатывается.

На недозвоне переменные тоже приходят

Звонок, который не состоялся — недозвон, занято, сбой, автоответчик, — всё равно даёт вебхук, и в этом вебхуке есть dynamic_variables: значения, которые вы передали для контакта при постановке звонка в очередь. В разговоре ничего не собрано, потому что разговора не было, но входные данные звонка на месте.
Не используйте пустой dynamic_variables как признак недозвона. Переменные приходят и на состоявшемся звонке, и на недозвоне, поэтому пустой словарь об исходе ничего не говорит. Ветвитесь по call_status и status_reason — именно эти поля говорят об исходе.
Три поверхности показывают одно и то же: переменная звонка внутри пост-колл функций, словарь в вебхуке завершения и GET /v1/calls/{call_id} в Web API — по одному звонку данные совпадают.