ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Getting Started

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 starega prikaza 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 Integracije → Ključi API (meni organizacije; Organizacija → Ključi v starem pogledu), je vezan na eno organizacijo. Zaradi te vezave je REST API tako preprost: ID-ja organizacije nikoli ne navedete v poteh URL, saj ga 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.
  • Njegove nastavitve: inteligenca (Core ali Pro), poslušanje (Lite, Standard, Plus ali Max) in hitrost odgovarjanja, ki uravnotežijo stroške, hitrost in natančnost.
  • Glas ter primarni jezik in izbirni dodatni jeziki — agent samodejno preklopi, ko klicatelj spremeni jezik. Glejte Podprti jeziki.
  • Priložene zmogljivosti: povezane aplikacije, povezave API, baze znanja, strežniki MCP in vdelana funkcijska orodja.
  • Nastavitve vedenja: vrstni red govora, način potrjevanja, zvočno ozadje, č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, razvrstitve po spolu in naglasu ter informacije o tem, kateri glasovi so premijski. Plačljivi preizkuševalnik lahko sintetizira vašo lastno frazo z 1–500 znaki, preden izberete.

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, dodeljene iz nabora ThunderPhone, aktivne v nekaj sekundah, $1/mesec; njihove klicne minute se zaračunavajo kot telefonska linija. Sprva podpirajo le dohodne klice. Skrbnik organizacije lahko zahteva odhodno klicanje na strani Telefonske številke; ThunderPhone vsako zahtevo pregleda ročno, odobrene številke pa lahko opravljajo klice in izvajajo kampanje. Organizacija jih lahko privzeto ima 25.
  • Številke VoIP — pridobljene pri vašem lastnem ponudniku prek povezave VoIP. Twilio in Telnyx se povežeta neposredno s ključem API (Telnyx ponuja tudi vodeno nastavitev novega računa); SignalWire, Vonage, Plivo in kateri koli drug SIP-trunk se povežejo prek nastavitve SIP, ročne konfiguracije SIP. Po uvozu in preverjanju številke VoIP 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.

Če uvoz dokumenta ne uspe, ga lahko poskusite znova uvoziti. Pri dokumentih spletnih strani lahko stran tudi osvežite, da jo znova pridobite. Če izbrišete zbirko znanja, se njeni dokumenti ohranijo in odklopijo od te zbirke. Agenti, ki so uporabljali zbirko, teh dokumentov ne vidijo več, razen če jih neposredno povežete z njimi.

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 s storitvami HubSpot, Salesforce, Google Calendar, Google Sheets in Cal.com. Povežite jih enkrat, nato pa za posamezne operacije vklopite orodja (posodobitev ali vstavljanje stika v HubSpot, 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 in čarovnik z umetno inteligenco pripravi osnutek definicije orodja, lahko pa jo ustvarite ročno; gumb Preizkusi zahtevo pred uvedbo izvede klic v peskovniku. Glejte Povezave API — nadzorno ploščo 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 izpostavlja. 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; pri vsakem klicu se z dobroimetja odštejejo stroški njegovih delov po cenikih naših ponudnikov ter infrastrukturna pristojbina in 17–25-% marža (glejte cenik). Ko dobroimetje doseže nič, se dohodni klici zavrnejo, 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