Вступ
Документація зі створення голосових агентів для продакшну, що працюють із реальними телефонними дзвінками та вбудовуваними вебвіджетами: короткі старти, посібники й повний довідник API ThunderPhone.
ThunderPhone дає змогу створювати голосових AI-агентів, які здійснюють і приймають реальні телефонні дзвінки та забезпечують розмови через мікрофон на вашому вебсайті. Документацію поділено на чотири вкладки:
Швидкі старти, концепції та практичні інструкції для панелі керування й API. Почніть тут, якщо ви новачок.
Кожна кінцева точка, поле запиту та структура відповіді.
Вбудовуваний вебвіджет — компонент React, headless-хук і тег скрипту CDN.
Події в реальному часі, підписування та семантика доставки.
Що можна створити
Відповідайте на дзвінки за номером, який вам належить, за допомогою AI-агента, що дотримується вашого промпту, використовує ваші інструменти та за потреби передає розмову людям.
Здійснюйте програмні дзвінки зі свого коду — для опитувань, повторних контактів або сценаріїв підтвердження.
Додайте наш вбудовуваний вебвіджет на свій сайт, щоб клієнти могли натиснути й почати розмову. Номер телефону не потрібен.
Запускайте заздалегідь підготовлені сценарії через свого агента пакетами, щоб виявляти регресії до того, як їх почують клієнти.
Два способи почати
У панелі керування (рекомендовано для вашого першого агента) — зареєструйтеся, і панель керування проведе вас через майстер налаштування з п’яти кроків: створіть агента, налаштуйте оплату, додайте номер телефону, запустіть симуляцію та перегляньте дзвінок. Швидкий старт панелі керування повторює цей майстер крок за кроком.
У терміналі — швидкий старт API проводить через той самий перший дзвінок за чотири REST-виклики.
- Ознайомтеся з концепціями
Концепції — карта кожного об’єкта, з яким ви працюватимете, і місце кожного з них у панелі керування.
- Запустіть швидкий старт
Швидкий старт панелі керування або швидкий старт API — здійсніть свій перший дзвінок за допомогою AI-агента.
- Виберіть посібник
Дотримуйтесь практичного посібника для свого сценарію або перейдіть до довідника API.
Перегляд посібників
Створіть агента, поповніть баланс, отримайте номер, змоделюйте та перегляньте дзвінки.
Застосунки OAuth, власні API, сервери MCP і постачальники VoIP.
Звіти, спостережуваність, експерименти, проблеми та сповіщення.
Запрошення та ролі, ключі API, безпека й SSO.
Базова URL-адреса
https://api.thunderphone.com/v1
Для автентифікації використовується стандартна схема OAuth 2.0 Bearer із
ключем API організації sk_live_. Ваш ключ автоматично визначає цільову
організацію — у шляхах URL немає ідентифікатора організації. Докладніше див.
в розділі Автентифікація.