Pamatjēdzieni

Pārskats par visu platformā — ko dara katrs objekts, kur tas atrodas panelī un kura API to izmanto.

ThunderPhone ir pilna platforma AI balss aģentu izveidei, darbināšanai un uzlabošanai. Šī lapa ir karte: katram jēdzienam, ar kuru sastapsieties, ir veltīta īsa sadaļa, kā arī informācija par atbilstošo informācijas paneļa sadaļu un API. Vienreiz to pārskatiet, pēc tam atgriezieties, kad nepieciešams izskaidrot kādu terminu.

Informācijas paneļa sānjosla atspoguļo šo struktūru:

Organizācijas#

Organizācija ir nomnieka vienība. Katrs cits resurss — balss aģenti, tālruņa numuri, zvani, atslēgas — pieder tieši vienai organizācijai. Jūsu konts var piederēt daudzām organizācijām; katrai ir savs atlikums, savas atslēgas un savs dalībnieku saraksts.

sk_live_ API atslēga, ko izveidojat sadaļā Organizācija → Atslēgas, ir saistīta ar vienu organizāciju. Šī saistība padara REST API tik vienkāršu: URL ceļos nekad nenorādāt organizācijas ID, jo jūsu atslēga to jau identificē.

Informācijas panelī: organizācijas pārslēdzējs (sānjoslas apakšdaļā) un Organizācijas iestatījumi — cilnes Mans konts, Vispārīgi, Atslēgas, Brīdinājumi, Norēķinu iestatījumi un Norēķinu vēsture. Skatiet organizācijas iestatījumu atsauci.

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

Balss aģenti#

Balss aģents ir AI konfigurācija, kas apkalpo zvanu. Tā ietver:

• Uzvedni, kas nosaka, ko balss aģents saka un kā tas rīkojas — tostarp zvana darbības, piemēram, pārsūtīšanu, taustiņu nospiešanu un zvana pārtraukšanu, kas ir vienkāršas uzvednes rindas, nevis atsevišķa konfigurācija.
• Dzinēja līmeni (spark, bolt, storm-*): Spark ir optimizēts izmaksām, Bolt — ātrumam, Storm — sarežģītu uzvedņu izpratnei.
• Balsi, kā arī primāro valodu un izvēles papildu valodas — balss aģents automātiski pārslēdzas, kad zvanītājs maina valodu. Skatiet atbalstītās valodas.
• Piesaistītās iespējas: pievienotās lietotnes, API savienojumi, zināšanu bāzes, MCP serveri un iekļautie funkciju rīki.
• Darbības iestatījumi: runas secība, apstiprinājuma režīms, fona celiņš, aizturēšanas noildze.

Izmaiņas veidotājā tiek automātiski saglabātas kā melnraksts; nekas netiek publicēts, līdz noklikšķināt uz Izvietot. Katra izvietošana tiek saglabāta veidotāja cilnē Vēsture, lai varētu pārskatīt un atjaunot jebkuru iepriekšējo versiju.

Informācijas panelī: Balss aģenti → balss aģenta veidotājs (/dashboard/agents). Skatiet izveidojiet savu pirmo balss aģentu.

API: /v1/agents — CRUD, dublēšana, pārsūtīšana, versiju vēsture un uzvedņu palīgrīki.

Balsis#

Balss bibliotēkā ir balsis, ko var izmantot balss aģents, to atskaņojamie paraugi, saderīgās valodas, dzimuma un akcenta grupējumi, kā arī jebkura piemaksa par premium balsi vai valodu. Maksas paraugu ģenerators var sintezēt jūsu izvēlētu 1–500 rakstzīmju frāzi, pirms veicat izvēli.

Atbilstošas organizācijas var arī izveidot pielāgotas balsis no īsa WAV vai MP3 parauga. Pielāgotām balsīm ir kvota un asinhrons izveides statuss; kad tās ir gatavas, tās tiek parādītas tajā pašā aģenta atlasītājā kā bibliotēkas balsis.

Vadības panelī: Balsis (/dashboard/voices). Skatiet Balss bibliotēka un pielāgotās balsis.

API: /v1/voices, balss paraugi un pielāgotās balsis.

Tālruņa numuri#

Tālruņa numurs pieder organizācijai un novirza ienākošos zvanus uz aģentu (un var nodrošināt izejošos zvanus). Ir divi avoti:

