Osnovni koncepti

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

ThunderPhone je celovita platforma za izdelavo, izvajanje in izboljševanje glasovnih agentov z UI. Ta stran je zemljevid: vsak koncept, ki ga boste srečali, je predstavljen v enem kratkem razdelku, skupaj s površino nadzorne plošče in API-jem, ki ga podpira. Enkrat jo na hitro preglejte, nato pa se vrnite, kadar potrebujete razlago izraza.

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 preprost REST API: v poti URL nikoli ne navedete ID-ja organizacije, saj jo vaš ključ že določa.

Na nadzorni plošči: preklopnik organizacij (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 in prekinitev klica, ki so običajne vrstice poziva in ne ločena konfiguracija.
• Raven pogona (spark, bolt, storm-*): Spark je optimiziran za stroške, Bolt za hitrost, Storm pa za inteligentno obravnavo zapletenih pozivov.
• Glas ter primarni jezik in izbirni dodatni jeziki — agent samodejno preklopi, ko klicatelj zamenja jezik. Oglejte si podprte jezike.
• Pripete zmogljivosti: povezane aplikacije, povezave API, baze znanja, strežniki MCP in vdelana funkcijska orodja.
• Nastavitve vedenja: vrstni red govora, način potrjevanja, glasba v ozadju, časovna omejitev čakanja.

Urejanja v gradniku se samodejno shranijo kot osnutek; nič ne začne veljati, dokler ne kliknete Objavite. Vsaka objava se shrani kot posnetek na 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 Izdelajte svoj prvi glasovni agent.

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

Glasovi#

Knjižnica glasov vsebuje glasove, ki jih lahko uporablja agent, njihove predvajalne vzorce, združljive jezike, skupine po spolu in naglasu ter morebitna doplačila za premijske glasove/jezike. Plačljiv preizkus lahko sintetizira vašo lastno frazo z 1–500 znaki, preden izberete glas.

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

Na nadzorni plošči: Glasovi (/dashboard/voices). Glejte 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, zagotovljene iz nabora ThunderPhone, aktivne v nekaj sekundah, $1/mesec plus 1 ¢/minuto doplačila. Sprva podpirajo le dohodne klice. Skrbnik organizacije lahko na strani Telefonske številke zahteva odhodne klice; ThunderPhone vsako zahtevo pregleda ročno, odobrene številke pa lahko opravljajo klice in izvajajo kampanje. Organizacija jih lahko privzeto ima 25.
• VoIP-številke — pridobljene od vašega ponudnika prek povezave VoIP. Twilio in Telnyx se povežeta neposredno s ključem API (Telnyx ponuja tudi voden postopek nastavitve novega računa); SignalWire, Vonage, Plivo in kateri koli drug SIP-trunk se povežejo prek nastavitve SIP, ročne konfiguracije SIP. Ko so številke VoIP uvožene in preverjene, podpirajo dohodne in odhodne klice.

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

Na nadzorni plošči: Telefonske številke (/dashboard/phone-numbers). Glejte 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 izbirne ocene umetne inteligence in poročila o težavah.

Ko je klic v teku, ga lahko odprete in prisluškujete — pridružite se tiho in nihče v klicu vas ne sliši. Ko prisluškujete, lahko šepetate: vnesite navodilo, ki gre neposredno vašemu agentu med klicem; 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. Glejte Preglejte, poslušajte 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). Glejte Portali za stranke.

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

Spletni pripomočki#

Spletni gradnik obiskovalcem vašega spletnega mesta omogoča pogovor z glasovnim agentom prek mikrofona — telefonska številka ni potrebna. Preverjanje pristnosti uporablja ključ za objavo (pk_live_...), ki ga lahko brskalniki uporabljajo le iz vaših dovoljenih domen, zato je varen za uporabo v odjemalski kodi. Seznam domen ni preverjanje pristnosti, nastavitve seje, ki jih lahko pošlje stran, pa so izklopljene, dokler jih ne dovolite za ključ.

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

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

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

Zbirke znanja#

Zbirka znanja je nabor dokumentov, po katerih lahko vaš agent išče med klicem, da utemelji svoje odgovore — naložite datoteke, prilepite besedilo ali uvozite spletne strani prek URL-ja, nato pa zbirko znanja v gradniku pripnite agentu. Agent po njej poizveduje z vgrajenim iskalnim orodjem, kadar to zahteva pogovor.

Na nadzorni plošči: Znanje (/dashboard/knowledge) za knjižnico dokumentov; razdelek Znanje v gradniku za pripenjanje zbirke agentu. Glejte Agentu dodajte zbirko znanja.

Povezave#

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

• Aplikacije (/dashboard/app-connections) — povezave OAuth s storitvami Slack, HubSpot, Salesforce, Google Calendar, Google Sheets in Cal.com. Povežite jih enkrat, nato pa za posamezne postopke vklopite orodja (pošljite sporočilo v Slacku, posodobite ali ustvarite stik v HubSpotu, rezervirajte termin v Cal.comu …) za poljubnega agenta. Glejte Povežite aplikacije.
• API-ji (/dashboard/api-connections) — spremenite poljuben HTTP API v dejanje agenta. Prilepite ukaz cURL in čarovnik AI pripravi osnutek definicije orodja, lahko pa jo ustvarite ročno; gumb Preizkusite zahtevo izvede klic v peskovniku pred objavo. Glejte Povezave API — nadzorni vmesnik za /v1/integrations.
• MCP (/dashboard/mcp-connections) — dodajte strežnik Model Context Protocol prek URL-ja in agentu omogočite uporabo orodij, ki jih strežnik 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, 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 klicanje (dneve in ure ob upoštevanju časovnega pasu), sočasnost in pravilnik ponovnih poskusov (največje število poskusov in kateri izidi — ni odgovora, telefonski predal, neuspeh — se ponovijo). Kampanja obdeluje seznam in vsak klic zabeleži v zgodovino klicev.

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

