Osnovni koncepti

ThunderPhone je celovita platforma za ustvarjanje, izvajanje in izboljševanje glasovnih agentov z umetno inteligenco. Ta stran je zemljevid: vsak pojem, s katerim se 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 je treba razložiti kak 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 dobroimetje, svoje ključe in svoj seznam članov.

Ključ API sk_live_, ki ga ustvarite v razdelku Organizacija → Ključi, je vezan na eno organizacijo. Zaradi te vezave je REST API tako preprost: v poti URL nikoli ne navedete ID-ja organizacije, saj ga vaš ključ že identificira.

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

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

Agenti

Agent je konfiguracija umetne inteligence, 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 zahtevnih pozivih.
• Glas ter primarni jezik in izbirne dodatne jezike — agent se samodejno preklopi, ko klicatelj spremeni jezik. Glejte Podprti jeziki.
• Pripete zmogljivosti: povezane aplikacije, povezave API, baze znanja, strežniki MCP in vdelana funkcijska orodja.
• Nastavitve vedenja: vrstni red govorjenja, način potrjevanja, glasba v ozadju, časovna omejitev zadržanja.

Urejanja v graditelju se samodejno shranijo kot osnutek; nič ne začne veljati, dokler ne kliknete Uvedite. Vsaka uvedba se shrani kot posnetek na zavihku Zgodovina graditelja, zato lahko pregledate in obnovite katero koli prejšnjo različico.

Na nadzorni plošči: Glasovni agenti → graditelj agenta (/dashboard/agents). Glejte Ustvarite svojega 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 predvajalne vzorce, združljive jezike, razvrstitve po spolu in naglasu ter morebitno doplačilo za premium glasove oziroma jezike. S plačljivim preizkusom lahko pred izbiro 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 asinhrono stanje ustvarjanja; ko so pripravljeni, se v istem izbirniku agentov prikažejo skupaj z 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, glasovni vzorci in glasovi po meri.

Telefonske številke

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

• Predstavitvene številke — prave ameriške številke, zagotovljene iz ThunderPhoneovega nabora, aktivne v nekaj sekundah. Samo za dohodne klice, oglasijo se s kratkim govorjenim obvestilom, nadzorna plošča pa organizacijo omeji na 10 takšnih številk. Odlične za prvo preizkušanje, ne pa za produkcijo.
• Številke VoIP — pridobljene od lastnega ponudnika prek povezave VoIP. Twilio in Telnyx se povežeta neposredno (Telnyx ima vodeno nastavitev); SignalWire in Vonage prihajata kmalu — trenutno ju lahko dosežete z ročno konfiguracijo SIP, ki sprejme kateri koli SIP trunk. 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). 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 gradnika postane dnevnik klica. Klic vključuje celoten prepis z oznakami vlog, strukturirano zgodovino potekov (vključno s klici orodij), posnetek, skupni znesek obračuna ter izbirno ocenjevanje z umetno inteligenco in poročila o težavah.

Medtem ko je klic v živo, ga lahko odprete in poslušate — pridružite se neslišno in nihče v klicu vas ne sliši. Ko poslušate, lahko šepetate: vnesite navodilo, ki med klicem neposredno doseže vašega agenta; 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 posameznega klica; V živo za klice v teku. Oglejte si 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 pogled zgodovine klicev samo za branje z blagovno znamko za zunanjo stranko. Skrbniki organizacije izberejo agente, katerih klici so prikazani, dodajo odobrene e-poštne naslove gledalcev, naložijo logotip in poudarno barvo 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ški vmesnik za upravljanje.

Spletni gradniki

Spletni gradnik obiskovalcem vašega spletnega mesta omogoča pogovor z agentom prek mikrofona — telefonska številka ni potrebna. Preverjanje pristnosti izvaja z objavljivim ključem (pk_live_...), ki je vezan na izvor vaših dovoljenih domen, zato ga je varno uporabljati 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 posameznega obiskovalca — glejte Dinamična konfiguracija za posamezni 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 vdelano kodo. Glejte Ustvarite spletni gradnik.

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

Zbirke znanja

Zbirka znanja je nabor dokumentov, po katerem lahko vaš agent išče med klicem, da utemelji svoje odgovore — naložite datoteke, prilepite besedilo ali uvozite spletne strani po URL-ju, nato pa zbirko znanja v gradniku povežite z agentom. 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 povezavo zbirke z agentom. 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 (objava sporočila v Slacku, posodobitev ali ustvarjanje stika v HubSpotu, rezervacija termina v Cal.com …) za katerega koli agenta. Glejte Povežite aplikacije.
• API-ji (/dashboard/api-connections) — poljuben HTTP API spremenite v dejanje agenta. Prilepite ukaz cURL, čarovnik z umetno inteligenco pripravi osnutek definicije orodja, ali pa jo ustvarite ročno; gumb Preizkusna zahteva izvede preskusni klic pred objavo. Glejte Povezave API — nadzornoploščni vmesnik za /v1/integrations.
• MCP (/dashboard/mcp-connections) — dodajte strežnik Model Context Protocol z URL-jem 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, tako da lahko zunanji odjemalec MCP navede agente, pregleda klice in prepise ter opravlja 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 izhodne klice v velikem obsegu: naložite CSV s stiki, izberite agenta in izhodno številko ter nastavite okno klicanja (dneve in ure z upoštevanjem časovnega pasu), sočasnost in pravilnik ponavljanja (največje število poskusov in kateri izidi — brez odgovora, glasovna pošta, neuspešno — se ponovno poskusijo). Kampanja obdeluje seznam in vsak klic zabeleži v zgodovini klicev.

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

