Osnovni koncepti

Pregled vsega na platformi — kaj počne posamezen objekt, kje se nahaja na nadzorni plošči in kateri API ga uporablja.

ThunderPhone je celovita platforma za gradnjo, zagon in izboljševanje glasovnih agentov z UI. Ta stran je zemljevid: vsak pojem, s katerim se boste srečali, je predstavljen v kratkem razdelku, skupaj s površino na nadzorni plošči in API-jem, ki ga podpira. Enkrat jo na hitro preglejte, nato pa se nanjo vrnite, kadar želite razjasniti izraz.

Stranska vrstica nadzorne plošče odraža to strukturo:

Organizacije#

Organizacija je enota najemništva. Vsak drug vir — agenti, telefonske številke, klici, ključi — pripada natanko eni organizaciji. Vaš račun lahko pripada več organizacijam; vsaka ima svoje stanje dobroimetja, svoje ključe in svoj seznam članov.

Ključ API sk_live_, ki ga ustvarite v razdelku Organizacija → Ključi, je vezan na eno organizacijo. Ta vezava omogoča tako plosko strukturo REST API-ja: ID-ja organizacije nikoli ne vključite v poti URL, saj ga vaš ključ že določa.

Na nadzorni plošči: izbirnik organizacije (v nogi stranske vrstice) in nastavitve Organizacija — zavihki Moj račun, Splošno, Ključi, Opozorila, Nastavitve obračunavanja in Zgodovina obračunavanja. Oglejte si referenco nastavitev organizacije.

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

Agenti#

Agent je konfiguracija UI, ki izvaja klic. Vključuje:

• Poziv, ki določa, kaj agent pove in kako se vede — vključno z dejanji med klicem, kot so preusmeritve, pritiski tipk na tipkovnici in prekinitev klica, ki so navadne vrstice poziva in ne ločena konfiguracija.
• Raven pogona (spark, bolt, storm-*): Spark je optimiziran za stroške, Bolt za hitrost, Storm pa za inteligenco pri kompleksnih pozivih.
• Glas ter primarni jezik in izbirni dodatni jeziki — agent samodejno preklopi, ko klicatelj zamenja jezik. Oglejte si podprte jezike.
• Pripete zmožnosti: povezane aplikacije, povezave API, baze znanja, strežniki MCP in vdelana funkcijska orodja.
• Nastavitve vedenja: vrstni red govora, način potrditve, glasba v ozadju, časovna omejitev čakanja.

Urejanja v gradniku se samodejno shranijo kot osnutek; nič ne postane aktivno, dokler ne kliknete Objavite. Vsaka objava se posname na posnetek v zavihku Zgodovina gradnika, zato lahko pregledate in obnovite katero koli prejšnjo različico.

Na nadzorni plošči: Glasovni agenti → gradnik agenta (/dashboard/agents). Oglejte si Gradnja prvega glasovnega agenta.

V API-ju: /v1/agents — CRUD, podvajanje, preusmeritev, zgodovina različic in pomočniki za pozive.

Glasovi#

Knjižnica glasov vsebuje glasove, ki jih lahko uporablja agent, njihove predvajane vzorce, združljive jezike, razvrstitve po spolu in naglasu ter morebitni dodatek za premijske glasove oziroma jezike. Pred izbiro lahko s plačljivim preizkuševalnikom sintetizirate lastno frazo z 1–500 znaki.

Upravičene organizacije lahko iz kratkega vzorca WAV ali MP3 ustvarijo tudi glasove po meri. Glasovi po meri imajo kvoto in stanje asinhronega ustvarjanja; ko so pripravljeni, se prikažejo v istem izbirniku agentov kot glasovi iz knjižnice.

Na nadzorni plošči: Glasovi (/dashboard/voices). Oglejte si Knjižnica glasov in glasovi po meri.

V API-ju: /v1/voices, vzorci glasov in glasovi po meri.

Telefonske številke#