• ThunderPhone numuri — īsti ASV numuri, kas nodrošināti no ThunderPhone numuru kopuma un ir aktīvi dažu sekunžu laikā, $1/mēnesī plus 1 ¢/minūtē piemaksa. Sākotnēji tie paredzēti tikai ienākošajiem zvaniem. Organizācijas administrators var pieprasīt izejošo zvanu iespēju lapā Tālruņa numuri; ThunderPhone katru pieprasījumu izskata manuāli, un apstiprinātie numuri var veikt zvanus un īstenot kampaņas. Organizācija pēc noklusējuma var turēt 25 numurus.
• VoIP numuri — pievienoti no jūsu pakalpojumu sniedzēja, izmantojot VoIP savienojumu. Twilio un Telnyx pieslēdzas tieši, izmantojot API atslēgu (Telnyx piedāvā arī vadītu jauna konta iestatīšanu); SignalWire, Vonage, Plivo un jebkurš cits SIP maģistrālais savienojums pieslēdzas, izmantojot SIP iestatīšanu — manuālu SIP konfigurāciju. Pēc importēšanas un verificēšanas VoIP numuri atbalsta ienākošos un izejošos zvanus.

Katrā numura rindā varat iestatīt maršrutēšanas režīmu, izvēlēties ienākošo zvanu aģentu un pievienot numuram etiķeti.

Vadības panelī: Tālruņa numuri (/dashboard/phone-numbers). Skatiet Iegūstiet tālruņa numuru.

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

Zvani#

Katrs ienākošais zvans, izejošais zvans, simulācija un logrīka sesija kļūst par zvanu žurnāla ierakstu. Zvanā ir pilns ar lomām marķēts atšifrējums, strukturēta sarunas gājienu vēsture (tostarp rīku izsaukumi), ieraksts, norēķinu kopsumma un izvērtēšana ar MI, kā arī problēmu ziņojumi pēc izvēles.

Kamēr zvans ir aktīvs, varat to atvērt un klausīties — jūs pievienojaties klusumā, un neviens zvana dalībnieks jūs nedzird. Kad klausāties, varat čukstēt: ierakstiet norādījumu, kas zvana laikā tiek nosūtīts tieši jūsu aģentam; zvanītājs to nekad nedzird, un aģents tam seko uzreiz.

Vadības panelī: Zvanu vēsture (/dashboard/call-history) arhīvam un detalizētai informācijai par katru zvanu; Tiešraide aktīvajiem zvaniem. Skatiet Pārskatiet, klausieties un palīdziet vadīt savus zvanus.

API: /v1/calls — saraksts, atšifrējums, vēsture, audio, vērtēšana, eksportēšana; /v1/issue-reports.

Klientu portāli#

Klientu portāls ir zīmolam pielāgots, tikai lasāms zvanu vēstures skats ārējam klientam. Organizācijas administratori izvēlas aģentus, kuru zvani tiek parādīti, pievieno apstiprinātas skatītāju e-pasta adreses, augšupielādē logotipu un akcenta krāsu, kā arī pēc izvēles verificē pielāgotu domēnu. Portāla skatītāji var pārskatīt zvanu informāciju, atšifrējumus un pieejamos ierakstus, nesaņemot piekļuvi vadības panelim.

Vadības panelī: Klientu portāli (/dashboard/client-portals). Skatiet Klientu portāli.

API: /v1/client-portals administratoru pārvaldības saskarnei.

Tīmekļa logrīki#

tīmekļa logrīks sniedz jūsu vietnes apmeklētājiem sarunu ar balss aģentu, izmantojot mikrofonu — tālruņa numurs nav nepieciešams. Tas autentificējas ar publicējamo atslēgu (pk_live_...), ko pārlūkprogrammas var izmantot tikai no jūsu atļautajiem domēniem, tāpēc to ir droši lietot klienta puses kodā. Domēnu saraksts nav autentifikācija, un sesijas iestatījumi, kurus lapa var nosūtīt, ir izslēgti, līdz tos atļaujat šai atslēgai.

Atslēgas darbojas vienā no diviem režīmiem: agent (statiski piesaistīts vienam aģentam) vai webhook (jūsu serveris katram apmeklētājam izvēlas konfigurāciju — skatiet Dinamiska konfigurācija katram zvanam). Logrīka sesijas izmanto to pašu zvanu infrastruktūru, ko tālruņa zvani.

Panelī: Tīmekļa logrīki (/dashboard/web-widgets) — izveidojiet logrīkus, iestatiet režīmu un aģentu, pārvaldiet atļautos domēnus un nokopējiet iegulšanas fragmentu. Skatiet Izveidot tīmekļa logrīku.

