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

Карта на всичко в платформата — какво прави всеки обект, къде се намира в таблото за управление и кой API го използва.

ThunderPhone е цялостна платформа за създаване, изпълнение и подобряване на AI гласови агенти. Тази страница е картата: всяка концепция, с която ще се срещнете, е представена в кратък раздел, заедно с интерфейса в таблото за управление и 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 — реални американски номера, предоставени от пула на ThunderPhone, активни за секунди, $1/месец плюс доплащане от 1¢/минута. Само за входящи обаждания; за изходящи е необходим ваш собствен оператор. Една организация може да притежава 25 по подразбиране.
• 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 и документацията за 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 съветникът ще подготви чернова на дефиницията на инструмента, или я създайте ръчно; бутонът Тестова заявка изпраща sandbox заявка, преди да внедрите. Вижте 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“ и той ще отговори въз основа на тази документация, ще предложи инструкции стъпка по стъпка, които открояват реалните контроли, и може да възпроизведе всяка от Водените обиколки. Това е най-бързият начин да намерите контрола, споменат на тази страница. Вижте Попитайте вградения копилот.

Обобщение#