Основне
Взаємодія
Моніторинг у реальному часі та вихідні
кампанії.
Інтеграції
Застосунки, API, MCP-сервери та VoIP-провайдери, які можуть
використовувати ваші агенти.
Якість і тестування
Організація
Події
Вебхуки та інструменти функцій для
вашого власного коду.
Організації
Організація — це одиниця ізоляції даних. Кожен інший ресурс — агенти, номери телефонів, дзвінки, ключі — належить рівно одній організації. Ваш обліковий запис може належати багатьом організаціям; кожна має власний баланс, власні ключі та власний список учасників. API-ключsk_live_, який ви створюєте в розділі Організація → Ключі,
прив’язаний до однієї організації. Саме ця прив’язка робить REST API таким
плоским: вам ніколи не потрібно вказувати ідентифікатор організації в URL-шляхах, адже ваш ключ
уже її ідентифікує.
У панелі керування: перемикач організацій (у нижній частині бічної панелі) та
налаштування Організація — вкладки «Загальні», «Ключі», «Сповіщення», «Налаштування оплати»
та «Історія оплат».
В API: /v1/orgs,
/v1/developer/api-keys.
Агенти
Агент — це AI-конфігурація, яка обробляє дзвінок. Вона містить:- Промпт, який визначає, що говорить агент і як він поводиться — зокрема дії під час дзвінка, як-от переадресації, натискання клавіш і завершення дзвінка, які є звичайними рядками промпту, а не окремою конфігурацією.
- Рівень рушія (
spark,bolt,storm-*): Spark оптимізовано для вартості, Bolt — для швидкості, Storm — для інтелектуальної роботи зі складними промптами. - Голос, а також основну мову й необов’язкові додаткові мови — агент автоматично перемикається, коли абонент змінює мову. Див. Підтримувані мови.
- Підключені можливості: підключені застосунки, API-підключення, бази знань, MCP-сервери та вбудовані інструменти функцій.
- Налаштування поведінки: порядок мовлення, режим підтвердження, фоновий трек, тайм-аут утримання.
/dashboard/agents). Див.
Створіть свого першого голосового агента.
В API: /v1/agents — CRUD,
дублювання, переадресація, історія версій і допоміжні засоби для промптів.
Номери телефонів
Номер телефону належить організації та маршрутизує вхідні дзвінки до агента (а також може використовуватися для вихідних дзвінків). Є два джерела:- Демо-номери — реальні номери США, надані з пулу ThunderPhone, активуються за лічені секунди. Лише для вхідних дзвінків: вони відповідають коротким усним застереженням, а дашборд обмежує організацію до 10 таких номерів. Ідеально для першого тесту; не для продакшну.
- VoIP-номери — додаються від вашого власного провайдера через VoIP-підключення. Twilio і Telnyx підключаються безпосередньо (для Telnyx доступне покрокове налаштування); SignalWire і Vonage з’являться незабаром — наразі їх можна підключити через ручне налаштування SIP, яке підтримує будь-який SIP-транк. Після імпорту та перевірки VoIP-номери підтримують вхідні й вихідні дзвінки.
/dashboard/phone-numbers).
Дивіться Отримання номера телефону.
В API: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
Дзвінки
Кожен вхідний дзвінок, вихідний дзвінок, симуляція та сеанс віджета стає журналом дзвінка. Дзвінок містить повний транскрипт із позначеними ролями, структуровану історію ходів (зокрема виклики інструментів), запис, загальну суму нарахувань, а також необов’язкові оцінювання ШІ та звіти про проблеми. Поки дзвінок активний, ви можете відкрити його та прослуховувати — ви приєднаєтеся непомітно, і ніхто під час дзвінка вас не чутиме. Після початку прослуховування ви можете підказувати пошепки: введіть інструкцію, яка безпосередньо надійде вашому агенту під час дзвінка; абонент її ніколи не почує, а агент виконає її в реальному часі. У дашборді: Історія дзвінків (/dashboard/call-history) для
архіву та відомостей про кожен дзвінок; Наживо для дзвінків, що тривають. Дивіться
Перегляд, прослуховування та наставництво для ваших дзвінків.
В API: /v1/calls — список, транскрипт,
історія, аудіо, оцінювання, експорт;
/v1/issue-reports.
Вебвіджети
Вебвіджет надає відвідувачам вашого сайту можливість розмовляти з агентом через мікрофон — номер телефону не потрібен. Він автентифікується за допомогою публічного ключа (pk_live_...), прив’язаного до дозволених доменів
походження, тому його безпечно використовувати в клієнтському коді.
Ключі працюють в одному з двох режимів: agent (статично прив’язаний до одного агента)
або webhook (ваш сервер вибирає конфігурацію для кожного відвідувача — дивіться
Динамічна конфігурація для кожного дзвінка). Сеанси
віджета використовують ту саму інфраструктуру дзвінків, що й телефонні дзвінки.
У дашборді: Вебвіджети (/dashboard/web-widgets) —
створюйте віджети, налаштовуйте режим і агента, керуйте дозволеними доменами та
копіюйте код для вбудовування. Дивіться
Створення вебвіджета.
В API: /v1/publishable-key,
/v1/mic-session і
документація Widget SDK.
Бази знань
База знань — це набір документів, у яких ваш агент може шукати інформацію під час дзвінка, щоб підкріплювати свої відповіді — завантажуйте файли безпосередньо або імпортуйте їх із Google Drive, а потім прикріпіть базу знань до агента в конструкторі. Агент звертається до неї за допомогою вбудованого інструмента пошуку, коли цього потребує розмова. У дашборді: Знання (/dashboard/knowledge) для
бібліотеки документів; розділ Знання у конструкторі, щоб прикріпити базу до
агента. Дивіться
Надання агенту бази знань.
Підключення
Підключення дають агентам змогу взаємодіяти із зовнішнім світом. Чотири типи в одній групі бічної панелі:- Застосунки (
/dashboard/app-connections) — OAuth-підключення до Slack, HubSpot, Salesforce, Google Calendar, Google Sheets і Cal.com. Підключіть один раз, а потім увімкніть для кожного агента інструменти окремих операцій (надіслати повідомлення в Slack, оновити або створити контакт HubSpot, забронювати слот Cal.com…). Див. Підключення застосунків. - API (
/dashboard/api-connections) — перетворіть будь-який HTTP API на дію агента. Вставте команду cURL, і майстер ШІ створить чернетку визначення інструмента, або створіть його вручну; кнопка Тестовий запит виконує виклик у пісочниці, перш ніж ви випустите зміни в продакшн. Див. Підключення API — інтерфейс панелі керування для/v1/integrations. - MCP (
/dashboard/mcp-connections) — додайте сервер Model Context Protocol за URL і дозвольте агенту використовувати доступні на ньому інструменти. Див. Додати сервер MCP. - VoIP (
/dashboard/voip-connections) — облікові дані провайдера для використання власних телефонних номерів. Див. Підключення VoIP-провайдера.
/v1/integrations і
/v1/voip-connections; також див.
Створення інтеграції інструмента.
Кампанії
Кампанія здійснює вихідні дзвінки у великому масштабі: завантажте CSV-файл контактів, виберіть агента й номер для вихідних дзвінків, а також задайте вікно дзвінків (дні та години з урахуванням часового поясу), паралельність і політику повторних спроб (максимальну кількість спроб і результати — немає відповіді, голосова пошта, помилка — для яких виконуватимуться повторні спроби). Кампанія послідовно опрацьовує список і записує кожен дзвінок в Історію викликів. На панелі керування: Кампанії (/dashboard/campaigns). Див.
Запуск кампанії вихідних дзвінків.
Для одноразових програмних дзвінків: використовуйте
API вихідних дзвінків.
Моніторинг у реальному часі
Наживо показує кожен дзвінок, що триває в організації, і дає змогу відкрити будь-який із них, щоб прослуховувати та підказувати у реальному часі. Це поверхня нагляду: спостерігайте, як новий промпт отримує свій перший реальний трафік, або контролюйте активну кампанію. На панелі керування: Наживо (/dashboard/live). Див.
Перегляд і нагляд за дзвінками в реальному часі.
Симуляції
Симуляція — це ШІ, який телефонує та веде реальну розмову з вашим агентом — той самий шлях телефонії, реальна транскрипція, реальне оцінювання — тож ви можете тестувати до (і після) випуску в продакшн. Вкажіть агента або телефонний номер, самостійно опишіть сценарій абонента або згенеруйте сценарії за допомогою ШІ з промпту агента (включно з крайніми випадками, якщо попросите), і спостерігайте за дзвінком наживо. Сценарії об’єднуються в набори, які фіксують мінімальний відсоток успішного проходження та можуть блокувати релізи в CI; для кожного сценарію повідомляється про регресії порівняно із затвердженою базовою версією. На панелі керування: Симуляції (/dashboard/simulations), а також
кнопка Симуляція в конструкторі агента. Див.
Симуляція дзвінка.
В API: /v1/test-calls і
запускач наборів — див. Наскрізне тестування агента.
Експерименти
Експеримент виконує A/B-тестування конфігурацій агента на реальному трафіку: визначте варіанти (різні промпти, рушії або налаштування), розподіліть між ними трафік і порівняйте результати для кожного варіанта. Використовуйте його замість власноручної реалізації логіки розподілу у webhook. На панелі керування: Експерименти (/dashboard/experiments) і
вкладка A/B у конструкторі агента. Див.
Експерименти (A/B-тестування).
Проблеми
Проблема — це позначена проблема в конкретному дзвінку, яку зафіксував рецензент або виявило оцінювання ШІ. Проблеми мають рівень серйозності, джерело та статус, а сторінка «Проблеми» — це черга для сортування: фільтруйте, переглядайте проблемний дзвінок і відстежуйте виправлення. У панелі керування: Проблеми (/dashboard/issues), а також
позначення для кожного дзвінка в Історії дзвінків. Див. Сортування проблем.
В API: /v1/issue-reports.
Звіти
Звіт відповідає на запитання природною мовою щодо ваших даних про дзвінки («Якими були три найпоширеніші причини, через які абоненти просили з’єднати їх із людиною минулого тижня?») за допомогою аналізу, створеного ШІ та обмеженого вибраними вами агентами й діапазоном дат. У панелі керування: Звіти (/dashboard/reports). Див.
Звіти.
Спостережуваність
Спостережуваність — це розділ метрик: обсяг дзвінків, результати та якість у часі, з можливістю фільтрування за агентом і часовим вікном та експорту для подальшого аналізу. У панелі керування: Спостережуваність (/dashboard/observability).
Див. Спостережуваність.
Сповіщення
Правило сповіщення відстежує метрику (рівень успішності, рівень збоїв, середню оцінку, обсяг дзвінків, регресії набору) у межах часового вікна та спрацьовує, коли вона перетинає заданий вами поріг. Сповіщення надходять на електронну пошту та в Slack, а також викликають подіюalert.triggered для ваших
кінцевих точок вебхуків.
У панелі керування: Організація → Сповіщення. Див.
Сповіщення.
Вебхуки
ThunderPhone надсилає HTTP POST вебхуки на ваш сервер, коли під час і після дзвінка відбуваються певні події. Є дві моделі доставки:- Кінцеві точки вебхуків (рекомендовано): керуйте багатьма URL за
допомогою
/v1/developer/webhook-endpoints, використовуючи окремі секрети та підписки на події для кожної кінцевої точки. - Застарілий вебхук з одним URL: один URL на організацію. Керується через
/v1/webhookабо в розділі Організація → Загальні. Залишено для зворотної сумісності.
- Блокувальні події очікують, що ваш сервер відповість конфігурацією,
яка впливає на дзвінок у процесі виконання — це
події вхідного дзвінка
(
telephony.incoming/web.incoming). У вас є до 10 секунд на відповідь; у разі тайм-ауту дзвінок обробляє статично призначений агент. - Неблокувальні події — це сповіщення типу «надіслати й не чекати», які повторюються з експоненційною затримкою — див. семантику доставки.
X-ThunderPhone-Signature. Див.
Перевірка підпису.
Функціональні інструменти
Функціональний інструмент — це HTTP-кінцева точка, яку ваш агент може викликати посеред розмови. Ви надаєте ThunderPhone схему функції у стилі OpenAI та URL кінцевої точки; агент вирішує, коли її викликати, а ThunderPhone виконує підписаний HTTP-запит зі своїх серверів і передає результат агенту. Агенти також мають вбудовані можливості для дзвінків — переадресацію дзвінка, надсилання вводу з клавіатури (DTMF), завершення дзвінка, очікування на утриманні — які ви вмикаєте звичайними рядками промпту, а не визначеннями інструментів. У панелі керування: розділ конструктора API-підключення (див. Підключення). В API:/v1/integrations і
специфікацію Function Tools.
Команда та ролі
Кожна організація має список учасників із двома ролями: Учасники створюють і експлуатують агентів; Адміністратори також керують командою та оплатою. Запрошуйте електронною поштою — запрошення закінчуються через 7 днів і можуть бути відкликані; меню ⋯ у рядку учасника змінює ролі або видаляє користувача. Єдиний вхід можна налаштувати для всієї організації — див. SSO. У панелі керування: Організація → Загальні. Див. Запросіть свою команду. В API:/v1/members,
/v1/invites.
Виставлення рахунків
ThunderPhone працює за передоплатою. Кожна організація має баланс у USD; вартість дзвінків списується з нього за похвилинним тарифом агента (рівень рушія плюс доплати — конструктор показує підсумковий тариф у реальному часі, коли ви змінюєте налаштування, а преміум-мови додають 2 ¢/хв). Коли баланс стає нульовим, вхідні дзвінки відхиляються, а вихідні дзвінки повертають402 Payment Required.
Поповнюйте баланс вручну або ввімкніть автопоповнення, указавши поріг балансу,
суму поповнення та необов’язковий місячний ліміт витрат — щоб дзвінок
ніколи не обривався посеред речення.
У дашборді: Організація → Налаштування платежів і
Історія платежів. Дивіться
Як поповнити баланс і ввімкнути автопоповнення.
В API: /v1/billing.
Вбудований копілот
Дашборд містить вбудований копілот — запитайте його «як зробити X», і він відповість на основі цієї документації, запропонує покрокові інструкції з підсвічуванням реальних елементів керування та зможе повторно запустити будь-який з оглядових турів. Це найшвидший спосіб знайти елемент керування, згаданий на цій сторінці. Дивіться Як запитати вбудованого копілота.Усе разом
Швидкий старт у дашборді
П’ятиетапний майстер: агент → білінг → номер → симуляція → перевірка.
Швидкий старт API
Той самий перший дзвінок за чотири REST-виклики.
Використання дашборда
Створіть агента, поповніть баланс, отримайте номер, симулюйте та переглядайте дзвінки.
Підключення інструментів і даних
OAuth-застосунки, користувацькі API, MCP-сервери та VoIP-провайдери.
Аналіз і покращення
Звіти, спостережуваність, експерименти, проблеми та сповіщення.
Команда й обліковий запис
Запрошення та ролі, ключі API, безпека й SSO.
Збірник рецептів для розробників
Рецепти API: вхідні, вихідні, динамічна конфігурація, інструменти, тестування.
Перевірка підписів вебхуків
Один раз правильно налаштуйте перевірку HMAC і використовуйте її всюди.