API: /v1/publishable-key, /v1/mic-session un logrīka SDK dokumentācija.

Zināšanu bāzes#

Zināšanu bāze ir dokumentu kopa, kurā jūsu aģents var meklēt zvana laikā, lai pamatotu savas atbildes, — augšupielādējiet failus, ielīmējiet tekstu vai importējiet tīmekļa lapas pēc URL un pēc tam pievienojiet zināšanu bāzi aģentam redaktorā. Aģents tajā meklē, izmantojot iebūvētu meklēšanas rīku, kad tas ir nepieciešams sarunā.

Panelī: Zināšanas (/dashboard/knowledge) dokumentu bibliotēkai; redaktora sadaļa Zināšanas, lai to pievienotu aģentam. Skatiet Piešķirt aģentam zināšanu bāzi.

Savienojumi#

Savienojumi ļauj aģentiem piekļūt ārējai pasaulei. Četri veidi vienā sānjoslas grupā:

• Lietotnes (/dashboard/app-connections) — OAuth savienojumi ar Slack, HubSpot, Salesforce, Google Calendar, Google Sheets un Cal.com. Savienojiet vienreiz, pēc tam jebkuram aģentam ieslēdziet rīkus atsevišķām darbībām (nosūtīt Slack ziņojumu, atjaunināt vai izveidot HubSpot kontaktpersonu, rezervēt Cal.com laiku…). Skatiet Savienot lietotnes.
• API (/dashboard/api-connections) — pārvērtiet jebkuru HTTP API par aģenta darbību. Ielīmējiet cURL komandu, un MI vednis izveidos rīka definīcijas melnrakstu, vai izveidojiet to manuāli; poga Pārbaudīt pieprasījumu veic smilškastes zvanu pirms izvietošanas. Skatiet API savienojumi — paneļa saskarni priekš /v1/integrations.
• MCP (/dashboard/mcp-connections) — pievienojiet Model Context Protocol serveri pēc URL un ļaujiet aģentam izmantot tā nodrošinātos rīkus. Skatiet Pievienot MCP serveri.
• VoIP (/dashboard/voip-connections) — pakalpojumu sniedzēja piekļuves dati savu tālruņa numuru izmantošanai. Skatiet Savienot VoIP pakalpojumu sniedzēju.

ThunderPhone nodrošina arī savu MCP galapunktu, lai ārējs MCP klients varētu uzskaitīt aģentus, pārbaudīt zvanus un transkriptus, kā arī veikt zvanus. Skatiet Izmantot ThunderPhone kā MCP serveri.

API: /v1/integrations, /v1/mcp-servers un /v1/voip-connections; skatiet arī Izveidot rīka integrāciju.

Kampaņas#

Kampaņa veic izejošos zvanus lielā apjomā: augšupielādējiet kontaktpersonu CSV failu, izvēlieties aģentu un numuru, no kura zvanīt, un iestatiet zvanu laiku (dienas un stundas, ņemot vērā laika joslu), paralēlo zvanu skaitu un atkārtoto mēģinājumu politiku (maksimālais mēģinājumu skaits un kuri rezultāti — neatbildēts zvans, balss pasts, neveiksmīgs zvans — tiek mēģināti atkārtoti). Kampaņa apstrādā sarakstu un reģistrē katru zvanu zvanu vēsturē.

Panelī: Kampaņas (/dashboard/campaigns). Skatiet Veikt izejošo zvanu kampaņu.

Vienreizējiem programmatiskiem zvaniem: izejošo zvanu API.

Tiešraides uzraudzība#

Tiešraide parāda katru pašlaik notiekošo zvanu visā organizācijā un ļauj atvērt jebkuru no tiem, lai klausītos un čukstētu reāllaikā. Tā ir uzraudzības saskarne: vērojiet, kā jauna uzvedne saņem pirmo reālo datplūsmu, vai sekojiet aktīvai kampaņai.

Informācijas panelī: Tiešraide (/dashboard/live). Skatiet Skatīt un uzraudzīt tiešraides zvanus.

Simulācijas#

Simulācija ir AI zvanītājs, kas risina reālu sarunu ar jūsu aģentu — tas pats telefonijas ceļš, reāls transkripts, reāla vērtēšana — lai jūs varētu testēt pirms un pēc izvietošanas. Norādiet balss aģentu vai tālruņa numuru, pats uzrakstiet zvanītāja scenāriju vai ģenerējiet scenārijus ar AI no aģenta uzvednes (tostarp robežgadījumus, ja tos pieprasāt), un vērojiet zvanu tiešraidē.

