Getting Started

Pamatjēdzieni

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

ThunderPhone ir pilna platforma balss aģentu izveidei, darbināšanai un uzlabošanai. Šī lapa ir karte: katrs jēdziens, ar kuru sastapsieties, vienā īsā sadaļā, kā arī tā informācijas paneļa virsma un API, kas to nodrošina. Ātri pārskatiet to vienreiz un atgriezieties, kad kāds termins jāizskaidro sīkāk.

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 daudzā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 piesaistīta vienai organizācijai. Šī piesaiste 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.

Aģenti#

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

• Uzvedni, kas nosaka, ko aģents saka un kā tas rīkojas — tostarp zvana darbības, piemēram, pārsūtīšanu, tastatūras taustiņu nospiešanu un zvana pārtraukšanu, kas ir parastas uzvednes rindas, nevis atsevišķa konfigurācija.
• Dzinēja līmeni (spark, bolt, storm-*): Spark ir optimizēts izmaksām, Bolt — ātrumam, Storm — intelektam, apstrādājot sarežģītas uzvednes.
• Balsi, kā arī primāro valodu un izvēles papildu valodas — aģents automātiski pārslēdzas, kad zvanītājs maina valodu. Skatiet atbalstītās valodas.
• Piesaistītās iespējas: savienotā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ņš, gaidīšanas noildze.

Labojumi veidotājā tiek automātiski saglabāti melnrakstā; nekas netiek publicēts, līdz noklikšķināt uz Izvietot. Katrs izvietojums tiek saglabāts veidotāja cilnē Vēsture, lai varētu pārskatī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.

Balsis#

Balsu bibliotēkā ir balsis, ko balss aģents var izmantot, to atskaņojamie paraugi, saderīgās valodas, dzimuma un akcenta grupējumi, kā arī jebkādas piemaksas par premium balsīm vai valodām. Par maksu varat sintezēt savu 1–500 rakstzīmju frāzi, pirms izdarāt izvēli.

Tiesīgās 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 rādītas tajā pašā balss aģentu atlasītājā kā bibliotēkas balsis.

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

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

Tālruņa numuri#

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

• Demonstrācijas numuri — īsti ASV numuri, kas tiek piešķirti no ThunderPhone kopuma un ir aktīvi dažu sekunžu laikā. Tie ir paredzēti tikai ienākošajiem zvaniem, atbild ar īsu mutisku atrunu, un vadības panelis ierobežo organizāciju līdz 10 šādiem numuriem. Lieliski pirmajam testam, bet ne produkcijas videi.
• VoIP numuri — tiek pievienoti no jūsu pakalpojumu sniedzēja, izmantojot VoIP savienojumu. Twilio un Telnyx savienojas tieši (Telnyx piedāvā vadītu iestatīšanu); SignalWire un Vonage drīzumā būs pieejami — pašlaik tos var sasniegt, izmantojot manuālu SIP konfigurāciju, kas pieņem jebkuru SIP maģistrāli. Kad VoIP numuri ir importēti un verificēti, tie 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 balss aģentu un pievienot numuram etiķeti.

Vadības panelī: Tālruņa numuri (/dashboard/phone-numbers). Skatiet Iegūt 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 zvana žurnālu. Zvanā tiek saglabāts pilns stenogrammas teksts ar lomu atzīmēm, strukturēta sarunas gaitu vēsture (tostarp rīku izsaukumi), ieraksts, norēķinu kopsumma un izvēles MI vērtējums un problēmu pārskati.

Kamēr zvans ir tiešsaistē, varat to atvērt un klausīties sarunā — jūs pievienojaties klusējot, un neviens sarunas dalībnieks jūs nedzird. Kad klausāties, varat čukstēt: ierakstiet norādījumu, kas zvana laikā nonāk tieši pie jūsu balss aģenta; zvanītājs to nekad nedzird, un balss aģents tam seko reāllaikā.

Vadības panelī: Zvanu vēsture (/dashboard/call-history) arhīvam un detalizētai informācijai par katru zvanu; Tiešsaistē — zvaniem procesā. Skatiet Pārskatiet, klausieties un vadiet savus zvanus.

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

Klientu portāli#

Klientu portāls ir zīmola noformējumam atbilstošs, tikai lasāms zvanu vēstures skats ārējam klientam. Organizācijas administratori izvēlas balss aģentus, kuru zvani tiek rādīti, pievieno apstiprinātas skatītāju e-pasta adreses, augšupielādē logotipu un akcenta krāsu un pēc izvēles verificē pielāgotu domēnu. Portāla skatītāji var pārskatīt zvanu detalizēto informāciju, stenogrammas 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 nodrošina jūsu vietnes apmeklētājiem sarunu ar 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 izcelsmei jūsu atļautajos domēnos, tāpēc to var droši izmantot klienta puses kodā.

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

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 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 balss 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, pēc tam pievienojiet zināšanu bāzi balss aģentam veidotājā. Balss aģents tajā vaicā, izmantojot 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 to pievienotu balss aģentam. Skatiet Nodrošināt savam balss aģentam zināšanu bāzi.

Savienojumi#

