- Кінцеві точки вебхуків отримують
telephony.complete(телефонні дзвінки) абоweb.complete(вебдзвінки та тестові дзвінки з мікрофона в конструкторі) зі стабільним корисним навантаженням, описаним нижче,event_idдля кожної доставки, тайм-аутом 30 с і повторними спробами протягом до 24 год. - Застарілий вебхук з однією URL-адресою отримує одну синхронну спробу (тайм-аут 10 с, без повторних спроб) із дещо іншим корисним навантаженням — див. Відмінності застарілого корисного навантаження.
Корисне навантаження запиту (доставки до кінцевих точок)
Причини завершення
Формат транскрипту
Кожен запис уtranscripts — це один хід розмови. Ролі:
user (мовлення абонента), model (мовлення агента та виклики інструментів),
tool (результати інструментів) і system (події виклику, як-от зміни
мови).
Щоб отримати повністю структуровану історію ходів (із позначками
переривань, запитами підтвердження та необробленими позиціями), використовуйте
GET /v1/calls/{call_id}/history.
Відмінності застарілого payload
Застарілий конверт вебхука з однією URL-адресою має формат{"type": "telephony.complete" | "web.complete", "data": {…}} без
event_id, а його data відрізняється від payload кінцевої точки:
- Масив ходів міститься у
history, а не вtranscripts(та сама схема ходів, що й вище). - Набір полів — це необроблений звіт про завершення виклику й може містити додаткові внутрішні поля, яких немає в таблиці вище — вважайте невідомі поля інформаційними.
- Вебвиклики (
direction: "web") не містятьfrom_number/to_numberі додаютьorigin_domain. - Тестові виклики мікрофона в Builder надсилаються як
telephony.completeза застарілим шляхом (система кінцевої точки зіставляє їх ізweb.complete). - Координація переадресації: коли виклик завершується переадресацією,
застарілий вебхук викликається синхронно й може відповісти
{"transfer_ready": false}, щоб повідомити, що ціль переадресації ще не готова. Будь-яка інша відповідь (або відсутність застарілого вебхука) дає змогу продовжити переадресацію. Доставки до кінцевої точки для цього ніколи не використовуються.
Приклад обробника
Поширені сценарії використання
Інтеграція з CRM
Зберігайте транскрипт кожного дзвінка та URL запису разом із даними
клієнтів.
Аналітика
Передавайте транскрипти в конвеєр для тематичного моделювання, вилучення
сигналів CSAT або моніторингу частоти переадресацій.
Перевірка якості
Відкривайте дзвінки в інструменті QA для перевірки людиною або запускайте їх
через власну модель оцінювання.
Сповіщення
Сповіщайте члена команди-людину в разі переадресації або збою.
Пов’язані матеріали
telephony.incoming / web.incoming
Блокувальний відповідник, що запускається на початку дзвінка.
Каталог подій
Інші типи подій, на які можна підписатися.
API історії дзвінків
Ті самі дані доступні через REST для дозавантаження або повторного відтворення.