Pamatjēdzieni

ThunderPhone ir pilnvērtīga platforma MI balss aģentu veidošanai, darbībai un uzlabošanai. Šī lapa ir karte: katram jēdzienam, ar kuru sastapsieties, ir veltīta viena īsa sadaļa ar informācijas paneļa saskarni un to nodrošinošo API. Ātri pārskatiet to vienreiz un 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 — aģenti, tālruņa numuri, zvani, atslēgas — pieder tieši vienai organizācijai. Jūsu konts var piederēt vairākām organizācijām; katrai ir savs atlikums, savas atslēgas un savs dalībnieku saraksts. API atslēga sk_live_, 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 nav jānorāda organizācijas ID, jo jūsu atslēga to jau identificē. Informācijas panelī: organizācijas pārslēdzējs (sānjoslas kājenē) un Organizācijas iestatījumi — cilnes Vispārīgi, Atslēgas, Brīdinājumi, Norēķinu iestatījumi un Norēķinu vēsture. API: /v1/orgs, /v1/developer/api-keys.

---

​

Aģenti

Aģents ir MI konfigurācija, kas apkalpo zvanu. Tajā ir apvienots:

• Uzvedne, kas nosaka, ko aģents saka un kā tas rīkojas — tostarp zvana darbības, piemēram, pārsūtīšana, taustiņu nospiešana un zvana beigšana, kas ir parastas uzvednes rindas, nevis atsevišķa konfigurācija.
• Dzinēja līmenis (spark, bolt, storm-*): Spark ir optimizēts izmaksām, Bolt — ātrumam, Storm — intelektam darbā ar sarežģītām uzvednēm.
• Balss, kā arī primārā valoda un izvēles papildu valodas — aģents automātiski pārslēdzas, kad zvanītājs maina valodu. Skatiet Atbalstītās valodas.
• Pievienotās iespējas: savienotās lietotnes, API savienojumi, zināšanu bāzes, MCP serveri un iekļautie funkciju rīki.
• Darbības iestatījumi: runāšanas secība, apstiprināšanas režīms, fona celiņš, gaidīšanas noildze.

Rediģējumi veidotājā tiek automātiski saglabāti melnrakstā; nekas netiek publicēts, līdz nenoklikšķināt uz Izvietot. Katrs izvietojums tiek saglabāts veidotāja cilnē Vēsture, lai varētu pārbaudīt un atjaunot jebkuru iepriekšējo versiju. Informācijas panelī: Balss aģenti → 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.

---

​

Tālruņa numuri

Tālruņa numurs pieder organizācijai un novirza ienākošos zvanus uz balss aģentu (un var tikt izmantots izejošajiem zvaniem). Divi avoti:

• Demonstrācijas numuri — īsti ASV numuri, kas tiek nodrošināti no ThunderPhone kopas un ir aktīvi dažu sekunžu laikā. Tikai ienākošajiem zvaniem — tie atbild ar īsu mutisku atrunu, un informācijas panelis vienai organizācijai ļauj izmantot ne vairāk kā 10 šādus numurus. Lieliski pirmajam testam; ne produkcijas videi.
• VoIP numuri — tiek pievienoti no jūsu pakalpojumu sniedzēja, izmantojot VoIP savienojumu. Twilio un Telnyx tiek savienoti tieši (Telnyx piedāvā vadītu iestatīšanu); SignalWire un Vonage būs pieejami drīzumā — pašlaik tos var izmantot, veicot manuālu SIP konfigurāciju, kas pieņem jebkuru SIP maģistrāli. Pēc importēšanas un verificēšanas VoIP numuri atbalsta ienākošos un izejošos zvanus.

Katra numura rinda ļauj iestatīt maršrutēšanas režīmu, izvēlēties ienākošo zvanu balss aģentu un pievienot numuram etiķeti. Informācijas panelī: Tālruņa numuri (/dashboard/phone-numbers). Skatiet Tālruņa numura iegūšana. 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ālu. Zvanā tiek saglabāta pilna transkripcija ar lomu atzīmēm, strukturēta sarunas gaitu vēsture (tostarp rīku izsaukumi), ieraksts, kopējā maksa un neobligāts MI novērtējums un problēmu ziņojumi. Kamēr zvans ir aktīvs, varat to atvērt un klausīties sarunu — jūs pievienojaties klusumā, un neviens sarunas 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 balss aģentam; zvanītājs to nekad nedzird, un balss aģents to izpilda uzreiz. Informācijas panelī: Zvanu vēsture (/dashboard/call-history) — arhīvam un detalizētai informācijai par katru zvanu; Tiešraide — zvaniem, kas pašlaik notiek. Skatiet Pārskatiet, klausieties un vadiet savus zvanus. API: /v1/calls — saraksts, transkripcija, vēsture, audio, novērtēšana, eksportēšana; /v1/issue-reports.

