Skip to main content
Коли вхідний телефонний виклик надходить на номер без призначеного агента, або сеанс вебвіджета запускається на публічному ключі в mode="webhook", ThunderPhone надсилає блокувальний запит telephony.incoming / web.incoming на вашу застарілу URL-адресу вебхука і очікує до 10 секунд на відповідь із конфігурацією. Використовуйте цей обмін, щоб динамічно вибирати промпт, голос і інструменти для кожного виклику — повний шаблон дивіться в посібнику з динамічної конфігурації викликів.
Підписані кінцеві точки вебхуків також отримують telephony.incoming / web.incoming — для кожного вхідного виклику та вебсеансу, незалежно від того, чи налаштовано агента, — але ці доставки є неблокувальними сповіщеннями типу fire-and-forget з event_id. Лише застарілий вебхук з однією URL-адресою передає обмін конфігурацією, описаний на цій сторінці. Структури сповіщень кінцевих точок наведено в каталозі подій.
Блокувальний обмін не має резервного варіанта: якщо ваш обробник повертає статус не 2xx, перевищує час очікування або повертає конфігурацію, що не проходить валідацію, виклик відхиляється (телефонний виклик не з’єднується; запит сеансу віджета завершується помилкою 502/422). Відповідайте швидко — поки ви приймаєте рішення, абонент чує сигнал зворотного виклику.

Тіло запиту

Для телефонних викликів (telephony.incoming):
Для сеансів вебвіджета (web.incoming) data визначає сторінку, на яку вбудовано віджет, замість телефонних номерів:
Віджети в режимі вебхука надсилають цей запит на власний webhook_url публічного ключа, якщо його налаштовано, інакше використовують URL-адресу вебхука рівня організації. В обох випадках запит підписується secret вебхука організації.

Схема відповіді

Поверніть об’єкт JSON, що описує конфігурацію агента для цього виклику. prompt і voice обов’язкові; усе інше необов’язкове.
Невідомі ключі верхнього рівня тихо ігноруються — поле з помилкою в назві не відхиляє конфігурацію, але просто не застосовується. Порядок реплік і max_hold_seconds тут не приймаються; їх можна налаштувати лише для самого агента.
Оскільки prompt і voice обов’язкові, повернення {} або будь-якої відповіді, що не проходить перевірку, відхиляє виклик із кодом 422 — для цього шляху немає резервного статичного агента (номер або ключ у режимі вебхука не має призначеного агента).

Приклад обробника


Відповідь із функціональними інструментами

Додайте інструменти, щоб ШІ міг викликати ваші API під час розмови:
Запити до кінцевих точок інструментів підписуються тим самим секретом вебхука організації, яким підписано цей обмін. Точну структуру та формат підписаного запиту дивіться в розділі Функціональні інструменти.

Шпаргалка щодо рівнів продукту


Пов’язані матеріали

telephony.complete / web.complete

Неблокувальна подія завершення дзвінка.

Інструменти функцій

Повна JSON-схема для tools[] і контракт підписаного кінцевого вузла.

Кінцеві вузли вебхуків

Підпишіть кілька URL на telephony.incoming / web.incoming.

Динамічна конфігурація дзвінків

Шаблони для промптів, інструментів і A/B-тестів для кожного абонента.