Põhimõisted

Ülevaade kõigest platvormil — mida iga objekt teeb, kus see juhtpaneelil asub ja milline API seda kasutab.

ThunderPhone on terviklik platvorm tehisintellekti 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 töölaua vaate ja seda toetava API-ga. Sirvi see üks kord läbi ja tule tagasi, kui mõni termin vajab selgitamist.

Töölaua külgriba järgib sama struktuuri:

Organisatsioonid#

Organisatsioon on mitmerentniku süsteemi ü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. Just see seos teeb REST API nii lihtsaks: organisatsiooni ID-d ei ole kunagi vaja URL-i teele lisada, sest sinu võti juba tuvastab selle.

Töölaual: organisatsioonivahetaja (külgriba jaluses) ja Organisatsiooni seaded — vahekaardid Minu konto, Üldine, Võtmed, Teavitused, Arveldusseaded ja Arveldusajalugu. Vaata organisatsiooni seadete viidet.

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

Agendid#

Agent on kõnet käitav tehisintellekti konfiguratsioon. See koondab:

• Viipa, mis määrab, mida agent ütleb ja kuidas see käitub — sealhulgas kõnetoimingud, nagu suunamised, klahvivajutused ja kõne lõpetamised, mis on eraldi konfiguratsiooni asemel tavalised viibaread.
• Mootoritaseme (spark, bolt, storm-*): Spark on optimeeritud kulude jaoks, Bolt kiiruse jaoks ja Storm keerukate viipade puhul intelligentsuse jaoks.
• Hääle koos põhikeele ja valikuliste lisakeeltega — agent vahetab automaatselt keelt, kui helistaja keelt vahetab. Vaata toetatud keeled.
• Lisatud võimalused: ühendatud rakendused, API-ühendused, teadmistebaasid, MCP-serverid ja tekstisisesed funktsioonitööriistad.
• Käitumisseaded: rääkimise järjekord, kinnitamisrežiim, taustaheliriba, ooteaja piirang.

Muudatused koosturis salvestatakse automaatselt mustandisse; miski ei lähe kasutusele enne, kui klõpsad Juuruta. Iga juurutus salvestatakse koosturi Ajalugu vahekaardile, et saaksid vaadata ja taastada mis tahes varasemat versiooni.

Töölaual: Häälagendid → agendi koostur (/dashboard/agents). Vaata loo oma esimene häälagent.

API-s: /v1/agents — CRUD, dubleerimine, suunamine, versiooniajalugu ja viibaabilised.

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ääle või -keele lisatasusid. Tasuline proovifunktsioon saab enne valiku tegemist sünteesida sinu enda 1–500 tähemärgi pikkuse fraasi.

Sobivad 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 samas agendi valijas nagu teegi hääled.

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

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

Telefoninumbrid#

Telefoninumber kuulub organisatsioonile ja suunab sissetulevad kõned agendile (ning saab kasutada väljaminevateks kõnedeks). Kaks allikat:

• ThunderPhone'i numbrid — päris USA numbrid, mis on ThunderPhone'i numbripargist kasutusele võetud ja aktiivsed sekunditega, $1/kuus, millele lisandub 1¢/minutis lisatasu. Need on alguses ainult sissetulevate kõnede jaoks. Organisatsiooni administraator saab lehel Phone Numbers taotleda väljaminevate kõnede võimalust; ThunderPhone vaatab iga taotluse käsitsi läbi ning heakskiidetud numbrid saavad helistada ja kampaaniaid käitada. Organisatsioonil võib vaikimisi olla kuni 25 numbrit.
• VoIP-numbrid — toodud sinu enda teenusepakkujalt VoIP-ühenduse kaudu. Twilio ja Telnyx ühenduvad otse API-võtmega (Telnyxil on ka juhendatud uue konto seadistamine); SignalWire, Vonage, Plivo ja kõik muud SIP-trunkid ühenduvad SIP-i seadistuse kaudu, mis on käsitsi tehtav SIP-konfiguratsioon. Pärast importimist ja kinnitamist toetavad VoIP-numbrid nii sissetulevaid kui ka väljaminevaid kõnesid.

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

Töölaual: Telefoninumbrid (/dashboard/phone-numbers). Vaata Hangi telefoninumber.

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

Kõned#

