Põhimõisted

Ülevaade kõigest platvormil — mida iga objekt teeb, kus see juhtpaneelis asub ja milline API sellega suhtleb.

ThunderPhone on terviklik platvorm AI häälagentide loomiseks, käitamiseks ja täiustamiseks. See leht on kaart: kõik mõisted, millega kokku puutud, igaüks lühikeses jaotises koos seda toetava juhtpaneeli vaate ja API-ga. Sirvi see üks kord läbi, seejärel tule tagasi, kui mõni termin vajab selgitamist.

Juhtpaneeli külgriba järgib sama struktuuri:

Organisatsioonid#

Organisatsioon on eraldatud kasutusruumi üksus. Kõik muud ressursid — agendid, telefoninumbrid, kõned, võtmed — kuuluvad täpselt ühele organisatsioonile. Sinu konto võib kuuluda mitmesse organisatsiooni; igal neist on oma saldo, oma võtmed ja oma liikmete loend.

API-võti sk_live_, mille lood jaotises Organisatsioon → Võtmed, on seotud ühe organisatsiooniga. See seos muudab REST API nii lihtsaks: sa ei lisa kunagi URL-i radadesse organisatsiooni ID-d, sest sinu võti juba tuvastab selle.

Juhtpaneelil: organisatsiooni valija (külgriba jaluses) ja Organisatsiooni seaded — vahekaardid Minu konto, Üldine, Võtmed, Teavitused, Arvelduse seaded ja Arveldusajalugu. Vaata organisatsiooni seadete viidet.

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

Agendid#

Agent on kõnet käitav AI-konfiguratsioon. See hõlmab järgmist:

• Juhis, mis määrab, mida agent ütleb ja kuidas see käitub — sealhulgas kõnetoimingud nagu ülekanded, klahvistiku vajutused ja kõne lõpetamine, mis on eraldi konfiguratsiooni asemel tavalised juhiseread.
• Mootori tase (spark, bolt, storm-*): Spark on optimeeritud hinna, Bolt kiiruse ja Storm keerukate juhiste intelligentsuse jaoks.
• Hääl ning esmane keel ja valikulised lisakeeled — agent vahetab automaatselt keelt, kui helistaja keelt vahetab. Vaata toetatud keeli.
• Lisatud võimalused: ühendatud rakendused, API-ühendused, teadmusbaasid, MCP-serverid ja tekstisisesed funktsioonitööriistad.
• Käitumise seaded: rääkimisjärjekord, kinnitamisrežiim, taustaheli, ooteaja aegumine.

Muudatused koostajas salvestatakse automaatselt mustandina; miski ei avaldu enne, kui klõpsad Juuruta. Iga juurutus salvestatakse koostaja Ajaloo vahekaardile, nii et saad kontrollida ja taastada mis tahes varasema versiooni.

Juhtpaneelil: Häälagendid → agendi koostaja (/dashboard/agents). Vaata oma esimese häälagendi loomist.

API-s: /v1/agents — CRUD, paljundamine, ülekanne, versiooniajalugu ja juhiste abifunktsioonid.

Hääled#

Hääleteek sisaldab hääli, mida agent saab kasutada, nende esitatavaid näidiseid, ühilduvaid keeli, soo- ja aktsendirühmi ning võimalikke premium-häälte või -keelte lisatasusid. Tasuline näidisfunktsioon võimaldab sul enne valimist sünteesida oma 1–500 tähemärgi pikkuse fraasi.

Nõuetele vastavad organisatsioonid saavad luua ka kohandatud hääli lühikese WAV- või MP3-näidise põhjal. Kohandatud häältel on kvoot ja asünkroonne loomise olek; kui need on valmis, kuvatakse need agendi valikus koos teegi häältega.

Töölaual: Hääled (/dashboard/voices). Vaata Hääleteeki ja kohandatud hääli.

API-s: /v1/voices, häälenäidised ja kohandatud hääled.

Telefoninumbrid#