Telefonska številka pripada organizaciji in usmerja dohodne klice k agentu (ter lahko prenaša odhodne klice). Dva vira:

• Številke ThunderPhone — prave ameriške številke, dodeljene iz nabora ThunderPhone, aktivne v nekaj sekundah, $1/mesec plus 1 ¢/minuto dodatka. Samo za dohodne klice; za odhodne klice potrebujete lastnega ponudnika. Organizacija jih lahko privzeto ima 25.
• VoIP-številke — prenesene od vašega ponudnika prek povezave VoIP. Twilio in Telnyx se povežeta neposredno (Telnyx ima vodeno nastavitev); SignalWire in Vonage bosta na voljo kmalu — trenutno ju dosežete z ročno konfiguracijo SIP, ki sprejema kateri koli SIP-trunk. Ko so VoIP-številke uvožene in preverjene, podpirajo dohodne in odhodne klice.

V vsaki vrstici številke lahko nastavite način usmerjanja, izberete agenta za dohodne klice in številko označite.

Na nadzorni plošči: Telefonske številke (/dashboard/phone-numbers). Oglejte si Pridobite telefonsko številko.

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

Klici#

Vsak dohodni klic, odhodni klic, simulacija in seja pripomočka postane dnevnik klica. Klic vsebuje celoten prepis z oznakami vlog, strukturirano zgodovino potez (vključno s klici orodij), posnetek, skupni znesek obračuna ter izbirno ocenjevanje z UI in poročila o težavah.

Ko je klic v živo, ga lahko odprete in mu prisluhnete — pridružite se neslišno in nihče v klicu vas ne sliši. Ko prisluhnete, lahko šepetate: vnesite navodilo, ki se med klicem neposredno pošlje vašemu agentu; klicatelj ga nikoli ne sliši, agent pa mu sledi v živo.

Na nadzorni plošči: Zgodovina klicev (/dashboard/call-history) za arhiv in podrobnosti posameznih klicev; V živo za klice v teku. Oglejte si Preglejte, prisluhnite in usmerjajte svoje klice.

V API-ju: /v1/calls — seznam, prepis, zgodovina, zvok, ocenjevanje, izvoz; /v1/issue-reports.

Portali za stranke#

Portal za stranke je prilagojen pogled zgodovine klicev samo za branje za zunanjo stranko. Skrbniki organizacije izberejo agente, katerih klici so prikazani, dodajo e-poštne naslove odobrenih gledalcev, naložijo logotip in barvo poudarka ter po želji preverijo domeno po meri. Gledalci portala lahko pregledujejo podrobnosti klicev, prepise in razpoložljive posnetke, ne da bi prejeli dostop do nadzorne plošče.

Na nadzorni plošči: Portali za stranke (/dashboard/client-portals). Oglejte si Portali za stranke.

V API-ju: /v1/client-portals za skrbniško upravljanje.

Spletni gradniki#

Spletni gradnik obiskovalcem vašega spletnega mesta omogoča pogovor z agentom prek mikrofona — telefonska številka ni potrebna. Preverja pristnost z javno objavljivim ključem (pk_live_...), ki je vezan na izvor vaših dovoljenih domen, zato je varen za uporabo v kodi na strani odjemalca.

Ključi delujejo v enem od dveh načinov: agent (statično vezan na enega agenta) ali webhook (vaš strežnik izbere konfiguracijo za vsakega obiskovalca — glejte Dinamična konfiguracija za posamezen klic). Seje gradnika potekajo prek iste klicne infrastrukture kot telefonski klici.

Na nadzorni plošči: Spletni gradniki (/dashboard/web-widgets) — ustvarite gradnike, nastavite način in agenta, upravljajte dovoljene domene ter kopirajte delček za vdelavo. Glejte Ustvarite spletni gradnik.

V API-ju: /v1/publishable-key, /v1/mic-session in dokumentacijo SDK-ja za gradnike.

Baze znanja#

