Основні концепції

Карта всього на платформі — що робить кожен об’єкт, де він розташований у панелі керування та який API з ним взаємодіє.

ThunderPhone — це повна платформа для створення, запуску та вдосконалення голосових AI-агентів. Ця сторінка — ваша карта: кожна концепція, з якою ви зустрінетеся, описана в окремому короткому розділі разом з інтерфейсом панелі керування та API, що її підтримує. Перегляньте її один раз, а потім повертайтеся, коли потрібно уточнити значення терміна.

Бічна панель керування відображає цю структуру:

Основне

Агенти, голоси, номери телефонів, віджети для вебсайтів, дзвінки, клієнтські портали, бази знань.

Взаємодія

Моніторинг у реальному часі і вихідні кампанії.

Підключення

Застосунки, API, MCP-сервери та VoIP-провайдери, які можуть використовувати ваші агенти.

Якість і тестування

Симуляції, набори валідації, експерименти, проблеми, звіти, спостережуваність.

Організація

Команда й ролі, ключі API, сповіщення, оплата.

Події

Вебхуки та інструменти функцій для вашого власного коду.

Організації

Організація — це одиниця ізоляції клієнтських даних. Кожен інший ресурс — агенти, номери телефонів, дзвінки, ключі — належить рівно одній організації. Ваш обліковий запис може належати багатьом організаціям; кожна має власний баланс, власні ключі та власний список учасників.

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

Голоси

Бібліотека голосів містить голоси, які може використовувати агент, зразки, які можна прослухати, сумісні мови, групування за статтю та акцентом, а також будь-яку доплату за преміум-голос або мову. Платний інструмент попереднього прослуховування може синтезувати вашу власну фразу з 1–500 символів перед вибором.

Організації, які відповідають вимогам, також можуть створювати власні голоси на основі короткого зразка WAV або MP3. Власні голоси мають квоту та асинхронний статус створення; щойно вони будуть готові, то з’являться в тому самому засобі вибору агента, що й голоси з бібліотеки.

На панелі керування: Голоси (/dashboard/voices). Див. Бібліотека голосів і власні голоси.

В API: /v1/voices, зразки голосів і власні голоси.

Номери телефонів

Номер телефону належить організації та спрямовує вхідні дзвінки до агента (а також може використовуватися для вихідних дзвінків). Є два джерела:

Демонстраційні номери — реальні номери США, надані з пулу 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.

Клієнтські портали

Клієнтський портал — це брендований перегляд історії дзвінків лише для читання для зовнішнього клієнта. Адміністратори організації вибирають агентів, дзвінки яких відображатимуться, додають схвалені адреси електронної пошти переглядачів, завантажують логотип і акцентний колір, а також за потреби підтверджують власний домен. Переглядачі порталу можуть перевіряти відомості про дзвінки, транскрипції та доступні записи без доступу до панелі керування.

На панелі керування: Клієнтські портали (/dashboard/client-portals). Див. Клієнтські портали.

В API: /v1/client-portals для інтерфейсу адміністрування.

Вебвіджети

Вебвіджет надає відвідувачам вашого сайту можливість спілкуватися з агентом через мікрофон — номер телефону не потрібен. Він автентифікується за допомогою публічного ключа (pk_live_...), прив’язаного до джерела запиту та ваших дозволених доменів, тому його безпечно використовувати в клієнтському коді.

Ключі працюють в одному з двох режимів: agent (статично прив’язаний до одного агента) або webhook (ваш сервер вибирає конфігурацію для кожного відвідувача — див. Динамічна конфігурація для кожного дзвінка). Сеанси віджетів проходять через ту саму інфраструктуру дзвінків, що й телефонні дзвінки.

На панелі керування: Вебвіджети (/dashboard/web-widgets) — створюйте віджети, налаштовуйте режим і агента, керуйте дозволеними доменами та копіюйте фрагмент для вбудовування. Див. Створення вебвіджета.