---

​

Tīmekļa logrīki

Tīmekļa logrīks nodrošina 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ējamu atslēgu (pk_live_...), kas ir piesaistīta jūsu atļauto domēnu izcelsmei, tāpēc to var droši izmantot klienta puses kodā. Atslēgas darbojas vienā no diviem režīmiem: agent (statiski piesaistīts vienam balss aģentam) vai webhook (jūsu serveris katram apmeklētājam izvēlas konfigurāciju — skatiet Dinamiska konfigurācija katram zvanam). Logrīku sesijās tiek izmantota tā pati zvanu infrastruktūra kā tālruņa zvaniem. Informācijas panelī: Tīmekļa logrīki (/dashboard/web-widgets) — izveidojiet logrīkus, iestatiet režīmu un balss aģentu, pārvaldiet atļautos domēnus un kopējiet iegulšanas fragmentu. Skatiet Tīmekļa logrīka izveide. 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 balss aģents var meklēt zvana laikā, lai pamatotu savas atbildes — augšupielādējiet failus tieši vai importējiet tos no Google Drive, pēc tam veidotājā pievienojiet zināšanu bāzi balss aģentam. Balss aģents veic vaicājumus tajā ar iebūvētu meklēšanas rīku, kad tas ir nepieciešams sarunai. Informācijas panelī: Zināšanas (/dashboard/knowledge) — dokumentu bibliotēkai; veidotāja sadaļa Zināšanas, lai pievienotu to balss aģentam. Skatiet Piešķiriet savam balss aģentam zināšanu bāzi.

---

​

Savienojumi

Savienojumi ļauj balss aģentiem sasniegt ārējo pasauli. Četri veidi, viena sānjoslas grupa:

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

API: /v1/integrations 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 kontaktu CSV failu, izvēlieties balss aģentu un izejošo numuru, kā arī iestatiet zvanīšanas logu (dienas un stundas, ņemot vērā laika joslu), vienlaicīgo zvanu skaitu un atkārtoto mēģinājumu politiku (maksimālo mēģinājumu skaitu un kuriem rezultātiem — neatbildēja, balss pasts, neizdevās — tiek veikti atkārtoti mēģinājumi). Kampaņa apstrādā sarakstu un reģistrē katru zvanu Zvanu vēsturē. Informācijas panelī: Kampaņas (/dashboard/campaigns). Skatiet Veikt izejošo zvanu kampaņu. Atsevišķiem programmatiskiem zvaniem: izmantojiet izejošo zvanu API.

---

​

Tiešraides uzraudzība

Tiešraide rāda katru organizācijā notiekošo zvanu un ļauj jums atvērt jebkuru no tiem, lai klausītos un sniegtu norādes reāllaikā. Tā ir uzraudzības vide: vērojiet, kā jauna uzvedne saņem pirmo reālo datplūsmu, vai pārraugiet aktīvu kampaņu. Informācijas panelī: Tiešraide (/dashboard/live). Skatiet Skatīt un uzraudzīt tiešraides zvanus.

---

​

Simulācijas

Simulācija ir MI zvanītājs, kas veido reālu sarunu ar jūsu balss aģentu — tas pats telefonijas ceļš, reāls transkripts, reāla novē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, paši uzrakstiet zvanītāja scenāriju vai ģenerējiet scenārijus ar MI no balss aģenta uzvednes (tostarp robežgadījumus, ja tos pieprasāt), un vērojiet zvanu tiešraidē. Scenāriji tiek grupēti komplektos, kuros tiek fiksēts minimālais sekmju rādītājs un kuri var bloķēt laidienus CI vidē; regresijas attiecībā 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 izpildītājs — skatiet Testēt balss aģentu no sākuma līdz beigām.

---