Telefoninumber kuulub organisatsioonile ja suunab sissetulevad kõned agendile (ning seda saab kasutada väljaminevate kõnede jaoks). Kaks allikat:

• ThunderPhone'i numbrid — päris USA numbrid, mis hangitakse ThunderPhone'i numbripargist, on aktiivsed sekunditega ja maksavad $1/kuus pluss 1¢/minut lisatasu. Ainult sissetulevateks kõnedeks; väljaminevate kõnede jaoks vajad oma operaatorit. Organisatsioonil võib vaikimisi olla 25 numbrit.
• VoIP-numbrid — tood oma teenusepakkujalt VoIP-ühenduse kaudu. Twilio ja Telnyx ühenduvad otse (Telnyxil on juhendatud seadistus); SignalWire ja Vonage lisanduvad peagi — praegu saad nendeni jõuda käsitsi SIP-konfiguratsiooni kaudu, mis toetab mis tahes SIP-trunki. Pärast importimist ja kinnitamist toetavad VoIP-numbrid nii sissetulevaid kui ka väljaminevaid kõnesid.

Iga numbri real saad määrata suunamisrežiimi, valida sissetulevate kõnede agendi ja lisada numbrile sildi.

Töölaual: Telefoninumbrid (/dashboard/phone-numbers). Vaata Telefoninumbri hankimine.

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

Kõned#

Igast sissetulevast kõnest, väljaminevast kõnest, simulatsioonist ja vidinaseansist saab kõnelogi. Kõne sisaldab täielikku rollisiltidega transkripti, struktureeritud voorude ajalugu (sealhulgas tööriistakutseid), salvestist, arvelduse kogusummat ning valikulist AI-poolset hindamist ja probleemiaruandeid.

Kui kõne on aktiivne, saad selle avada ja seda pealt kuulata — liitud vaikselt ning keegi kõnes osalejatest ei kuule sind. Kuulamise ajal saad sosistada: kirjuta juhis, mis saadetakse kõne ajal otse sinu agendile; helistaja ei kuule seda kunagi ja agent järgib seda reaalajas.

Töölaual: Kõneajalugu (/dashboard/call-history) arhiivi ja kõne üksikasjade jaoks; Aktiivsed pooleliolevate kõnede jaoks. Vaata Oma kõnede ülevaatamine, pealtkuulamine ja juhendamine.

API-s: /v1/calls — loend, transkript, ajalugu, heli, hindamine, eksport; /v1/issue-reports.

Kliendiportaalid#

Kliendiportaal on väliskliendile mõeldud kaubamärgistatud kirjutuskaitstud kõneajaloo vaade. Organisatsiooni administraatorid valivad agendid, kelle kõnesid kuvatakse, lisavad heaks kiidetud vaatlejate e-posti aadressid, laadivad üles logo ja aktsentvärvi ning saavad soovi korral kinnitada kohandatud domeeni. Portaali vaatlejad saavad vaadata kõne üksikasju, transkripte ja saadaolevaid salvestisi, ilma et neile antaks juurdepääs töölauale.

Töölaual: Kliendiportaalid (/dashboard/client-portals). Vaata Kliendiportaalid.

API-s: /v1/client-portals administraatori haldusliidese jaoks.

Veebividinad#

Veebividin võimaldab sinu saidi külastajatel mikrofoni kaudu agendiga vestelda — telefoninumbrit pole vaja. See autentib end avaliku võtmega (pk_live_...), mis on päritolupiiranguga seotud sinu lubatud domeenidega, nii et seda on turvaline kasutada kliendipoolses koodis.

Võtmed töötavad ühes kahest režiimist: agent (staatiliselt seotud ühe agendiga) või webhook (sinu server valib konfiguratsiooni iga külastaja jaoks — vt Dünaamiline kõnepõhine konfiguratsioon). Vidina seansid kasutavad sama kõnetaristut nagu telefonikõned.

Töölaual: Veebividinad (/dashboard/web-widgets) — loo vidinaid, määra režiim ja agent, halda lubatud domeene ning kopeeri manustamiskood. Vaata Veebividina loomine.

