Põhimõisted

ThunderPhone on täielik platvorm AI häälagentide loomiseks, käitamiseks ja täiustamiseks. See leht on kaart: iga mõiste, millega kokku puutud, on lühidalt selgitatud koos seda toetava juhtpaneeli vaate ja API-ga. Sirvi see korra läbi ning tule tagasi, kui mõni mõiste vajab täpsemat selgitust.

Juhtpaneeli külgriba järgib sama ülesehitust:

Organisatsioonid

Organisatsioon on rentimise ü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 teeb REST API nii lihtsaks: sa ei lisa kunagi URL-i teedele organisatsiooni ID-d, sest sinu võti tuvastab selle juba.

Juhtpaneelil: organisatsiooni valija (külgriba jaluses) ja Organisatsiooni seaded — vahekaardid Minu konto, Üldine, Võtmed, Teavitused, Arveldamise seaded ja Arveldamise ajalugu. 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:

• Viip, mis määrab, mida agent ütleb ja kuidas see käitub — sealhulgas kõnetoimingud, nagu suunamised, klahvistikuvajutused ja kõne lõpetamised, mis on eraldi konfiguratsiooni asemel lihtsalt viiba read.
• Mootoritase (spark, bolt, storm-*): Spark on optimeeritud kulude jaoks, Bolt kiiruse jaoks ja Storm keerukate viipade puhul intelligentsuse jaoks.
• Hääl koos esmase keelega ja valikuliste lisakeeltega — agent vahetab automaatselt keelt, kui helistaja keelt vahetab. Vaata toetatud keeli.
• Ühendatud võimalused: ühendatud rakendused, API-ühendused, teadmistebaasid, MCP-serverid ja sisemised funktsioonitööriistad.
• Käitumise seadistused: kõnejärjekord, kinnitamisrežiim, taustaheli, ooteaja ajalõpp.

Muudatused koostajas salvestatakse automaatselt mustandisse; miski ei jõua kasutusse enne, kui klõpsad nuppu Juuruta. Iga juurutus salvestatakse koostaja vahekaardil Ajalugu, 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, dubleerimine, suunamine, versiooniajalugu ja viibaabilised.

Hääled

Häälteek sisaldab hääli, mida agent saab kasutada, nende esitatavaid näidiseid, ühilduvaid keeli, soo- ja aktsendirühmitusi ning võimalikke premium-hääle või -keele lisatasusid. Tasuline proovivahend saab enne valiku tegemist sünteesida sinu enda 1–500 märgi pikkuse fraasi.

Sobivad organisatsioonid saavad luua ka kohandatud hääli lühikese WAV- või MP3-näidise põhjal. Kohandatud häälte jaoks kehtib kvoot ja nende loomise olek on asünkroonne; kui hääl on valmis, kuvatakse see samas agendi valijas nagu teegihääled.

Töölaual: Hääled (/dashboard/voices). Vaata häälteeki 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 võib kasutada väljuvate kõnede jaoks). Kaks allikat:

• Demonumbrid — ThunderPhone'i numbripargist eraldatud päris USA numbrid, mis on aktiivsed sekunditega. Ainult sissetulevate kõnede jaoks, vastavad nad lühikese suulise teavitusega ning töölaud piirab nende arvu organisatsiooni kohta 10-ni. Sobivad suurepäraselt esimeseks testiks, kuid mitte tootmiskasutuseks.
• 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-konfigureerimise kaudu, mis aktsepteerib mis tahes SIP-trunki. Pärast importimist ja kinnitamist toetavad VoIP-numbrid nii sissetulevaid kui ka väljaminevaid kõnesid.

Iga numbririda võimaldab määrata suunamisrežiimi, valida sissetulevate kõnede agendi ja lisada numbrile sildi.

Töölaual: Telefoninumbrid (/dashboard/phone-numbers). Vaata telefoninumbri hankimist.

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

Kõned

Iga sissetulev kõne, väljaminev kõne, simulatsioon ja vidinaseanss muutub kõnelogiks. Kõne sisaldab täielikku rollisiltidega transkriptsiooni, struktureeritud voorude ajalugu (sh tööriistakutseid), salvestist, arvelduse kogusummat ning valikulist AI-hindamist ja probleemiaruandeid.

Kui kõne on aktiivne, saad selle avada ja pealt kuulata — liitud vaikselt ning keegi kõnes osalejatest ei kuule sind. Kuulamise ajal saad sosistada: sisesta 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 käimasolevate kõnede jaoks. Vaata kõnede ülevaatamist, pealtkuulamist ja juhendamist.

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

