Open in
Основни појмови
Мапа свега на платформи — шта сваки објекат ради, где се налази на контролној табли и који API га користи.
ThunderPhone је комплетна платформа за изградњу, покретање и унапређивање AI гласовних агената. Ова страница је мапа: сваки концепт са којим ћете се сусрести, по један кратак одељак, са површином контролне табле и API-јем који га подржава. Прелистајте је једном, а затим јој се вратите кад год неки појам захтева објашњење.
Бочна трака старог приказа контролне табле одражава ову структуру:
Праћење уживо и одлазне кампање.
Апликације, API-ји, MCP сервери и VoIP добављачи које ваши агенти могу да користе.
Веб-хукови и функционални алати за ваш сопствени код.
Организације
Организација је јединица закупа. Сваки други ресурс — агенти, бројеви телефона, позиви, кључеви — припада тачно једној организацији. Ваш налог може припадати многим организацијама; свака има сопствено стање, сопствене кључеве и сопствену листу чланова.
API кључ sk_live_ који креирате у оквиру Интеграције → API кључеви
(мени организације; Организација → Кључеви у старом приказу) је
повезан са једном организацијом. Та повезаност чини REST API тако
једноставним: никада не стављате ID организације у 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.
Позиви
Сваки долазни позив, одлазни позив, симулација и сесија виџета постаје запис позива. Позив садржи комплетан транскрипт са ознакама улога, структурисану историју потеза (укључујући позиве алата), снимак, укупан износ наплате и опционе 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) — везе са HubSpot, Salesforce, Google Calendar, Google Sheets и Cal.com. Повежите једном, а затим укључите или искључите алате за појединачне операције (ажурирање или уметање HubSpot контакта, заказивање Cal.com термина…) за било ког агента. Погледајте Повежите апликације. - АПИ-ји (
/dashboard/api-connections) — претворите било који HTTP АПИ у радњу агента. Налепите cURL команду и AI чаробњак ће направити нацрт дефиниције алата, или је направите ручно; дугме Тестирајте захтев покреће позив у изолованом окружењу пре објављивања. Погледајте АПИ везе — приказ у контролној табли за/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.
Копилот у апликацији
Контролна табла има уграђени копилот — питајте га „како да урадим нешто“ и он одговара на основу ове документације, нуди водиче корак по корак који истичу стварне контроле и може да понови било који од вођених обилазака. То је најбржи начин да пронађете контролу коју ова страница помиње. Погледајте Питајте копилота у апликацији.
Обједињавање свега
Чаробњак у пет корака: агент → наплата → број → симулација → преглед.
Исти први позив у четири REST позива.
Направите агента, уплатите средства, добијте број, симулирајте и прегледајте позиве.
OAuth апликације, прилагођени API-ји, MCP сервери и VoIP провајдери.
Извештаји, надгледање, експерименти, проблеми и упозорења.
Позивнице и улоге, API кључеви, безбедност и SSO.
API рецепти: долазни, одлазни, динамичка конфигурација, алати, тестирање.
Једном исправно подесите HMAC проверу и користите је свуда.