API-s: /v1/publishable-key, /v1/mic-session ja Widget SDK dokumentatsioon.

Teadmistebaasid#

Teadmistebaas on dokumentide kogum, millest sinu agent saab kõne ajal vastuste põhjendamiseks otsida — laadi üles faile, kleebi teksti või impordi veebilehti URL-i järgi ning seejärel seo teadmistebaas koosturis agendiga. Agent esitab sellele sisseehitatud otsingutööriistaga päringuid alati, kui vestlus seda nõuab.

Töölaual: Teadmised (/dashboard/knowledge) dokumentide kogu jaoks; koosturi jaotis Teadmised, et see agendiga siduda. Vaata Anna oma agendile teadmistebaas.

Ühendused#

Ühenduste kaudu saavad agendid välismaailmaga suhelda. Neli tüüpi, üks külgriba rühm:

• Rakendused (/dashboard/app-connections) — OAuth-ühendused Slacki, HubSpoti, Salesforce'i, Google Calendar'i, Google Sheetsi ja Cal.comiga. Ühenda üks kord, seejärel lülita toimingupõhiseid tööriistu (Slacki sõnumi saatmine, HubSpoti kontakti lisamine või värskendamine, Cal.comi aja broneerimine…) sisse mis tahes agendi jaoks. Vaata Rakenduste ühendamine.
• API-d (/dashboard/api-connections) — muuda mis tahes HTTP API agendi toiminguks. Kleebi cURL-käsk ning AI-viisard koostab tööriista definitsiooni mustandi, või loo see käsitsi; nupp Testpäring teeb enne avaldamist liivakastis kõne. Vaata API-ühendused — töölaualiides /v1/integrations jaoks.
• MCP (/dashboard/mcp-connections) — lisa Model Context Protocoli server URL-i järgi ja lase agendil kasutada selle pakutavaid tööriistu. Vaata MCP-serveri lisamine.
• VoIP (/dashboard/voip-connections) — teenusepakkuja mandaadid oma telefoninumbrite kasutamiseks. Vaata VoIP-teenusepakkuja ühendamine.

ThunderPhone pakub ka oma MCP-lõpp-punkti, et väline MCP-klient saaks loetleda agente, vaadata kõnesid ja transkriptsioone ning teha kõnesid. Vaata ThunderPhone'i kasutamine MCP-serverina.

API-s: /v1/integrations, /v1/mcp-servers ja /v1/voip-connections; vaata ka Tööriistaintegratsiooni loomine.

Kampaaniad#

Kampaania teeb väljaminevaid kõnesid suurel mahul: laadi üles kontaktide CSV, vali agent ja lähtev number ning määra helistamisaken (päevad ja kellaajad, ajavööndit arvestades), samaaegsuse tase ja uuestiproovimise poliitika (maksimaalne katsete arv ning milliste tulemuste — vastamata kõne, kõnepost, ebaõnnestunud — korral proovitakse uuesti). Kampaania liigub läbi loendi ja salvestab iga kõne kõneajalukku.

Töölaual: Kampaaniad (/dashboard/campaigns). Vaata Väljaminevate kõnede kampaania käivitamine.

Ühekordsete programmiliste kõnede jaoks: kasuta väljaminevate kõnede API-t.

Reaalajas jälgimine#

Reaalajas kuvab kõik organisatsioonis käimasolevad kõned ja võimaldab avada neist ükskõik millise, et pealt kuulata ja sosistada reaalajas. See on järelevalvevaade: jälgi, kuidas uus viip saab oma esimese päris liikluse, või hoia käimasoleval kampaanial silm peal.

Töölaual: Reaalajas (/dashboard/live). Vaata Jälgi ja halda reaalajas kõnesid.

Simulatsioonid#

Simulatsioon on AI-helistaja päris vestlus sinu häälagendiga — sama telefonitee, päris transkript, päris hindamine — et saaksid testida enne (ja pärast) avaldamist. Suuna see häälagendile või telefoninumbrile, kirjuta helistaja stsenaarium ise või genereeri stsenaariumid AI abil häälagendi viibast (soovi korral ka äärejuhtumid) ning jälgi kõnet reaalajas.