Igast sissetulevast kõnest, väljaminevast kõnest, simulatsioonist ja vidina seansist saab kõnelogi. Kõne sisaldab täielikku rollisiltidega transkripti, struktureeritud käiguajalugu (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. Pärast pealtkuulamise alustamist saad sosistada: kirjuta juhis, mis saadetakse otse sinu agendile keset kõnet; helistaja ei kuule seda kunagi ja agent järgib seda reaalajas.

Töölaual: Kõneajalugu (/dashboard/call-history) arhiivi ja kõne üksikasjade jaoks; Reaalajas pooleliolevate kõnede jaoks. Vaata Vaata üle, kuula ja juhenda oma kõnesid.

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

Kliendiportaalid#

Kliendiportaal on välise kliendi jaoks mõeldud kaubamärgistatud kirjutuskaitstud kõneajaloo vaade. Organisatsiooni administraatorid valivad agendid, kelle kõnesid kuvatakse, lisavad heaks kiidetud vaatajate e-posti aadressid, laadivad üles logo ja rõhuvärvi ning saavad soovi korral kinnitada kohandatud domeeni. Portaali vaatajad saavad vaadata kõnede üksikasju, transkripte ja saadaolevaid salvestisi ilma töölauale juurdepääsu saamata.

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

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

Veebividinad#

Veebividin pakub sinu saidi külastajatele mikrofonipõhist vestlust häälagendiga — telefoninumbrit pole vaja. See autentib end avaliku võtmega (pk_live_...), mida brauserid saavad kasutada ainult sinu lubatud domeenidelt, mistõttu on seda turvaline kasutada kliendipoolses koodis. Domeenide loend ei ole autentimine ning sessiooni seaded, mida leht võib saata, on välja lülitatud, kuni lubad need võtmel.

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. Vt 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 oma vastuste põhjendamiseks otsida — laadi üles faile, kleebi teksti või impordi veebilehti URL-i kaudu ning seejärel seo teadmistebaas koosturis agendiga. Agent pärib seda sisseehitatud otsingutööriistaga alati, kui vestlus seda nõuab.

Töölaual: Teadmised (/dashboard/knowledge) dokumentide teegi jaoks; koosturi jaotis Teadmised, et siduda teadmistebaas agendiga. Vt Lisa oma agendile teadmistebaas.

Ühendused#

Ühenduste kaudu pääsevad agendid välismaailma juurde. 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. Ühenda üks kord, seejärel lülita toimingupõhised tööriistad (saada Slacki sõnum, lisa või uuenda HubSpoti kontakt, broneeri Cal.comi aeg…) sisse mis tahes agendi jaoks. Vt Rakenduste ühendamine.
• API-d (/dashboard/api-connections) — muuda mis tahes HTTP API agendi toiminguks. Kleebi cURL-käsk ning AI-abiline koostab tööriista definitsiooni mustandi või loo see käsitsi; nupp Testpäring teeb enne kasutuselevõttu liivakastikõne. Vt API-ühendused — töölauavaade /v1/integrations jaoks.
• MCP (/dashboard/mcp-connections) — lisa Model Context Protocoli server URL-i järgi ja lase agendil kasutada selle pakutavaid tööriistu. Vt MCP-serveri lisamine.
• VoIP (/dashboard/voip-connections) — teenusepakkuja mandaadid oma telefoninumbrite kasutamiseks. Vt VoIP-teenusepakkuja ühendamine.

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

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

Kampaaniad#

Kampaania teeb väljaminevaid kõnesid suurel mahul: laadi üles kontaktide CSV-fail, vali agent ja lähteenumber ning määra kõneaken (päevad ja kellaajad, ajavööndit arvestades), paralleelsus ja korduskatsete poliitika (katsete maksimaalne arv ning milliseid tulemusi — vastamata kõne, kõnepost, ebaõnnestumine — proovitakse uuesti). Kampaania läbib nimekirja ning salvestab iga kõne kõneajalukku.

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

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

Reaalajas jälgimine#

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

Töölaual: Reaalajas (/dashboard/live). Vaata Reaalajas kõnede jälgimine ja haldamine.

Simulatsioonid#

Simulatsioon on tehisintellektiga helistaja, kes peab sinu häälagendiga päris vestlust — sama telefonitee, päris transkript, 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 viibast (ka erijuhud, kui neid küsid), ning jälgi kõnet reaalajas.

Stsenaariumid rühmituvad komplektideks, mis määravad minimaalse läbimise määra ja võivad CI-s väljalaseid piirata; aktsepteeritud baasjoonest kõrvalekalded raporteeritakse stsenaariumi kaupa.

Töölaual: Simulatsioonid (/dashboard/simulations) ning agendi koostaja nupp Simulatsioon. Vaata Kõne simuleerimine.

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

Valideerimiskogumid#

Valideerimiskogum 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 agendi praeguse mustandi vastu ilma uut kõnet tegemata ning avaldamise dialoog saab näidata, kas uusim käitus vastab endiselt sellele mustandile.

Töölaual: Valideerimiskogumid (/dashboard/validation) organisatsiooni andmestiku jaoks ja agendi koostaja vahekaart Valideerimine käituste jaoks. Vaata Valideerimiskogumid.

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

Katsed#

Katse teeb agendi konfiguratsioonidele A/B-teste päris liikluses: määratle variandid (erinevad viibad, mootorid või sätted), jaga liiklus nende vahel ja võrdle tulemusi variandi kaupa. Kasuta seda veebikonksus käsitsi segmendiloogika loomise asemel.

Töölaual: Katsed (/dashboard/experiments) ja agendi koostaja vahekaart A/B. Vaata Katsed (A/B-testimine).

Probleemid#

Probleem on märgitud mure konkreetse kõnega — selle on esitanud inimene ülevaatajana või tuvastanud tehisintellekti hindamine. Probleemidel on raskusaste, allikas ja olek ning probleemide leht on triaažijärjekord: filtreeri, uuri probleemset kõnet ja jälgi parandusi.

Töölaual: 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 ("Mis olid eelmisel nädalal kolm peamist põhjust, miks helistajad palusid inimest?") tehisintellekti kirjutatud analüüsiga, mis on piiratud sinu valitud agentide 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 agendi ja ajavahemiku järgi ning eksporditav edasise analüüsi jaoks.

Töölaual: 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-posti ja Slacki ning käivitavad sündmuse alert.triggered sinu veebikonksu lõpp-punktidesse.

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

Veebikonksud#

ThunderPhone saadab sinu serverisse HTTP POST-veebikonksud, kui kõne ajal või pärast seda midagi toimub. Kaks edastusmudelit:

• Veebikonksu lõpp-punktid (soovitatav): halda mitut URL-i /v1/developer/webhook-endpoints kaudu, kasutades lõpp-punktipõhiseid saladusi ja sündmuste tellimusi.
• Pärand ühe URL-iga veebikonks: üks URL organisatsiooni kohta. Hallatav /v1/webhook kaudu 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). Telefonikõne ootab kuni 13 sekundit, sealhulgas üks uuesti proovimine, ja vidina seanss 10 sekundit. Varuagent puudub: kasutatava konfiguratsioonita telefonikõne lõpetatakse ja vidina seanss ebaõnnestub.
• Mitteblokeerivad sündmused on tule-ja-unusta teavitused, mida proovitakse uuesti eksponentsiaalse viitega — vaata edastamise semantikat.