Za enkratne 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 za poslušanje in šepetanje v realnem času. To je nadzorna površina: spremljajte, kako nov poziv prejme prvi pravi 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 glasovnim agentom — po isti telefonski poti, z resničnim prepisom in resničnim ocenjevanjem — zato lahko testirate pred uvedbo (in po njej). Usmerite jo na glasovnega agenta ali telefonsko številko, sami napišite scenarij klicatelja ali ustvarite scenarije z umetno inteligenco na podlagi poziva glasovnega agenta (vključno z mejnimi primeri, če jih zahtevate), in spremljajte klic v živo.

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

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

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

Nabori za preverjanje#

Nabor za preverjanje spremeni resnične trenutke klicev v ponovljive enokoračne regresijske preglede. Vsak primer zamrzne kontekst pogovora, ustrezen zvok klicatelja, izvirni odgovor in pričakovano vedenje. Ponovitve se izvajajo glede na trenutni osnutek glasovnega agenta brez novega klica, pogovorno okno za uvedbo pa lahko pokaže, ali se zadnji zagon še vedno ujema s tem osnutkom.

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

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

Eksperimenti#

Eksperiment izvaja A/B-testiranje konfiguracij glasovnega agenta na prometu v živo: 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 skupin v spletnem kavlju.

Na nadzorni plošči: Eksperimenti (/dashboard/experiments) in zavihek A/B v gradniku glasovnega agenta. Oglejte si Eksperimenti (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 vključujejo resnost, vir in stanje, stran Težave pa je čakalna vrsta za triažo: filtrirajte, preglejte sporni klic in spremljajte popravke.

Na nadzorni plošči: Težave (/dashboard/issues) ter označevanje posameznih klicev 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 glasovne agente ter datumski obseg, 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 glasovnem agentu in časovnem obdobju 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 določenem časovnem obdobju in se sproži, ko preseže vaš prag. Obvestila se pošiljajo 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.

Webhooki#

ThunderPhone pošlje webhooke HTTP POST na vaš strežnik, ko se med klicem ali po njem zgodijo določeni dogodki. Dva modela dostave:

• Končne točke webhookov (priporočeno): upravljajte več URL-jev na /v1/developer/webhook-endpoints s skrivnostmi za posamezne končne točke in naročninami na dogodke za posamezne končne točke.
• Podedovani webhook z enim URL-jem: en URL na organizacijo. Upravljate ga na /v1/webhook ali v razdelku Organizacija → Splošno. Ohranjeno zaradi združljivosti za nazaj.

Dogodki so razdeljeni v dva razreda:

• Blokirajoči dogodki pričakujejo, da se vaš strežnik odzove s konfiguracijo, ki oblikuje klic v teku — to so dogodki dohodnega klica (telephony.incoming / web.incoming). Telefonski klic čaka do 13 sekund, vključno z enim ponovnim poskusom, seja pripomočka pa 10 sekund. Nadomestnega glasovnega agenta ni: brez uporabne konfiguracije se telefonski klic konča, seja pripomočka pa ne uspe.
• Neblokirajoči dogodki so obvestila »pošlji in pozabi«, ki se ponovno pošiljajo z eksponentnim zamikom — glejte semantiko dostave.

Vsaka zahteva vsebuje časovno označen podpis HMAC-SHA256 v X-ThunderPhone-Signature-V2 ter starejši podpis, ki vključuje samo telo, X-ThunderPhone-Signature. Glejte preverjanje podpisov.

Funkcijska orodja#

Funkcijsko orodje je končna točka HTTP, ki jo lahko vaš agent pokliče sredi pogovora. ThunderPhone posredujete shemo funkcije v slogu OpenAI in URL končne točke; agent se odloči, kdaj jo bo poklical, ThunderPhone pa iz svojih strežnikov pošlje 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 čakanju —, ki jih omogočite z navadnimi vrsticami poziva namesto z definicijami orodij.

Na nadzorni plošči: razdelek ustvarjalnika API-povezave (glejte Povezave).

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

Ekipa in vloge#

Vsaka organizacija ima seznam članov z dvema vlogama: Člani ustvarjajo 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 nekoga odstrani. 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 agentovi ceni na minuto (raven pogona in doplačila — ustvarjalnik med spreminjanjem nastavitev v živo prikazuje skupno ceno, in izbrani dodatni jeziki dodajo 3¢/min). Ko dobroimetje doseže nič, so dohodni klici zavrnjeni, odhodni klici pa vrnejo 402 Payment Required.

Sredstva dodajte ročno ali omogočite samodejno polnjenje dobroimetja s pragom dobroimetja, zneskom polnitve 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 polnjenje dobroimetja 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«, pa odgovori na podlagi te dokumentacije, ponudi navodila po korakih s klikanjem, ki poudarijo dejanske kontrolnike, in lahko znova predvaja katerega koli od vodenih ogledov. To je najhitrejši način za iskanje kontrolnika, omenjenega na tej strani. Glejte Vprašajte kopilota v aplikaciji.

Povežite vse skupaj#