Kliendiportaalid

Kliendiportaal on bränditud, ainult lugemiseks mõeldud kõneajaloo vaade välise kliendi jaoks. Organisatsiooni administraatorid valivad agendid, kelle kõned kuvatakse, lisavad heakskiidetud vaatajate e-posti aadressid, laadivad üles logo ja aktsentvärvi ning saavad soovi korral kinnitada kohandatud domeeni. Portaali vaatajad saavad uurida kõne üksikasju, transkriptsioone ja saadaolevaid salvestisi ilma töölauale juurdepääsu saamata.

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

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

Veebividinad

Veebividin võimaldab sinu saidi külastajatel mikrofoni kaudu häälagendiga vestelda — telefoninumbrit pole vaja. See autentib end avalikustatava võtmega (pk_live_...), mis on lukustatud sinu lubatud domeenide päritoludele, seega on seda turvaline kasutada kliendipoolses koodis.

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

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

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

Teadmusbaasid

Teadmusbaas on dokumentide kogum, mida sinu häälagent saab kõne ajal oma vastuste põhjendamiseks otsida — laadi üles faile, kleebi teksti või impordi veebilehti URL-i kaudu ning seejärel seo teadmusbaas koosturis häälagendiga. Häälagent pärib seda sisseehitatud otsingutööriistaga alati, kui vestlus seda nõuab.

Töölaual: Teadmised (/dashboard/knowledge) dokumenditeegi jaoks; koosturi jaotis Teadmised, et teadmusbaas häälagendiga siduda. Vaata Anna oma häälagendile teadmusbaas.

Ühendused

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

• Rakendused (/dashboard/app-connections) — OAuth-ühendused Slacki, HubSpoti, Salesforce'i, Google Calendari, Google Sheetsi ja Cal.comiga. Loo ühendus üks kord, seejärel lülita mis tahes häälagendi jaoks sisse toimingupõhised tööriistad (saada Slacki sõnum, lisa või uuenda HubSpoti kontakt, broneeri Cal.comi aeg…). Vaata Rakenduste ühendamine.
• API-d (/dashboard/api-connections) — muuda mis tahes HTTP API häälagendi toiminguks. Kleebi cURL-käsk ning AI-viisard koostab tööriista määratluse, või loo see käsitsi; nupp Testi päringut käivitab enne avaldamist liivakastikõne. Vaata API-ühendused — töölaua vaade /v1/integrations-ile.
• MCP (/dashboard/mcp-connections) — lisa Model Context Protocoli server URL-i abil ja lase häälagendil 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 häälagente, kontrollida 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 skaalal: laadi üles kontaktide CSV-fail, vali häälagent ja helistajanumber ning määra helistamisaken (päevad ja tunnid, ajavööndit arvestades), samaaegsus ja korduskatsete poliitika (maksimaalne katsete arv ning milliseid tulemusi — vastamata kõne, kõnepost, ebaõnnestumine — proovitakse uuesti). Kampaania läbib 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 pooleli olevad kõned ja võimaldab avada ükskõik millise neist, et kuulata ja sosistada reaalajas. See on järelevalvevaade: jälgi, kuidas uus viip saab oma esimese pärisliikluse, või hoia silma peal käimasoleval kampaanial.

Juhtpaneelil: Reaalajas (/dashboard/live). Vaata Reaalajas kõnede jälgimine ja järelevalve.

Simulatsioonid

Simulatsioon on tehisintellektist helistaja, kes peab sinu agendiga päris vestlust — sama telefonitee, päris transkriptsioon, päris hindamine — et saaksid testida enne (ja pärast) avaldamist. Suuna see agendile või telefoninumbrile, kirjuta helistaja stsenaarium ise või genereeri stsenaariumid tehisintellektiga agendi viiba põhjal (soovi korral ka äärejuhtumid) ja jälgi kõnet reaalajas.

Stsenaariumid koonduvad komplektideks, mis määravad minimaalse läbimise määra ning võivad CI-s väljalaskeid piirata; kõrvalekalletest aktsepteeritud alusjoonest antakse teada iga stsenaariumi kohta eraldi.

Juhtpaneelil: Simulatsioonid (/dashboard/simulations) ning agendi koostajas olev nupp Simulatsioon. Vaata Kõne simuleerimine.

API-s: /v1/test-calls ja komplekti käivitaja — vaata Agendi täielik testimine.