Scenāriji tiek grupēti komplektos, kas nosaka minimālo sekmības rādītāju un var bloķēt laidienus CI; regresijas pret apstiprināto bāzlīniju tiek ziņotas katram scenārijam.

Informācijas panelī: Simulācijas (/dashboard/simulations), kā arī poga Simulācija balss aģenta veidotājā. Skatiet Simulēt zvanu.

API: /v1/test-calls un komplektu palaidējs — skatiet Testēt balss aģentu no sākuma līdz beigām.

Validācijas kopas#

Validācijas kopa pārvērš reālu zvanu brīžus atkārtojamos viena gājiena regresijas pārbaudījumos. Katrs piemērs fiksē sarunas kontekstu, atbilstošo zvanītāja audio, sākotnējo atbildi un sagaidāmo darbību. Atkārtotas izpildes notiek pret pašreizējo balss aģenta melnrakstu, neveicot vēl vienu zvanu, un izvietošanas dialoglodziņš var parādīt, vai jaunākais izpildes rezultāts joprojām atbilst šim melnrakstam.

Informācijas panelī: Validācijas kopas (/dashboard/validation) organizācijas datu kopai un balss aģenta veidotāja cilne Validācija izpildēm. Skatiet Validācijas kopas.

API: /v1/validation-sets un balss aģenta/piemēra atkārtotas izpildes galapunkti tajā pašā atsauces lapā.

Eksperimenti#

Eksperiments veic balss aģenta konfigurāciju A/B testēšanu reālajā datplūsmā: definējiet variantus (dažādas uzvednes, dzinējus vai iestatījumus), sadaliet datplūsmu starp tiem un salīdziniet rezultātus katram variantam. Izmantojiet to, nevis manuāli veidojiet segmentu loģiku tīmekļa aizķerē.

Informācijas panelī: Eksperimenti (/dashboard/experiments) un cilne A/B balss aģenta veidotājā. Skatiet Eksperimenti (A/B testēšana).

Problēmas#

Problēma ir atzīmēta kļūda konkrētā zvanā — to iesniedzis cilvēks, kas veic pārskatīšanu, vai noteikusi AI vērtēšana. Problēmām ir nopietnības līmenis, avots un statuss, un lapa Problēmas ir šķirošanas rinda: filtrējiet, pārbaudiet problemātisko zvanu un sekojiet labojumiem.

Informācijas panelī: Problēmas (/dashboard/issues), kā arī atzīmēšana katram zvanam zvanu vēsturē. Skatiet Problēmu šķirošana.

API: /v1/issue-reports.

Pārskati#

Pārskats atbild uz dabiskās valodas jautājumu par jūsu zvanu datiem ("Kādi bija trīs galvenie iemesli, kāpēc zvanītāji pagājušajā nedēļā lūdza cilvēku?") ar AI sagatavotu analīzi, kas ierobežota ar jūsu izvēlētajiem balss aģentiem un datumu diapazonu.

Informācijas panelī: Pārskati (/dashboard/reports). Skatiet Pārskati.

Novērojamība#

Novērojamība ir metrikas saskarne: zvanu apjoms, rezultāti un kvalitāte laika gaitā, filtrējama pēc balss aģenta un laika loga, ar eksportēšanu turpmākai analīzei.

Informācijas panelī: Novērojamība (/dashboard/observability). Skatiet Novērojamība.

Brīdinājumi#

Brīdinājuma kārtula uzrauga metriku (sekmības rādītāju, kļūmju rādītāju, vidējo vērtējumu, zvanu apjomu, komplektu regresijas) noteiktā laika logā un aktivizējas, kad tā pārsniedz jūsu slieksni. Paziņojumi tiek nosūtīti uz e-pastu un Slack, kā arī aktivizē alert.triggered notikumu jūsu tīmekļa aizķeres galapunktos.

Informācijas panelī: Organizācija → Brīdinājumi. Skatiet Brīdinājumi.

Tīmekļa aizķeres#

ThunderPhone nosūta HTTP POST tīmekļa aizķeres uz jūsu serveri, kad zvana laikā un pēc tā kaut kas notiek. Divi piegādes modeļi:

• Tīmekļa aizķeru galapunkti (ieteicams): pārvaldiet vairākus URL vietnē /v1/developer/webhook-endpoints, izmantojot katram galapunktam atsevišķus noslēpumus un notikumu abonementus.
• Mantotā viena URL tīmekļa aizķere: viens URL katrai organizācijai. Pārvalda vietnē /v1/webhook vai sadaļā Organizācija → Vispārīgi. Saglabāta atpakaļsaderībai.

Notikumi ir iedalīti divās klasēs:

• Bloķējošie notikumi paredz, ka jūsu serveris atbildēs ar konfigurāciju, kas ietekmē notiekošo zvanu — tie ir ienākošo zvanu notikumi (telephony.incoming / web.incoming). Tālruņa zvans gaida līdz 13 sekundēm, ieskaitot vienu atkārtotu mēģinājumu, bet logrīka sesija — 10 sekundes. Nav rezerves balss aģenta: bez izmantojamas konfigurācijas tālruņa zvans tiek pārtraukts, un logrīka sesija neizdodas.
• Nebloķējošie notikumi ir nosūti un aizmirsti paziņojumi, kas tiek atkārtoti ar eksponenciāli pieaugošu intervālu — skatiet piegādes semantiku.

Katram pieprasījumam ir laika zīmoga HMAC-SHA256 paraksts laukā X-ThunderPhone-Signature-V2, kā arī mantotais tikai pamatteksta X-ThunderPhone-Signature. Skatiet paraksta pārbaudi.

Funkciju rīki#

Funkciju rīks ir HTTP galapunkts, ko jūsu balss aģents var izsaukt sarunas laikā. Jūs sniedzat ThunderPhone OpenAI stila funkcijas shēmu un galapunkta URL; balss aģents izlemj, kad to izsaukt, un ThunderPhone nosūta parakstīto HTTP pieprasījumu no saviem serveriem un nodod rezultātu atpakaļ balss aģentam.

Balss aģentiem ir arī iebūvētas zvanu iespējas — zvana pārsūtīšana, tastatūras (DTMF) ievades sūtīšana, zvana beigšana, gaidīšana aizturēšanas režīmā — kuras iespējojat ar vienkāršām uzvednes rindām, nevis rīku definīcijām.

Informācijas panelī: veidotāja sadaļa API savienojumi (skatiet Savienojumi).

API: /v1/integrations un Funkciju rīku specifikācija.

Komanda un lomas#

Katrā organizācijā ir dalībnieku saraksts ar divām lomām: Dalībnieki veido un pārvalda balss aģentus; Administratori pārvalda arī komandu un norēķinus. Uzaiciniet pa e-pastu — uzaicinājumu derīguma termiņš beidzas pēc 7 dienām, un tos var atsaukt; izvēlne ⋯ dalībnieka rindā maina lomas vai noņem personu. Vienoto pierakstīšanos var konfigurēt visai organizācijai — skatiet SSO.

Informācijas panelī: Organizācija → Vispārīgi. Skatiet Uzaiciniet savu komandu.

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

Norēķini#

ThunderPhone ir priekšapmaksas pakalpojums. Katrā organizācijā ir USD atlikums; zvani to samazina atbilstoši balss aģenta minūtes likmei (dzinēja līmenis un piemaksas — veidotājs, mainot iestatījumus, reāllaikā rāda pilno likmi, un atsevišķas papildu valodas pievieno 3¢/min). Kad atlikums sasniedz nulli, ienākošie zvani tiek noraidīti, bet izejošie zvani atgriež 402 Payment Required.

Papildiniet atlikumu manuāli vai iespējojiet automātisko papildināšanu ar atlikuma slieksni, papildināšanas summu un izvēles mēneša izdevumu limitu — lai zvans nekad nepārtrūktu teikuma vidū.

Informācijas panelī: Organizācija → Norēķinu iestatījumi un Norēķinu vēsture. Skatiet Pievienojiet līdzekļus un ieslēdziet automātisko papildināšanu, kā arī pilno cenu atsauci.

API: /v1/billing.

Lietotnē iebūvētais kopilots#

Informācijas panelī ir iebūvēts kopilots — pajautājiet tam: “kā veikt X”, un tas atbildēs, izmantojot šo dokumentāciju, piedāvās soli pa solim norādes, kas izceļ faktiskās vadīklas, un var atkārtoti palaist jebkuru no Vadītajiem ceļvežiem. Tas ir ātrākais veids, kā atrast šajā lapā minētu vadīklu. Skatiet Jautājiet lietotnē iebūvētajam kopilotam.

Apkopojot visu#