В API: /v1/publishable-key, /v1/mic-session і документація Widget SDK.

Бази знань

База знань — це набір документів, у якому ваш агент може шукати інформацію під час дзвінка, щоб обґрунтовувати свої відповіді. Завантажуйте файли, вставляйте текст або імпортуйте вебсторінки за URL, а потім приєднуйте базу знань до агента в конструкторі. Агент виконує запити за допомогою вбудованого інструмента пошуку, коли цього потребує розмова.

На панелі керування: Знання (/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-постачальника.

ThunderPhone також надає власну кінцеву точку MCP, щоб зовнішній MCP-клієнт міг переглядати список агентів, перевіряти дзвінки й транскрипти та здійснювати дзвінки. Див. Використання ThunderPhone як MCP-сервера.

В API: /v1/integrations, /v1/mcp-servers і /v1/voip-connections; див. також Створення інтеграції інструмента.

Кампанії

Кампанія здійснює вихідні дзвінки у великому масштабі: завантажте CSV-файл контактів, виберіть агента та номер, з якого здійснюватимуться дзвінки, а також налаштуйте вікно дзвінків (дні й години з урахуванням часового поясу), паралельність і політику повторних спроб (максимальну кількість спроб і результати — немає відповіді, голосова пошта, невдача — для яких потрібно повторювати дзвінок). Кампанія обробляє список і записує кожен дзвінок в Історії дзвінків.

На панелі керування: Кампанії (/dashboard/campaigns). Див. Запуск кампанії вихідних дзвінків.

Для разових програмних дзвінків: API вихідних дзвінків.

Моніторинг наживо

Наживо показує всі поточні дзвінки в організації та дає змогу відкрити будь-який із них, щоб прослуховувати й підказувати у реальному часі. Це інтерфейс нагляду: спостерігайте, як новий промпт отримує свій перший реальний трафік, або контролюйте поточну кампанію.

У дашборді: Наживо (/dashboard/live). Див. Перегляд і нагляд за дзвінками наживо.

Симуляції

Симуляція — це ШІ-абонент, який веде реальну розмову з вашим агентом — той самий шлях телефонії, реальна транскрипція, реальне оцінювання — тож ви можете тестувати до (і після) випуску в продакшн. Спрямуйте її на агента або номер телефону, самостійно напишіть сценарій абонента або згенеруйте сценарії за допомогою ШІ на основі промпту агента (зокрема крайові випадки, якщо попросите), і спостерігайте за дзвінком наживо.

Сценарії об’єднуються в набори, які встановлюють мінімальний відсоток успішного проходження та можуть блокувати релізи в CI; регресії щодо прийнятого базового рівня відображаються для кожного сценарію.

У дашборді: Симуляції (/dashboard/simulations), а також кнопка Симуляція у конструкторі агента. Див. Симуляція дзвінка.

В API: /v1/test-calls і засіб запуску наборів — див. Наскрізне тестування агента.

Набори валідації

Набір валідації перетворює реальні моменти дзвінків на повторювані одноходові перевірки регресій. Кожен приклад фіксує контекст розмови, відповідне аудіо абонента, оригінальну відповідь і очікувану поведінку. Повторні відтворення запускаються для поточної чернетки агента без здійснення нового дзвінка, а діалог розгортання може показувати, чи останній запуск досі відповідає цій чернетці.

У дашборді: Набори валідації (/dashboard/validation) для набору даних організації та вкладка Валідація у конструкторі агента для запусків. Див. Набори валідації.

В API: /v1/validation-sets і кінцеві точки повторного відтворення агента/прикладу на цій самій довідковій сторінці.

Експерименти

Експеримент виконує A/B-тестування конфігурацій агента на реальному трафіку: визначте варіанти (різні промпти, рушії або налаштування), розподіліть між ними трафік і порівняйте результати для кожного варіанта. Використовуйте це замість ручної реалізації логіки розподілу в webhook.

У дашборді: Експерименти (/dashboard/experiments) і вкладка A/B у конструкторі агента. Див. Експерименти (A/B-тестування).

Проблеми

Проблема — це позначена проблема в конкретному дзвінку — її додає людина-рецензент або її виявляє ШІ-оцінювання. Проблеми містять рівень серйозності, джерело та статус, а сторінка проблем — це черга тріажу: фільтруйте, перевіряйте проблемний дзвінок і відстежуйте виправлення.

У дашборді: Проблеми (/dashboard/issues), а також позначення для кожного дзвінка в історії дзвінків. Див. Тріаж проблем.

В API: /v1/issue-reports.

Звіти

Звіт відповідає на запитання природною мовою про дані ваших дзвінків («Якими були три найпоширеніші причини, через які абоненти просили з’єднати з людиною минулого тижня?») за допомогою аналізу, написаного ШІ, з обмеженням агентами та діапазоном дат, які ви вибираєте.

У дашборді: Звіти (/dashboard/reports). Див. Звіти.

Спостережуваність

Спостережуваність — це інтерфейс метрик: обсяг дзвінків, результати та якість у часі, з можливістю фільтрації за агентом і часовим вікном, а також експорту для подальшого аналізу.

У дашборді: Спостережуваність (/dashboard/observability). Див. Спостережуваність.

Сповіщення

Правило сповіщення відстежує метрику (відсоток успіху, відсоток збоїв, середній бал, обсяг дзвінків, регресії наборів) у часовому вікні та спрацьовує, коли вона перетинає заданий вами поріг. Сповіщення надходять на електронну пошту та в Slack і надсилають подію alert.triggered до ваших кінцевих точок webhook.

У дашборді: Організація → Сповіщення. Див. Сповіщення.

Вебхуки

ThunderPhone надсилає HTTP POST вебхуки на ваш сервер, коли під час і після дзвінка відбуваються певні події. Є дві моделі доставки:

Кінцеві точки вебхуків (рекомендовано): керуйте багатьма URL за адресою /v1/developer/webhook-endpoints із окремими секретами та підписками на події для кожної кінцевої точки.
Застарілий вебхук з одним URL: один URL на організацію. Керується за адресою /v1/webhook або в розділі Організація → Загальні. Зберігається для зворотної сумісності.

Події поділяються на два класи:

Блокувальні події очікують, що ваш сервер відповість конфігурацією, яка впливає на поточний дзвінок — це події вхідного дзвінка (telephony.incoming / web.incoming). У вас є до 10 секунд на відповідь; у разі тайм-ауту дзвінок обробить статично призначений агент.
Неблокувальні події — це сповіщення типу «надіслати й забути», які повторно надсилаються з експоненційною затримкою — див. семантику доставки.

Кожен запит містить підпис HMAC-SHA256 у 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; вартість дзвінків списується з нього за похвилинним тарифом агента (рівень рушія та доплати — конструктор показує повний тариф у реальному часі, коли ви змінюєте налаштування, а вибрані додаткові мови додають 3¢/хв). Коли баланс досягає нуля, вхідні дзвінки відхиляються, а вихідні дзвінки повертають 402 Payment Required.

Поповнюйте баланс вручну або ввімкніть автоматичне поповнення з порогом балансу, сумою поповнення та необов’язковим місячним лімітом витрат — щоб дзвінок ніколи не обірвався посеред речення.

У панелі керування: Організація → Налаштування оплати та Історія оплат. Див. Поповнення балансу та ввімкнення автоматичного поповнення, а також повний довідник цін.

В API: /v1/billing.

Вбудований копілот

Панель керування містить вбудований копілот — запитайте його «як мені зробити X», і він відповість на основі цієї документації, запропонує покрокові інструкції з підсвічуванням реальних елементів керування та зможе повторити будь-який керований тур. Це найшвидший спосіб знайти елемент керування, згаданий на цій сторінці. Див. Запитайте вбудованого копілота.