Baza znanja je zbirka dokumentov, po katerih lahko vaš agent med klicem išče, da utemelji svoje odgovore — naložite datoteke, prilepite besedilo ali uvozite spletne strani prek URL-ja, nato pa bazo znanja v gradniku pripnite agentu. Agent jo po potrebi poizveduje z vgrajenim iskalnim orodjem.

Na nadzorni plošči: Znanje (/dashboard/knowledge) za knjižnico dokumentov; razdelek Znanje v gradniku za pripenjanje baze agentu. Glejte Dodajte svojemu agentu bazo znanja.

Povezave#

Povezave agentom omogočajo dostop do zunanjega sveta. Štiri vrste, ena skupina v stranski vrstici:

• Aplikacije (/dashboard/app-connections) — povezave OAuth s Slackom, HubSpotom, Salesforceom, Google Calendarjem, Google Sheetsom in Cal.comom. Povežite jih enkrat, nato pa za posamezna opravila vklopite orodja (objava sporočila v Slacku, posodobitev ali vstavljanje stika v HubSpotu, rezervacija termina v Cal.comu …) za katerega koli agenta. Glejte Povežite aplikacije.
• API-ji (/dashboard/api-connections) — spremenite kateri koli HTTP API v dejanje agenta. Prilepite ukaz cURL in čarovnik z umetno inteligenco pripravi osnutek definicije orodja, lahko pa jo ustvarite ročno; gumb Preizkusna zahteva izvede klic v peskovniku, preden ga uvedete. Glejte Povezave API — vmesnik nadzorne plošče za /v1/integrations.
• MCP (/dashboard/mcp-connections) — dodajte strežnik Model Context Protocol prek URL-ja in agentu omogočite uporabo orodij, ki jih ponuja. Glejte Dodajte strežnik MCP.
• VoIP (/dashboard/voip-connections) — poverilnice ponudnika za uporabo lastnih telefonskih številk. Glejte Povežite ponudnika VoIP.

ThunderPhone ponuja tudi lastno končno točko MCP, tako da lahko zunanji odjemalec MCP navede agente, pregleda klice in prepise ter izvaja klice. Glejte Uporabite ThunderPhone kot strežnik MCP.

V API-ju: /v1/integrations, /v1/mcp-servers in /v1/voip-connections; glejte tudi Ustvarite integracijo orodja.

Kampanje#

Kampanja izvaja odhodne klice v velikem obsegu: naložite CSV s stiki, izberite agenta in izhodno številko ter nastavite okno za klice (dneve in ure ob upoštevanju časovnega pasu), sočasnost in pravilnik ponovnih poskusov (največje število poskusov in izide — brez odgovora, glasovna pošta, neuspešno — za katere se klic ponovi). Kampanja obdeluje seznam in vsak klic zabeleži v zgodovini klicev.

Na nadzorni plošči: Kampanje (/dashboard/campaigns). Glejte Izvedite kampanjo odhodnih klicev.

Za posamezne programske klice: API za odhodne klice.

Spremljanje v živo#

V živo prikazuje vsak klic, ki trenutno poteka v organizaciji, in vam omogoča, da katerega koli od njih odprete ter ga poslušate in šepetate v realnem času. To je površina za nadzor: spremljajte, kako nov poziv prejme prvi dejanski promet, ali nadzorujte aktivno kampanjo.

Na nadzorni plošči: V živo (/dashboard/live). Oglejte si Spremljanje in nadzor klicev v živo.

Simulacije#

Simulacija je klicatelj z umetno inteligenco, ki ima resničen pogovor z vašim agentom — ista telefonska pot, dejanski prepis in dejansko ocenjevanje — zato lahko preizkusite pred objavo (in po njej). Usmerite jo na agenta ali telefonsko številko, sami napišite scenarij klicatelja ali ustvarite scenarije z umetno inteligenco iz poziva agenta (vključno z robnimi primeri, če jih zahtevate) in spremljajte klic v živo.

