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

ThunderPhone је свеобухватна платформа за изградњу, покретање и унапређивање AI гласовних агената. Ова страница је мапа: сваки концепт са којим ћете се сусрести, у по једном кратком одељку, са површином контролне табле и API-јем који га подржава. Прелистајте је једном, па јој се вратите кад год неки појам треба додатно објашњење.

Бочна трака контролне табле одражава ову структуру:

Организације

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

sk_live_ API кључ који креирате у оквиру Организација → Кључеви везан је за једну организацију. То повезивање чини REST API тако једноставним: никада не стављате ID организације у 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 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 чаробњак ће припремити дефиницију алатке, или је направите ручно; дугме Тестни захтев покреће позив у изолованом окружењу пре објављивања. Погледајте 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). Погледајте Праћење и надзор позива уживо.

Симулaције

Симулација је 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). Имате до 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“ и он одговара на основу ове документације, нуди детаљна упутства корак по корак која истичу стварне контроле и може да понови било који од вођених обилазака. То је најбржи начин да пронађете контролу поменуту на овој страници. Погледајте Питајте копилота у апликацији.

Обједињавање