ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Getting Started

Основни концепции

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

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

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


Организации

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

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

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

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


Агенти

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

  • подкана, която определя какво казва агентът и как се държи — включително действия по време на разговора, като прехвърляне, натискания на клавиши и прекратяване на разговора, които са обикновени редове в подканата, а не отделна конфигурация.
  • Неговите настройки: интелигентност (Core или Pro), чуване (Lite, Standard, Plus или Max) и скорост на отговор, които балансират цена, бързина и точност.
  • глас, както и основен език и незадължителни допълнителни езици — агентът превключва автоматично, когато обаждащият се смени езика. Вижте Поддържани езици.
  • Прикачени възможности: свързани приложения, API връзки, бази знания, MCP сървъри и вградени инструменти за функции.
  • Настройки за поведение: ред на говорене, режим на потвърждение, фонов звук, време за изчакване при задържане.

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

В таблото: Гласови агенти → конструкторът на агенти (/dashboard/agents). Вижте Създайте своя първи гласов агент.

В API: /v1/agents — CRUD, дублиране, прехвърляне, история на версиите и помощни функции за подкани.


Гласове

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

Допустимите организации могат също да създават персонализирани гласове от кратка WAV или MP3 мостра. Персонализираните гласове имат квота и асинхронен статус на създаване; когато са готови, те се показват в същия инструмент за избор на агент като гласовете от библиотеката.

В таблото: Гласове (/dashboard/voices). Вижте Библиотека с гласове и персонализирани гласове.

В API: /v1/voices, гласови мостри и персонализирани гласове.


Телефонни номера

Телефонният номер принадлежи на организация и маршрутизира входящите обаждания към агент (и може да се използва за изходящи обаждания). Има два източника:

  • Номера на ThunderPhone — реални номера в САЩ, предоставени от пула на ThunderPhone, активни за секунди, $1/месец; минутите за разговори се таксуват като телефонна линия. Първоначално са само за входящи обаждания. Администратор на организацията може да заяви изходящи обаждания от страницата „Телефонни номера“; ThunderPhone разглежда всяка заявка ръчно, а одобрените номера могат да извършват обаждания и да изпълняват кампании. По подразбиране организацията може да притежава 25 номера.
  • VoIP номера — предоставени от ваш собствен доставчик чрез VoIP връзка. Twilio и Telnyx се свързват директно с API ключ (Telnyx предлага и водена настройка на нов акаунт); SignalWire, Vonage, Plivo и всеки друг SIP trunk се свързват чрез SIP настройка, ръчна SIP конфигурация. След импортиране и потвърждаване VoIP номерата поддържат входящи и изходящи обаждания.

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

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

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


Обаждания

Всяко входящо обаждане, изходящо обаждане, симулация и сесия на widget става дневник на обаждане. Обаждането включва пълния транскрипт с означени роли, структурираната история на ходовете (включително извиквания на инструменти), запис, общата сума за таксуване и незадължителни 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) — връзки с HubSpot, Salesforce, Google Calendar, Google Sheets и Cal.com. Свържете веднъж, след което включвайте инструменти за отделни операции (създаване или актуализиране на контакт в 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 тестване на конфигурации на агенти върху реален трафик: дефинирайте варианти (различни подкани, механизми или настройки), разпределете трафика между тях и сравнете резултатите за всеки вариант. Използвайте го вместо ръчно създадена логика за групиране в уебхук.

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


Проблеми

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

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

В API: /v1/issue-reports.


Отчети

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

В таблото за управление: Отчети (/dashboard/reports). Вижте Отчети.


Наблюдаемост

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

В таблото за управление: Наблюдаемост (/dashboard/observability). Вижте Наблюдаемост.


Сигнали

Правилото за сигнал следи метрика (процент на успех, процент на неуспех, среден резултат, обем на обажданията, регресии в пакетите) в рамките на времеви прозорец и се задейства, когато премине зададения от Вас праг. Известията се изпращат по имейл и Slack и задействат събитие alert.triggered към Вашите крайни точки за уебхукове.

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


Уебхукове

ThunderPhone изпраща HTTP POST уебхукове до Вашия сървър, когато нещо се случи по време на или след разговор. Има два модела за доставка:

  • Крайни точки за уебхукове (препоръчително): управлявайте много URL адреси в /v1/developer/webhook-endpoints със секрети за всяка крайна точка и абонаменти за събития за всяка крайна точка.
  • Наследен уебхук с един URL адрес: един URL адрес за организация. Управлява се от /v1/webhook или от Организация → Общи. Запазен е за обратна съвместимост.

Събитията се разделят на два класа:

  • Блокиращите събития очакват сървърът ви да отговори с конфигурация, която оформя протичащото обаждане — това са събитията при входящо обаждане (telephony.incoming / web.incoming). Телефонно обаждане изчаква до 13 секунди, включително един повторен опит, а сесия на уиджет — 10 секунди. Няма резервен агент: без използваема конфигурация телефонното обаждане се прекратява, а сесията на уиджета е неуспешна.
  • Неблокиращите събития са известия от типа „изпрати и забрави“, повтаряни с експоненциално забавяне — вижте семантика на доставянето.

Всяка заявка съдържа HMAC-SHA256 подпис с времеви печат в X-ThunderPhone-Signature-V2, както и наследения подпис само на тялото X-ThunderPhone-Signature. Вижте Проверка на подписа.


Инструменти за функции

Инструментът за функции е HTTP крайна точка, която Вашият агент може да извика по средата на разговор. Предоставяте на ThunderPhone схема на функция в стил OpenAI заедно с URL адрес на крайна точка; агентът решава кога да я извика, а ThunderPhone изпраща подписаната HTTP заявка от своите сървъри и връща резултата на агента.

Агентите включват и вградени възможности за разговори — прехвърляне на разговора, изпращане на въвеждане от клавиатурата (DTMF), приключване на разговора, изчакване на задържане — които активирате с обикновени редове в подканата, вместо с дефиниции на инструменти.

В таблото: разделът API връзки на конструктора (вижте Връзки).

В API: /v1/integrations и спецификацията за инструменти за функции.


Екип и роли

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

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

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


Плащания

ThunderPhone е предплатен. Всяка организация разполага със салдо в USD; при всяко обаждане се начислява стойността на неговите компоненти по каталожните цени на нашите доставчици, плюс инфраструктурна такса и марж от 17–25% (вижте ценообразуване). Когато салдото достигне нула, входящите обаждания се отхвърлят, а изходящите обаждания връщат 402 Payment Required.

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

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

В API: /v1/billing.


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

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


Обобщение