​

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 problēma konkrētā zvanā — to reģistrē cilvēks, kas veic pārskatīšanu, vai tā tiek noteikta ar AI vērtējumu. Problēmām ir smaguma pakāpe, avots un statuss, un lapa Problēmas ir prioritāšu izvērtēšanas rinda: filtrējiet, pārbaudiet problemātisko zvanu un sekojiet labojumiem. Panelī: Problēmas (/dashboard/issues), kā arī atzīmēšana katram zvanam zvanu vēsturē. Skatiet Problēmu izvērtēšana. API: /v1/issue-reports.

---

​

Pārskati

Pārskats sniedz atbildi uz dabiskās valodas jautājumu par jūsu zvanu datiem (“Kādi bija trīs galvenie iemesli, kādēļ zvanītāji pagājušajā nedēļā lūdza cilvēka palīdzību?”) ar AI izveidotu analīzi, kas attiecas uz jūsu izvēlētajiem balss aģentiem un datumu diapazonu. Panelī: Pārskati (/dashboard/reports). Skatiet Pārskati.

---

​

Novērojamība

Novērojamība ir metrikas skats: zvanu apjoms, rezultāti un kvalitāte laika gaitā, filtrējama pēc balss aģenta un laika perioda, ar eksportēšanu turpmākai analīzei. Panelī: Novērojamība (/dashboard/observability). Skatiet Novērojamība.

---

​

Brīdinājumi

Brīdinājuma kārtula uzrauga metriku (veiksmju rādītāju, kļūmju rādītāju, vidējo vērtējumu, zvanu apjomu, komplektu regresijas) noteiktā laika periodā un aktivizējas, kad tā pārsniedz jūsu slieksni. Paziņojumi tiek sūtīti uz e-pastu un Slack, kā arī tiek izraisīts alert.triggered notikums jūsu tīmekļa aizķeres galapunktos. 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ā notiek darbības. Divi piegādes modeļi:

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

Notikumi ir sadalī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). Jums ir līdz 10 sekundēm, lai atbildētu; noildzes gadījumā zvanu apstrādā statiski piešķirtais balss aģents.
• Nebloķējošie notikumi ir nosūtīšanas un aizmiršanas paziņojumi, kas tiek atkārtoti ar eksponenciāli pieaugošu aizkavi — skatiet piegādes semantiku.

Katram pieprasījumam ir HMAC-SHA256 paraksts laukā X-ThunderPhone-Signature. Skatiet Paraksta verifikācija.

---

​

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 nosaka, kad to izsaukt, un ThunderPhone no saviem serveriem nosūta parakstītu HTTP pieprasījumu 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ēšanā — kuras iespējojat ar parastām uzvednes rindām, nevis rīku definīcijām. Panelī: veidotāja sadaļa API savienojumi (skatiet Savienojumi). API: /v1/integrations un Funkciju rīku specifikācija.

---

​

Komanda un lomas

Katrai organizācijai ir dalībnieku saraksts ar divām lomām: Dalībnieki izveido un pārvalda balss aģentus; Administratori pārvalda arī komandu un norēķinus. Uzaiciniet pa e-pastu — uzaicinājumu derīgums beidzas pēc 7 dienām, un tos var atsaukt; izvēlne ⋯ dalībnieka rindā maina lomas vai noņem personu. Vienoto pieteikšanos var konfigurēt visai organizācijai — skatiet SSO. Panelī: Organizācija → Vispārīgi. Skatiet Uzaiciniet savu komandu. API: /v1/members, /v1/invites.

---

​

Norēķini

ThunderPhone ir priekšapmaksas pakalpojums. Katrai organizācijai 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ā parāda kopējo likmi, un augstākās klases valodas pievieno 2¢/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, norādot atlikuma slieksni, papildināšanas summu un izvēles mēneša tēriņu limitu — lai zvans nekad nepārtrūktu teikuma vidū. Vadības panelī: Organizācija → Norēķinu iestatījumi un Norēķinu vēsture. Skatiet Pievienojiet līdzekļus un ieslēdziet automātisko papildināšanu. API: /v1/billing.

---

​

Lietotnē iebūvētais palīgs

Vadības panelī ir iebūvēts palīgs — pajautājiet tam: “kā veikt X”, un tas atbildēs, izmantojot šo dokumentāciju, piedāvās detalizētus norādījumus pa klikšķiem, 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 vadīklu, kas minēta šajā lapā. Skatiet Jautājiet lietotnē iebūvētajam palīgam.

---

​

Apkopojot