mode="webhook", ThunderPhone надсилає блокувальний
запит telephony.incoming / web.incoming на вашу
застарілу URL-адресу вебхука
і очікує до 10 секунд на відповідь із конфігурацією. Використовуйте цей
обмін, щоб динамічно вибирати промпт, голос і інструменти для кожного виклику —
повний шаблон дивіться в посібнику з динамічної конфігурації викликів.
Підписані кінцеві точки вебхуків також отримують
telephony.incoming / web.incoming — для кожного вхідного виклику
та вебсеансу, незалежно від того, чи налаштовано агента, — але ці доставки є
неблокувальними сповіщеннями типу fire-and-forget з event_id.
Лише застарілий вебхук з однією URL-адресою передає обмін конфігурацією,
описаний на цій сторінці. Структури сповіщень кінцевих точок наведено в
каталозі подій.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-тестів для кожного абонента.