Valideerimiskomplektid

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

Juhtpaneelil: Valideerimiskomplektid (/dashboard/validation) organisatsiooni andmestiku jaoks ning agendi koostaja vahekaart Valideerimine käituste jaoks. Vaata Valideerimiskomplektid.

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

Eksperimendid

Eksperiment teeb reaalajas liiklusel agendikonfiguratsioonide A/B-testi: määratle variandid (erinevad viibad, mootorid või seaded), jaga liiklus nende vahel ja võrdle tulemusi variantide kaupa. Kasuta seda veebikonksus käsitsi koostatud ämbriloogika asemel.

Juhtpaneelil: Eksperimendid (/dashboard/experiments) ja agendi koostaja vahekaart A/B. Vaata Eksperimendid (A/B-testimine).

Probleemid

Probleem on konkreetsel kõnel märgitud tõrge — selle lisab inimülevaataja või tuvastab tehisintellekti hindamine. Probleemidel on tõsidusaste, allikas ja olek ning probleemide leht on triaažijärjekord: filtreeri, uuri probleemset kõnet ja jälgi parandusi.

Juhtpaneelil: Probleemid (/dashboard/issues) ning kõnepõhine märkimine kõneajaloos. Vaata Probleemide triaaž.

API-s: /v1/issue-reports.

Aruanded

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

Juhtpaneelil: Aruanded (/dashboard/reports). Vaata Aruanded.

Jälgitavus

Jälgitavus on mõõdikute vaade: kõnede maht, tulemused ja kvaliteet aja jooksul, filtreeritav agendi ja ajavahemiku järgi ning eksporditav edasiseks analüüsiks.

Juhtpaneelil: Jälgitavus (/dashboard/observability). Vaata Jälgitavus.

Hoiatused

Hoiatusreegel 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-postile ja Slacki ning käivitavad sündmuse alert.triggered sinu veebikonksu lõpp-punktidele.

Juhtpaneelil: Organisatsioon → Hoiatused. Vaata Hoiatused.

Veebikonksud

Kui kõne ajal või pärast kõnet toimuvad sündmused, saadab ThunderPhone sinu serverisse HTTP POSTi veebikonksud. Kaks edastusmudelit:

• Veebikonksu lõpp-punktid (soovitatav): halda paljusid URL-e aadressil /v1/developer/webhook-endpoints, kasutades iga lõpp-punkti jaoks eraldi saladusi ja sündmuste tellimusi.
• Pärandatud ühe URL-iga veebikonks: ü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 käimasolevat 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 viitega uuesti — vaata edastamise semantikat.

Iga päring sisaldab HMAC-SHA256 signatuuri päises X-ThunderPhone-Signature. Vaata signatuuri 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 oma serveritest allkirjastatud HTTP-päringu ja edastab tulemuse agendile.

Agentidel on ka sisseehitatud kõnevõimalused — kõne suunamine, klahvistiku (DTMF) sisendi saatmine, kõne lõpetamine ja ootel püsimine —, mille lubad tööriistade definitsioonide asemel lihtsate viiperea ridadega.

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

API-s: /v1/integrations ja Funktsioonitööriistade spetsifikatsioon.

Meeskond ja rollid

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

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

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

Arveldamine

ThunderPhone on ettemaksepõhine. Igal organisatsioonil on USD saldo; kõned vähendavad seda agendi minutihinna võrra (mootori tase koos lisatasudega — koostaja kuvab seadete muutmisel koguhinna reaalajas ning valitud lisakeeled lisavad 3 senti/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äitmine, määrates saldo lävendi, täitmiskoguse ja valikulise igakuise kululimiidi — nii ei katke kõne kunagi poole lause pealt.

Töölaual: Organisatsioon → Arveldamise seaded ja Arveldamise ajalugu. Vaata Lisa raha ja lülita automaatne saldo täitmine sisse ning täielikku hinnakirja.

API-s: /v1/billing.

Rakendusesisene kopiloot

Töölaual on sisseehitatud kopiloot — küsi sellelt „kuidas ma X-i teen“ ja see vastab selle dokumentatsiooni põhjal, pakub samm-sammulisi juhiseid, mis tõstavad esile tegelikud juhtelemendid, ning saab korrata kõiki juhendatud ringkäike. See on kiireim viis leida siin lehel mainitud juhtelement. Vaata Küsi rakendusesiseselt kopiloodilt.

Kõik kokku