Iga päring sisaldab ajatempliga HMAC-SHA256 allkirja päises X-ThunderPhone-Signature-V2 ning pärandallkirja, mis hõlmab ainult päringu keha, X-ThunderPhone-Signature. Vaata allkirja kontrollimist.

Funktsioonitööriistad#

Funktsioonitööriist on HTTP-lõpp-punkt, mida sinu agent saab vestluse ajal 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 annab tulemuse agendile tagasi.

Agentidel on ka sisseehitatud kõnevõimed — kõne edastamine, klahvistiku (DTMF) sisendi saatmine, kõne lõpetamine, ootel ootamine —, mida saad lubada lihtsate viiparidadega tööriistade definitsioonide asemel.

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 e-posti teel — kutsed aeguvad 7 päeva pärast ja neid saab tühistada; liikme rea menüü ⋯ muudab rolle või eemaldab liikme. Ühekordset sisselogimist saab konfigureerida kogu organisatsiooni jaoks — vaata SSO.

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

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

Arveldamine#

ThunderPhone on ettemaksuga. Igal organisatsioonil on USD-saldo; kõned arvatakse sellest maha agendi minutihinna alusel (mootori tase koos lisatasudega — koostaja näitab sätete muutmisel koguhinda reaalajas 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 täiendamine, määrates saldoläve, täiendussumma ja valikulise igakuise kululimiidi — et kõne ei katkeks kunagi poole lause pealt.

Töölaual: Organisatsioon → Arveldamise sätted ja Arveldusajalugu. Vaata Lisa raha ja lülita automaatne täiendamine sisse ning täielik hinnakirja viide.

API-s: /v1/billing.

Rakendusesisene kaaspiloot#

Töölaual on sisseehitatud kaaspiloot — küsi sellele „kuidas ma X-i teen“ ja see vastab nende dokumentide põhjal, pakub samm-sammulisi juhiseid, mis tõstavad esile tegelikud juhtelemendid, ning saab taasesitada mis tahes juhendatud tuuri. See on kiireim viis leida juhtelement, mida sellel lehel mainitakse. Vaata Küsi rakendusesiseselt kaaspiloodilt.

Kõik kokku#