Scenariji se združujejo v zbirke, ki določajo najmanjšo stopnjo uspešnosti in lahko omejijo izdaje v CI; regresije glede na sprejeto izhodišče so prijavljene za vsak scenarij.

Na nadzorni plošči: Simulacije (/dashboard/simulations) ter gumb Simulacija v urejevalniku agenta. Oglejte si Simuliranje klica.

V API-ju: /v1/test-calls in izvajalnik zbirk — oglejte si Celovito testiranje agenta.

Nabori za preverjanje#

Nabor za preverjanje spremeni trenutke iz resničnih klicev v ponovljive regresijske preglede z enim obratom. Vsak primer zamrzne kontekst pogovora, ustrezni zvok klicatelja, izvirni odgovor in pričakovano vedenje. Ponovitve se izvajajo na trenutnem osnutku agenta brez novega klica, pogovorno okno za objavo pa lahko prikaže, ali se najnovejši zagon še vedno ujema s tem osnutkom.

Na nadzorni plošči: Nabori za preverjanje (/dashboard/validation) za nabor podatkov organizacije in zavihek Preverjanje v urejevalniku agenta za zagone. Oglejte si Nabori za preverjanje.

V API-ju: /v1/validation-sets in končne točke za ponovitev agenta/primera na isti referenčni strani.

Poskusi#

Poskus izvaja A/B-test konfiguracij agenta na dejanskem prometu: določite različice (različne pozive, pogone ali nastavitve), razdelite promet mednje in primerjajte rezultate po različicah. Uporabite ga namesto ročne izdelave logike segmentov v spletnem kavlju.

Na nadzorni plošči: Poskusi (/dashboard/experiments) in zavihek A/B v urejevalniku agenta. Oglejte si Poskusi (A/B-testiranje).

Težave#

Težava je označen problem pri določenem klicu — prijavi jo človeški pregledovalec ali jo zazna ocenjevanje z umetno inteligenco. Težave vsebujejo resnost, vir in stanje, stran Težave pa je čakalna vrsta za triažo: filtrirajte, preglejte problematični klic in spremljajte popravke.

Na nadzorni plošči: Težave (/dashboard/issues) ter označevanje za posamezne klice v zgodovini klicev. Oglejte si Triaža težav.

V API-ju: /v1/issue-reports.

Poročila#

Poročilo odgovori na vprašanje v naravnem jeziku o vaših podatkih o klicih ("Kateri so bili trije najpogostejši razlogi, da so klicatelji prejšnji teden zahtevali človeka?") z analizo, ki jo napiše umetna inteligenca in je omejena na agente ter časovno obdobje, ki ju izberete.

Na nadzorni plošči: Poročila (/dashboard/reports). Oglejte si Poročila.

Opazljivost#

Opazljivost je površina za metrike: obseg klicev, rezultati in kakovost skozi čas, z možnostjo filtriranja po agentu in časovnem oknu ter izvoza za nadaljnjo analizo.

Na nadzorni plošči: Opazljivost (/dashboard/observability). Oglejte si Opazljivost.

Opozorila#

Pravilo opozorila spremlja metriko (stopnjo uspešnosti, stopnjo neuspešnosti, povprečno oceno, obseg klicev, regresije zbirk) v časovnem oknu in se sproži, ko preseže vaš prag. Obvestila se pošljejo po e-pošti in v Slack ter sprožijo dogodek alert.triggered za vaše končne točke spletnih kavljev.

Na nadzorni plošči: Organizacija → Opozorila. Oglejte si Opozorila.

Spletni kavlji#

ThunderPhone pošilja spletne kljuke HTTP POST na vaš strežnik, ko se med klicem ali po njem zgodijo določeni dogodki. Na voljo sta dva modela dostave:

