Вебхуки
Вебхуки отправляют результаты звонков в ваши системы — 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: значения, которые вы передали для контакта при постановке звонка в очередь. В разговоре ничего не собрано, потому что разговора не было, но входные данные звонка на месте.
Три поверхности показывают одно и то же: переменная звонка внутри пост-колл функций, словарь в вебхуке завершения и GET /v1/calls/{call_id} в Web API — по одному звонку данные совпадают.