Skip to main content
Подія завершення надсилається після завершення кожного дзвінка — вхідного телефонного, вихідного телефонного, вебдзвінка або тестового дзвінка (сеанс мікрофона в конструкторі). Вона неблокувальна: дайте відповідь будь-яким кодом 2xx. Подія доставляється обома шляхами:

Корисне навантаження запиту (доставки до кінцевих точок)

Причини завершення

Формат транскрипту

Кожен запис у 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 для дозавантаження або повторного відтворення.