• Končne točke spletnih kljuk (priporočeno): upravljajte več URL-jev na /v1/developer/webhook-endpoints s skrivnostmi in naročninami na dogodke za posamezne končne točke.
• Podedovana spletna kljuka z enim URL-jem: en URL na organizacijo. Upravljate jo na /v1/webhook ali v razdelku Organizacija → Splošno. Ohranjena je zaradi združljivosti s starejšimi različicami.

Dogodki se delijo v dva razreda:

• Blokirajoči dogodki pričakujejo, da vaš strežnik odgovori s konfiguracijo, ki oblikuje klic v teku — to so dogodki dohodnega klica (telephony.incoming / web.incoming). Za odgovor imate do 10 sekund; ob prekoračitvi časovne omejitve klic obravnava statično dodeljeni agent.
• Neblokirajoči dogodki so obvestila po načelu pošlji in pozabi, ki se ponavljajo z eksponentnim zamikom — glejte semantiko dostave.

Vsaka zahteva vsebuje podpis HMAC-SHA256 v X-ThunderPhone-Signature. Glejte preverjanje podpisov.

Funkcijska orodja#

Funkcijsko orodje je končna točka HTTP, ki jo lahko vaš agent pokliče med pogovorom. ThunderPhone posredujete funkcijsko shemo v slogu OpenAI ter URL končne točke; agent odloči, kdaj jo bo poklical, ThunderPhone pa iz svojih strežnikov izvede podpisano zahtevo HTTP in rezultat vrne agentu.

Agenti vključujejo tudi vgrajene zmožnosti za klice — preusmerjanje klica, pošiljanje vnosa s tipkovnice (DTMF), končanje klica, čakanje na zadržani zvezi — ki jih omogočite z navadnimi vrsticami poziva namesto z definicijami orodij.

Na nadzorni plošči: razdelek gradnika Povezave API (glejte Povezave).

V API-ju: /v1/integrations in specifikacija funkcijskih orodij.

Ekipa in vloge#

Vsaka organizacija ima seznam članov z dvema vlogama: Člani gradijo in upravljajo agente; Skrbniki upravljajo tudi ekipo in obračunavanje. Povabite po e-pošti — povabila potečejo po 7 dneh in jih lahko prekličete; meni ⋯ v vrstici člana spremeni vloge ali odstrani osebo. Enotno prijavo lahko konfigurirate za celotno organizacijo — glejte SSO.

Na nadzorni plošči: Organizacija → Splošno. Glejte Povabite svojo ekipo.

V API-ju: /v1/members, /v1/invites.

Obračunavanje#

ThunderPhone je predplačniški. Vsaka organizacija ima dobroimetje v USD; klici ga bremenijo po minutni tarifi agenta (stopnja pogona in doplačila — gradnik med spreminjanjem nastavitev sproti prikazuje skupno tarifo, izbrani dodatni jeziki pa dodajo 3 ¢/min). Ko dobroimetje doseže nič, so dohodni klici zavrnjeni, odhodni klici pa vrnejo 402 Payment Required.

Dobroimetje lahko dopolnite ročno ali omogočite samodejno dopolnjevanje s pragom dobroimetja, zneskom dopolnitve in izbirno mesečno omejitvijo porabe — da se klic nikoli ne prekine sredi stavka.

Na nadzorni plošči: Organizacija → Nastavitve obračunavanja in Zgodovina obračunavanja. Glejte Dodajte sredstva in vklopite samodejno dopolnjevanje ter celoten pregled cen.

V API-ju: /v1/billing.

Kopilot v aplikaciji#

Nadzorna plošča vključuje vgrajenega kopilota — vprašajte ga »kako naredim X« in odgovoril bo na podlagi te dokumentacije, ponudil navodila po korakih s poudarjenimi dejanskimi kontrolniki ter lahko znova predvaja katero koli od vodenih predstavitev. To je najhitrejši način za iskanje kontrolnika, ki ga omenja ta stran. Glejte Vprašajte kopilota v aplikaciji.

Povezovanje vsega skupaj#