Основни појмови

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

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 бројеви — стварни амерички бројеви обезбеђени из 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 и документацију за 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 на стварном саобраћају: дефинишите варијанте (различите промптове, механизме или подешавања), поделите саобраћај између њих и упоредите исходе по варијанти. Користите га уместо ручне имплементације логике сегментирања у вебхуку.

На контролној табли: Експерименти (/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“ и он одговара на основу ове документације, нуди упутства корак по корак која истичу стварне контроле и може да поново покрене било који од вођених обилазака. То је најбржи начин да пронађете контролу коју ова страница помиње. Погледајте Питајте уграђени копилот.

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