Основни понятия

ThunderPhone е цялостна платформа за създаване, управление и подобряване на гласови агенти с изкуствен интелект. Тази страница е картата: всяка концепция, с която ще се сблъскате, е представена в кратък раздел, заедно с повърхността в таблото за управление и API, което я поддържа. Прегледайте я веднъж, след което се връщайте към нея винаги когато даден термин се нуждае от пояснение.

Страничната лента на таблото за управление отразява тази структура:

Организации

Организацията е единицата за изолация на клиенти. Всеки друг ресурс — агенти, телефонни номера, обаждания, ключове — принадлежи точно на една организация. Вашият акаунт може да принадлежи към много организации; всяка има собствен баланс, собствени ключове и собствен списък с членове.

API ключът sk_live_, който създавате в Организация → Ключове, е обвързан с една организация. Това обвързване прави REST API толкова плоско: никога не поставяте идентификатор на организация в URL пътищата, защото ключът ви вече я идентифицира.

В таблото за управление: превключвателят на организации (в долната част на страничната лента) и настройките на Организация — раздели за Моят акаунт, Общи, Ключове, Известия, Настройки за фактуриране и История на фактурирането. Вижте справочника за настройките на организацията.

В API: /v1/orgs, /v1/developer/api-keys.

Агенти

Агентът е конфигурацията с изкуствен интелект, която управлява обаждане. Той обединява:

• Подкана, която определя какво казва агентът и как се държи — включително действия по време на обаждане като прехвърляния, натискания на клавиши и прекратяване на разговора, които са обикновени редове в подканата, а не отделна конфигурация.
• Ниво на енджина (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 trunk. След като бъдат импортирани и потвърдени, VoIP номерата поддържат входящи и изходящи обаждания.

Всеки ред с номер ви позволява да зададете режим на маршрутизиране, да изберете агента за входящи обаждания и да добавите етикет към номера.

В таблото за управление: Телефонни номера (/dashboard/phone-numbers). Вижте Получаване на телефонен номер.

В API: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Обаждания

Всяко входящо обаждане, изходящо обаждане, симулация и сесия с уиджет се превръща в дневник на обаждане. Обаждането съдържа пълния транскрипт с обозначени роли, структурираната история на ходовете (включително извиквания на инструменти), запис, общата сума за таксуване и незадължително AI оценяване и доклади за проблеми.

Докато обаждането е на живо, можете да го отворите и да слушате разговора — присъединявате се безшумно и никой в разговора не ви чува. След като слушате, можете да прошепвате: въведете инструкция, която отива директно към вашия агент по време на разговора; обаждащият се никога не я чува, а агентът я следва на живо.

В таблото за управление: История на обажданията (/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 команда и AI съветникът ще създаде чернова на дефиницията на инструмента или я изградете ръчно; бутонът Тестова заявка изпраща заявка в тестова среда, преди да внедрите. Вижте 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). Вижте Наблюдение и контрол на обаждания на живо.

Симулации

Симулация представлява AI обаждащ се, който води реален разговор с Вашия агент — със същия телефонен път, реален транскрипт и реално оценяване — така че можете да тествате преди (и след като) внедрите. Насочете я към агент или телефонен номер, напишете сами сценария за обаждащия се или генерирайте сценарии с AI от подканата на агента (включително гранични случаи, ако поискате), и наблюдавайте обаждането на живо.

Сценариите се групират в пакети, които задават минимален процент на успешно преминаване и могат да блокират версии в CI; регресиите спрямо приетата базова линия се отчитат за всеки сценарий.

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

В API: /v1/test-calls и изпълнителя на пакети — вижте Цялостно тестване на агент.

Набори за валидиране

Набор за валидиране превръща моменти от реални обаждания в повторяеми едноходови проверки за регресии. Всеки пример фиксира контекста на разговора, релевантното аудио на обаждащия се, оригиналния отговор и очакваното поведение. Повторните изпълнения се извършват спрямо текущата чернова на агента, без да се осъществява друго обаждане, а диалоговият прозорец за внедряване може да покаже дали последното изпълнение все още съответства на тази чернова.

В таблото за управление: Набори за валидиране (/dashboard/validation) за набора от данни на организацията и разделът Валидиране в конструктора на агента за изпълненията. Вижте Набори за валидиране.

В API: /v1/validation-sets и крайните точки за повторно изпълнение на агент/пример на същата референтна страница.

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

Експеримент извършва A/B тестване на конфигурации на агента с реален трафик: дефинирайте варианти (различни подкани, машини или настройки), разпределете трафика между тях и сравнете резултатите за всеки вариант. Използвайте го вместо ръчно създадена логика за разпределяне в webhook.

В таблото за управление: Експерименти (/dashboard/experiments) и разделът A/B в конструктора на агента. Вижте Експерименти (A/B тестване).

Проблеми

Проблем е маркиран казус при конкретно обаждане — подаден от човек, който извършва преглед, или открит чрез AI оценяване. Проблемите съдържат ниво на сериозност, източник и статус, а страницата „Проблеми“ е опашката за триаж: филтрирайте, прегледайте проблемното обаждане и проследявайте корекциите.

В таблото за управление: Проблеми (/dashboard/issues), както и маркиране за всяко обаждане в История на обажданията. Вижте Триаж на проблеми.

В API: /v1/issue-reports.

Отчети

Отчет отговаря на въпрос на естествен език за данните от Вашите обаждания („Кои бяха трите основни причини обаждащите се да поискат човек миналата седмица?“) чрез анализ, написан от AI и ограничен до избраните от Вас агенти и диапазон от дати.

В таблото за управление: Отчети (/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 и спецификацията за Функционални инструменти.

Екип и роли

Всяка организация има списък с членове с две роли: Членовете създават и управляват агенти; Администраторите също управляват екипа и таксуването. Поканете по имейл — поканите изтичат след 7 дни и могат да бъдат отменени; менюто ⋯ на реда на член променя ролите или премахва даден човек. Единичното влизане може да се конфигурира за цялата организация — вижте SSO.

В таблото за управление: Организация → Общи. Вижте Поканете екипа си.

В API: /v1/members, /v1/invites.

Таксуване

ThunderPhone е предплатен. Всяка организация разполага с баланс в USD; обажданията го дебитират според цената на агента за минута (ниво на енджина плюс допълнителни такси — създателят показва общата цена в реално време, докато променяте настройките, а избрани допълнителни езици добавят 3¢/мин). Когато балансът достигне нула, входящите обаждания се отхвърлят, а изходящите обаждания връщат 402 Payment Required.

Зареждайте средства ръчно или активирайте автоматично зареждане с праг на баланса, сума за зареждане и незадължителен месечен лимит на разходите — така обаждането никога няма да прекъсне по средата на изречение.

В таблото за управление: Организация → Настройки за таксуване и История на таксуването. Вижте Добавете средства и включете автоматично зареждане, както и пълната справка за ценообразуването.

В API: /v1/billing.

Вграденият копилот

Таблото за управление включва вграден копилот — попитайте го „как да направя X“ и той отговаря въз основа на тази документация, предлага ръководства стъпка по стъпка, които открояват действителните контроли, и може да възпроизведе всяка от Водени обиколки. Това е най-бързият начин да намерите контрола, споменат на тази страница. Вижте Попитайте вградения копилот.

Обобщение