Za enkratne programske klice: API za izhodne klice.

Spremljanje v živo

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

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

Simulacije

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

Scenariji so združeni v zbirke, ki določijo najnižjo stopnjo uspešnosti in lahko v CI omejijo izdaje; regresije glede na sprejeto izhodišče so prikazane za vsak scenarij.

Na nadzorni plošči: Simulacije (/dashboard/simulations) ter gumb Simulacija v gradniku agentov. Glejte Simulacija klica.

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

Validacijski nabori

Validacijski nabor pretvori trenutke iz resničnih klicev v ponovljive, enopotezne regresijske preglede. Vsak primer zamrzne kontekst pogovora, ustrezen zvok klicatelja, izvirni odgovor in pričakovano vedenje. Ponovitve se izvajajo glede na trenutni osnutek agenta brez novega klica, pogovorno okno za uvedbo pa lahko prikaže, ali se zadnji zagon še vedno ujema s tem osnutkom.

Na nadzorni plošči: Validacijski nabori (/dashboard/validation) za nabor podatkov organizacije in zavihek Validacija v gradniku agentov za zagone. Glejte Validacijski nabori.

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

Eksperimenti

Eksperiment izvaja A/B-preizkuse konfiguracij agentov na prometu v živo: določite različice (različne pozive, mehanizme ali nastavitve), razdelite promet mednje in primerjajte rezultate za posamezno različico. Uporabite ga namesto ročnega izdelovanja logike za razporeditev v skupine v spletnem kavlju.

Na nadzorni plošči: Eksperimenti (/dashboard/experiments) in zavihek A/B v gradniku agentov. Glejte 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 AI. 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 posameznih klicev v Zgodovini klicev. Glejte 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 klicev ("Kateri so bili prejšnji teden trije najpogostejši razlogi, da so klicatelji zahtevali človeka?") z analizo, ki jo pripravi AI in je omejena na agente ter obdobje, ki ju izberete.

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

Opazljivost

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

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

Opozorila

Pravilo opozorila spremlja metriko (stopnjo uspešnosti, stopnjo neuspešnosti, povprečno oceno, obseg klicev, regresije zbirk) v časovnem obdobju 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. Glejte Opozorila.

Spletni kljuki

ThunderPhone pošlje HTTP POST spletne kljuke na vaš strežnik, ko se med klicem ali po njem nekaj zgodi. Dva modela dostave:

• Končne točke spletnih kljukov (priporočeno): upravljajte več URL-jev na /v1/developer/webhook-endpoints s skrivnostmi in naročninami na dogodke za posamezno končno točko.
• 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 so razdeljeni v dva razreda:

• Blokirni 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 časa klic obravnava statično dodeljeni agent.
• Neblokirni dogodki so obvestila po načelu pošlji in pozabi, ki se ponovijo z eksponentnim zamikom — glejte semantiko dostave.

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

Orodja funkcij

Orodje funkcije je končna točka HTTP, ki jo lahko vaš agent pokliče med pogovorom. ThunderPhone zagotovite shemo funkcije v slogu OpenAI in URL končne točke; agent odloči, kdaj jo poklicati, ThunderPhone pa iz svojih strežnikov izvede podpisano zahtevo HTTP in rezultat posreduje nazaj agentu.

Agenti vključujejo tudi vgrajene zmožnosti klica — preusmerjanje klica, pošiljanje vnosa s tipkovnice (DTMF), zaključevanje klica, čakanje na čakanju — ki jih omogočite z običajnimi vrsticami poziva namesto z definicijami orodij.

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

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

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 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 minutni tarifi agenta (stopnja pogona in dodatni stroški — gradnik med spreminjanjem nastavitev v živo 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 napolnite ročno ali omogočite samodejno polnjenje s pragom dobroimetja, zneskom polnitve in izbirno mesečno omejitvijo porabe — tako 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 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 odgovori na podlagi te dokumentacije, ponudi navodila po korakih, ki poudarijo dejanske kontrolnike, ter lahko ponovi katerega koli od vodenih ogledov. To je najhitrejši način, da najdete kontrolnik, omenjen na tej strani. Glejte Vprašajte kopilota v aplikaciji.

Povežite vse skupaj