Savienojumi ir veids, kā balss aģenti sasniedz ā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 katrai darbībai paredzētos rīkus (nosūtīt Slack ziņojumu, atjaunināt vai izveidot HubSpot kontaktpersonu, 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 zvanu pirms publicēš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ā 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 balss aģentus, pārbaudīt zvanus un atšifrējumus, 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 balss aģentu un izejošo numuru, kā arī iestatiet zvanīšanas laika logu (dienas un stundas, ņemot vērā laika joslu), vienlaicīgumu un atkārtotu mēģinājumu politiku (maksimālo mēģinājumu skaitu un rezultātus — neatbild, balss pasts, neizdevās —, kuriem veikt atkārtotu mēģinājumu). 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.

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

Tiešraides uzraudzība#

Tiešraide parāda katru organizācijā notiekošo zvanu un ļauj atvērt jebkuru no tiem, lai klausītos un čukstētu reāllaikā. Tā ir uzraudzības virsma: vērojiet, kā jauna uzvedne saņem pirmo reālo trafiku, 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 veic īstu sarunu ar jūsu balss aģentu — tas pats telefonijas ceļš, īsts transkripts, īsta vērtēšana —, lai jūs varētu testēt pirms un pēc publicēš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 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 noteikts minimālais sekmības rādītājs un kuri 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) un 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.

Validācijas kopas#

Validācijas kopa pārvērš īstus zvanu mirkļus atkārtojamās viena gājiena regresijas pārbaudēs. Katrs piemērs fiksē sarunas kontekstu, atbilstošo zvanītāja audio, sākotnējo atbildi un sagaidāmo darbību. Atkārtojumi tiek veikti pret pašreizējo balss aģenta melnrakstu, neveicot vēl vienu zvanu, un publicēšanas dialoglodziņā var parādīt, vai jaunākais izpildījums 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ījumiem. Skatiet Validācijas kopas.

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

Eksperimenti#

Eksperiments veic balss aģenta konfigurāciju A/B testēšanu reālajā trafikā: definējiet variantus (dažādas uzvednes, dzinējus vai iestatījumus), sadaliet trafiku starp tiem un salīdziniet rezultātus katram variantam. Izmantojiet to, nevis manuāli veidojiet segmentēšanas 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 iesniedzis cilvēks, kas veic pārskatīšanu, vai konstatējusi AI vērtēšana. Problēmām ir smaguma pakāpe, avots un statuss, bet lapa Problēmas ir šķirošanas rinda: filtrējiet, pārbaudiet problemātisko zvanu un sekojiet labojumiem.

Informācijas panelī: Problēmas (/dashboard/issues) un 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 sarunu ar cilvēku?") ar AI sagatavotu analīzi, kas attiecas uz 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 virsma: zvanu apjoms, rezultāti un kvalitāte laika gaitā, filtrējama pēc balss aģenta un laika perioda, ar eksportu 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) laika periodā un tiek aktivizēta, kad tā pārsniedz jūsu slieksni. Paziņojumi tiek nosūtīti uz e-pastu un Slack, kā arī tiek aktivizēts alert.triggered notikums jūsu tīmekļa aizķeres galapunktiem.

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ā notiek kādi notikumi. Divi piegādes modeļi:

• Tīmekļa aizķeru galapunkti (ieteicams): pārvaldiet vairākus URL adresē /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 adresē /v1/webhook vai sadaļā Organizācija → Vispārīgi. Saglabāta atpakaļsaderībai.

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

• Bloķējošiem notikumiem jūsu serverim ir jāatbild ar konfigurāciju, kas nosaka aktīvā zvana norisi — tie ir ienākošā zvana notikumi (telephony.incoming / web.incoming). Atbildei ir līdz 10 sekundēm; noildzes gadījumā zvanu apstrādā statiski piešķirtais balss aģents.
• Nebloķējošie notikumi ir paziņojumi, kas tiek nosūtīti bez atbildes gaidīšanas un atkārtoti ar eksponenciālu aizturi — skatiet piegādes semantiku.

Katrs pieprasījums ietver HMAC-SHA256 parakstu laukā X-ThunderPhone-Signature. Skatiet paraksta verificēšanu.

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 veic parakstīto 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ētā režīmā — kuras iespējojat ar vienkāršām uzvedņu 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#

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 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. Katrai organizācijai ir USD atlikums; par zvaniem no tā tiek atskaitīta maksa atbilstoši balss aģenta minūtes tarifam (dzinēja līmenis un piemaksas — veidotājs, mainot iestatījumus, reāllaikā parāda kopējo tarifu, un atlasītās 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ātisku papildināšanu ar atlikuma slieksni, papildināšanas summu un izvēles mēneša tēriņu limitu — lai zvans nekad netiktu pārtraukts 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ātisku papildināšanu, kā arī pilno cenu atsauci.

API: /v1/billing.

Lietotnē iebūvētais kopilots#

Informācijas panelī ir iebūvēts kopilots — jautājiet tam: "kā veikt X", un tas atbildēs, izmantojot šo dokumentāciju, piedāvās detalizētas pamācības ar 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 šajā lapā minēto vadīklu. Skatiet Jautājiet lietotnē iebūvētajam kopilotam.

Apvienojot visu kopā#