Stsenaariumid koonduvad komplektidesse, mis määravad minimaalse läbimise määra ja võivad CI-s väljalaskeid blokeerida; kõrvalekalletest aktsepteeritud baasjoonest teatatakse iga stsenaariumi kohta eraldi.

Töölaual: Simulatsioonid (/dashboard/simulations) ning nupp Simulatsioon häälagendi koostajas. Vaata Simuleeri kõnet.

API-s: /v1/test-calls ja komplekti käitaja — vaata Testi häälagenti otsast lõpuni.

Valideerimiskomplektid#

Valideerimiskomplekt muudab päris kõnede hetked korratavateks ühe vooru regressioonikontrollideks. Iga näide talletab vestluse konteksti, asjakohase helistaja heli, algse vastuse ja oodatud käitumise. Taasesitused käitatakse praeguse häälagendi mustandi vastu ilma uut kõnet tegemata ning avaldamise dialoog võib näidata, kas viimane käitus vastab endiselt sellele mustandile.

Töölaual: Valideerimiskomplektid (/dashboard/validation) organisatsiooni andmestiku jaoks ning häälagendi koostaja vahekaart Valideerimine käituste jaoks. Vaata Valideerimiskomplektid.

API-s: /v1/validation-sets ning häälagendi/näite taasesituse lõpp-punktid samal viitelehel.

Eksperimendid#

Eksperiment A/B-testib häälagendi konfiguratsioone päris liiklusel: määratle variandid (erinevad viibad, mootorid või seaded), jaga liiklus nende vahel ning võrdle tulemusi variandi kaupa. Kasuta seda veebikonksus käsitsi kohortide loogika koostamise asemel.

Töölaual: Eksperimendid (/dashboard/experiments) ja häälagendi koostaja vahekaart A/B. Vaata Eksperimendid (A/B-testimine).

Probleemid#

Probleem on märgitud tõrge konkreetsel kõnel — selle on esitanud inimülevaataja või tuvastanud AI-hindamine. Probleemidel on tõsidusaste, allikas ja olek ning leht Probleemid on triaažijärjekord: filtreeri, kontrolli probleemset kõnet ja jälgi parandusi.

Töölaual: Probleemid (/dashboard/issues) ning kõnepõhine märgistamine kõneajaloos. Vaata Probleemide triaaž.

API-s: /v1/issue-reports.

Aruanded#

Aruanne vastab sinu kõneandmete kohta esitatud loomulikus keeles küsimusele ("Mis olid kolm peamist põhjust, miks helistajad eelmisel nädalal inimest küsisid?") AI kirjutatud analüüsiga, mis on piiratud sinu valitud häälagentide ja kuupäevavahemikuga.

Töölaual: Aruanded (/dashboard/reports). Vaata Aruanded.

Jälgitavus#

Jälgitavus on mõõdikute vaade: kõnede maht, tulemused ja kvaliteet ajas, filtreeritav häälagendi ja ajavahemiku järgi ning eksporditav edasise analüüsi jaoks.

Töölaual: Jälgitavus (/dashboard/observability). Vaata Jälgitavus.

Teavitused#

Teavitusreegel jälgib mõõdikut (õnnestumiste määr, ebaõnnestumiste määr, keskmine skoor, kõnede maht, komplekti regressioonid) ajavahemiku jooksul ja käivitub, kui see ületab sinu lävendi. Teavitused saadetakse e-posti ja Slacki ning käivitavad sinu veebikonksu lõpp-punktides sündmuse alert.triggered.

Töölaual: Organisatsioon → Teavitused. Vaata Teavitused.

Veebihaagid#

ThunderPhone saadab sinu serverisse HTTP POST veebihaake, kui kõne ajal või pärast seda midagi toimub. Kasutusel on kaks edastusmudelit:

• Veebihaagi lõpp-punktid (soovitatav): halda mitut URL-i aadressil /v1/developer/webhook-endpoints, kasutades lõpp-punktipõhiseid saladusi ja sündmuste tellimusi.
• Pärandveebihaak ühe URL-iga: üks URL organisatsiooni kohta. Hallatav aadressil /v1/webhook või jaotises Organisatsioon → Üldine. Säilitatud tagasiühilduvuse tagamiseks.

Sündmused jagunevad kahte klassi:

• Blokeerivad sündmused eeldavad, et sinu server vastab konfiguratsiooniga, mis kujundab pooleliolevat kõnet — need on sissetuleva kõne sündmused (telephony.incoming / web.incoming). Vastamiseks on aega kuni 10 sekundit; ajalõpu korral käsitleb kõnet staatiliselt määratud häälagent.
• Mitteblokeerivad sündmused on saada-ja-unusta-teavitused, mida proovitakse eksponentsiaalse viivitusega uuesti — vaata edastuse semantikat.

Iga päring sisaldab HMAC-SHA256 allkirja päises X-ThunderPhone-Signature. Vaata allkirja kontrollimist.

Funktsioonitööriistad#

Funktsioonitööriist on HTTP-lõpp-punkt, mida sinu agent saab vestluse keskel kutsuda. Annad ThunderPhone'ile OpenAI-stiilis funktsiooniskeemi ja lõpp-punkti URL-i; agent otsustab, millal seda kutsuda, ning ThunderPhone teeb allkirjastatud HTTP-päringu oma serveritest ja edastab tulemuse agendile.

Agentidel on ka sisseehitatud kõnevõimalused — kõne suunamine, klahvistiku (DTMF) sisendi saatmine, kõne lõpetamine, ootel ootamine —, mille lubad lihtsate viiparidadega tööriistade määratluste asemel.

Töölaual: koosturi jaotis API-ühendused (vaata Ühendused).

API-s: /v1/integrations ja Function Tools spetsifikatsioon.

Meeskond ja rollid#

Igal organisatsioonil on liikmete loend kahe rolliga: Liikmed loovad ja haldavad agente; Administraatorid haldavad lisaks meeskonda ja arveldust. Kutsu liikmeid e-posti teel — kutsed aeguvad 7 päeva pärast ja neid saab tühistada; liikme rea menüü ⋯ võimaldab rolle muuta või kedagi eemaldada. Ühekordse sisselogimise saab konfigureerida kogu organisatsiooni jaoks — vaata SSO.

Töölaual: Organisatsioon → Üldine. Vaata Kutsu oma meeskond.

API-s: /v1/members, /v1/invites.

Arveldus#

ThunderPhone on ettemakstud. Igal organisatsioonil on USA dollarites saldo; kõned vähendavad seda agendi minutihinna alusel (mootori tase koos lisatasudega — koostur näitab seadete muutmisel reaalajas koguhinda ning valitud lisakeeled lisavad 3¢/min). Kui saldo jõuab nulli, lükatakse sissetulevad kõned tagasi ja väljaminevad kõned tagastavad 402 Payment Required.

Lisa raha käsitsi või luba automaatne saldo täiendamine saldo lävendi, täiendussumma ja valikulise igakuise kululimiidiga — nii ei katke kõne kunagi poole lause pealt.

Töölaual: Organisatsioon → Arveldusseaded ja Arveldusajalugu. Vaata Lisa raha ja lülita automaatne saldo täiendamine sisse ning täielikku hinnastuse viidet.

API-s: /v1/billing.

Rakendusesisene kopiloot#

Töölaual on sisseehitatud kopiloot — küsi sellelt „kuidas ma X-i teen“ ning see vastab nende dokumentide põhjal, pakub samm-sammulisi juhiseid, mis toovad esile tegelikud juhtelemendid, ja saab taasesitada mis tahes juhendatud ringkäigu. See on kiireim viis leida juhtelementi, mida sellel lehel mainitakse. Vaata Küsi rakendusesiseselt kopiloodilt.

Kõik kokku#