Osnovni koncepti

Pregled svega na platformi — čemu služi svaki objekt, gdje se nalazi na nadzornoj ploči i koji ga API koristi.

ThunderPhone je cjelovita platforma za izradu, pokretanje i unaprjeđivanje AI glasovnih agenata. Ova je stranica pregled: svaki pojam s kojim ćete se susresti, po jedan kratki odjeljak za svaki, uz sučelje nadzorne ploče i API koji ga podržava. Jednom je preletite, a zatim se vratite kad god neki pojam treba dodatno pojasniti.

Bočna traka nadzorne ploče odražava ovu strukturu:

Organizacije#

Organizacija je jedinica zakupa. Svaki drugi resurs — agenti, telefonski brojevi, pozivi, ključevi — pripada točno jednoj organizaciji. Vaš račun može pripadati mnogim organizacijama; svaka ima vlastito stanje računa, vlastite ključeve i vlastiti popis članova.

API ključ sk_live_ koji izradite u odjeljku Organizacija → Ključevi vezan je uz jednu organizaciju. To vezivanje čini REST API tako jednostavnim: nikada ne stavljate ID organizacije u URL putanje jer ga vaš ključ već identificira.

Na nadzornoj ploči: prebacivač organizacije (u podnožju bočne trake) i postavke Organizacija — kartice Moj račun, Općenito, Ključevi, Upozorenja, Postavke naplate i Povijest naplate. Pogledajte referencu postavki organizacije.

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

Agenti#

Agent je AI konfiguracija koja pokreće poziv. Obuhvaća:

• Prompt koji određuje što agent govori i kako se ponaša — uključujući radnje poziva poput preusmjeravanja, pritisaka tipki i prekida poziva, koje su obični retci prompta, a ne zasebna konfiguracija.
• Razinu pogona (spark, bolt, storm-*): Spark je optimiziran za trošak, Bolt za brzinu, a Storm za inteligenciju pri složenim promptovima.
• Glas uz primarni jezik i neobavezne dodatne jezike — agent se automatski prebacuje kada pozivatelj promijeni jezik. Pogledajte Podržani jezici.
• Priložene mogućnosti: povezane aplikacije, API povezivanja, baze znanja, MCP poslužitelji i ugrađeni funkcijski alati.
• Postavke ponašanja: redoslijed govora, način potvrđivanja, pozadinska zvučna podloga, vremensko ograničenje čekanja.

Uređivanja u alatu za izradu automatski se spremaju kao skica; ništa ne postaje aktivno dok ne kliknete Objavite. Svaka objava sprema se kao snimka na kartici Povijest alata za izradu, tako da možete pregledati i vratiti bilo koju prethodnu verziju.

Na nadzornoj ploči: Glasovni agenti → alat za izradu agenta (/dashboard/agents). Pogledajte Izradite svoj prvi glasovni agent.

U API-ju: /v1/agents — CRUD, dupliciranje, prijenos, povijest verzija i pomoćnici za prompt.

Glasovi#

Biblioteka glasova sadrži glasove koje agent može koristiti, njihove uzorke koji se mogu reproducirati, kompatibilne jezike, grupiranja prema spolu i naglasak te sve dodatne naknade za premium glasove/jezike. Plaćeni alat za uzorkovanje može sintetizirati vlastitu frazu od 1 do 500 znakova prije odabira.

Organizacije koje ispunjavaju uvjete mogu izraditi i prilagođene glasove iz kratkog WAV ili MP3 uzorka. Prilagođeni glasovi imaju kvotu i asinkroni status izrade; kada budu spremni, pojavljuju se u istom biraču agenta kao i glasovi iz biblioteke.

Na nadzornoj ploči: Glasovi (/dashboard/voices). Pogledajte Biblioteka glasova i prilagođeni glasovi.

U API-ju: /v1/voices, uzorci glasova i prilagođeni glasovi.

Telefonski brojevi#

Telefonski broj pripada organizaciji i usmjerava dolazne pozive agentu (a može se koristiti i za odlazne pozive). Dva izvora:

• ThunderPhone brojevi — stvarni brojevi iz SAD-a dodijeljeni iz ThunderPhoneova fonda, aktivni za nekoliko sekundi, $1/mjesečno uz naknadu od 1¢/minuti. U početku služe samo za dolazne pozive. Administrator organizacije može zatražiti odlazne pozive na stranici Telefonski brojevi; ThunderPhone ručno pregledava svaki zahtjev, a odobreni brojevi mogu upućivati pozive i pokretati kampanje. Organizacija prema zadanim postavkama može imati 25 brojeva.
• VoIP brojevi — dodani od vlastitog pružatelja putem VoIP veze. Twilio i Telnyx povezuju se izravno API ključem (Telnyx nudi i vođeno postavljanje novog računa); SignalWire, Vonage, Plivo i bilo koji drugi SIP trunk povezuju se putem SIP postavljanja, odnosno ručne SIP konfiguracije. Nakon uvoza i potvrde, VoIP brojevi podržavaju dolazne i odlazne pozive.

Za svaki red broja možete postaviti način usmjeravanja, odabrati agenta za dolazne pozive i označiti broj.

Na nadzornoj ploči: Telefonski brojevi (/dashboard/phone-numbers). Pogledajte Dohvatite telefonski broj.

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

Pozivi#

Svaki dolazni poziv, odlazni poziv, simulacija i sesija widgeta postaje zapis poziva. Poziv sadrži potpuni transkript s oznakama uloga, strukturiranu povijest izmjena (uključujući pozive alata), snimku, ukupni iznos naplate te neobavezno AI ocjenjivanje i izvješća o problemima.

Dok je poziv aktivan, možete ga otvoriti i slušati — pridružujete se nečujno i nitko u pozivu vas ne čuje. Nakon početka slušanja možete šaptati: upišite uputu koja se usred poziva izravno šalje vašem agentu; pozivatelj je nikada ne čuje, a agent je slijedi u stvarnom vremenu.

Na nadzornoj ploči: Povijest poziva (/dashboard/call-history) za arhivu i pojedinosti svakog poziva; Uživo za pozive u tijeku. Pogledajte Pregledajte, slušajte i usmjeravajte svoje pozive.

U API-ju: /v1/calls — popis, transkript, povijest, zvuk, ocjenjivanje, izvoz; /v1/issue-reports.

Portali za klijente#

Portal za klijente brendirani je prikaz povijesti poziva samo za čitanje za vanjskog klijenta. Administratori organizacije odabiru agente čiji se pozivi prikazuju, dodaju e-adrese odobrenih pregledavatelja, učitavaju logotip i boju naglašavanja te po želji potvrđuju prilagođenu domenu. Pregledavatelji portala mogu pregledavati pojedinosti poziva, transkripte i dostupne snimke bez dobivanja pristupa nadzornoj ploči.

Na nadzornoj ploči: Portali za klijente (/dashboard/client-portals). Pogledajte Portali za klijente.

U API-ju: /v1/client-portals za administratorsko upravljanje.

Web-widgeti#

Web-widget posjetiteljima vaše web-lokacije omogućuje razgovor s agentom putem mikrofona — telefonski broj nije potreban. Autentificira se pomoću javnog ključa (pk_live_...) koji preglednici mogu upotrebljavati samo s vaših dopuštenih domena, pa je siguran za upotrebu u kodu na klijentskoj strani. Popis domena nije autentifikacija, a postavke sesije koje stranica može poslati isključene su dok ih ne dopustite na ključu.

Ključevi rade u jednom od dva načina: agent (statički povezan s jednim agentom) ili webhook (vaš poslužitelj odabire konfiguraciju za svakog posjetitelja — pogledajte Dinamička konfiguracija po pozivu). Sesije widgeta prolaze kroz istu infrastrukturu za pozive kao i telefonski pozivi.

Na nadzornoj ploči: Web-widgeti (/dashboard/web-widgets) — stvorite widgete, postavite način rada i agenta, upravljajte dopuštenim domenama i kopirajte isječak za ugradnju. Pogledajte Izradite web-widget.

U API-ju: /v1/publishable-key, /v1/mic-session i dokumentaciju za Widget SDK.

Baze znanja#

Baza znanja skup je dokumenata koje vaš agent može pretraživati tijekom poziva kako bi utemeljio svoje odgovore — prenesite datoteke, zalijepite tekst ili uvozite web-stranice putem URL-a, a zatim priložite bazu znanja agentu u graditelju. Agent je upituje ugrađenim alatom za pretraživanje kad god to razgovor zahtijeva.

Na nadzornoj ploči: Znanje (/dashboard/knowledge) za biblioteku dokumenata; odjeljak Znanje u graditelju za prilaganje baze agentu. Pogledajte Dodajte bazu znanja svom agentu.

Veze#

Veze omogućuju agentima pristup vanjskom svijetu. Četiri vrste, jedna grupa na bočnoj traci:

• Aplikacije (/dashboard/app-connections) — OAuth veze sa Slackom, HubSpotom, Salesforceom, Google kalendarom, Google tablicama i Cal.comom. Povežite jednom, a zatim uključite alate za pojedinačne radnje (objava Slack poruke, ažuriranje ili stvaranje HubSpot kontakta, rezervacija termina na Cal.comu…) za bilo kojeg agenta. Pogledajte Povežite aplikacije.
• API-ji (/dashboard/api-connections) — pretvorite bilo koji HTTP API u radnju agenta. Zalijepite cURL naredbu, a AI čarobnjak izrađuje nacrt definicije alata, ili je izradite ručno; gumb Testni zahtjev šalje poziv u izoliranom okruženju prije objave. Pogledajte API veze — sučelje nadzorne ploče za /v1/integrations.
• MCP (/dashboard/mcp-connections) — dodajte poslužitelj Model Context Protocol putem URL-a i omogućite agentu da koristi alate koje izlaže. Pogledajte Dodajte MCP poslužitelj.
• VoIP (/dashboard/voip-connections) — vjerodajnice pružatelja usluge za korištenje vlastitih telefonskih brojeva. Pogledajte Povežite VoIP pružatelja usluge.

ThunderPhone također izlaže vlastitu MCP krajnju točku kako bi vanjski MCP klijent mogao navesti agente, pregledati pozive i transkripte te upućivati pozive. Pogledajte Koristite ThunderPhone kao MCP poslužitelj.

U API-ju: /v1/integrations, /v1/mcp-servers i /v1/voip-connections; pogledajte i Izradite integraciju alata.

Kampanje#

Kampanja upućuje odlazne pozive u velikom opsegu: prenesite CSV s kontaktima, odaberite agenta i broj s kojeg se poziva te postavite prozor za pozivanje (dane i sate, uz podršku za vremenske zone), istodobnost i pravila ponovnih pokušaja (maksimalni broj pokušaja i ishode — nema odgovora, govorna pošta, neuspjelo — za koje se pokušaj ponavlja). Kampanja prolazi kroz popis i bilježi svaki poziv u povijest poziva.

Na nadzornoj ploči: Kampanje (/dashboard/campaigns). Pogledajte Pokrenite kampanju odlaznih poziva.

Za pojedinačne programatske pozive: koristite API za odlazne pozive.

Praćenje uživo#

Uživo prikazuje svaki poziv u tijeku u cijeloj organizaciji i omogućuje Vam da otvorite bilo koji od njih kako biste slušali i šaptali u stvarnom vremenu. To je površina za nadzor: pratite kako novi prompt prima prvi stvarni promet ili nadzirite aktivnu kampanju.

Na nadzornoj ploči: Uživo (/dashboard/live). Pogledajte Praćenje i nadzor poziva uživo.

Simulacije#

Simulacija je AI pozivatelj koji vodi stvarni razgovor s Vašim agentom — isti telefonski put, stvarni prijepis, stvarno ocjenjivanje — kako biste mogli testirati prije (i nakon) objave. Usmjerite je na agenta ili telefonski broj, sami napišite scenarij pozivatelja ili generirajte scenarije pomoću AI-ja iz prompta agenta (uključujući rubne slučajeve, ako ih zatražite) i pratite poziv uživo.

Scenariji se grupiraju u pakete koji postavljaju minimalnu stopu prolaznosti i mogu uvjetovati izdanja u CI-ju; regresije u odnosu na prihvaćenu osnovu prijavljuju se za svaki scenarij.

Na nadzornoj ploči: Simulacije (/dashboard/simulations) te gumb Simulacija u izrađivaču agenta. Pogledajte Simulirajte poziv.

U API-ju: /v1/test-calls i pokretač paketa — pogledajte Testirajte agenta od početka do kraja.

Skupovi za provjeru valjanosti#

Skup za provjeru valjanosti pretvara stvarne trenutke poziva u ponovljive provjere regresije s jednim korakom razgovora. Svaki primjer zamrzava kontekst razgovora, relevantni zvuk pozivatelja, izvorni odgovor i očekivano ponašanje. Ponovna pokretanja izvršavaju se nad trenutačnim nacrtom agenta bez upućivanja novog poziva, a dijalog za objavu može prikazati odgovara li najnovije pokretanje i dalje tom nacrtu.

Na nadzornoj ploči: Skupovi za provjeru valjanosti (/dashboard/validation) za skup podataka organizacije i kartica Provjera valjanosti u izrađivaču agenta za pokretanja. Pogledajte Skupovi za provjeru valjanosti.

U API-ju: /v1/validation-sets i krajnje točke za ponovno pokretanje agenta/primjera na istoj referentnoj stranici.

Eksperimenti#

Eksperiment A/B testira konfiguracije agenta na stvarnom prometu: definirajte varijante (različite promptove, pogone ili postavke), podijelite promet među njima i usporedite rezultate po varijanti. Upotrijebite ga umjesto ručne izrade logike raspodjele u webhooku.

Na nadzornoj ploči: Eksperimenti (/dashboard/experiments) i kartica A/B u izrađivaču agenta. Pogledajte Eksperimenti (A/B testiranje).

Problemi#

Problem je označeni problem na određenom pozivu — prijavio ga je ljudski recenzent ili ga je otkrilo AI ocjenjivanje. Problemi sadrže razinu ozbiljnosti, izvor i status, a stranica Problemi red je za trijažu: filtrirajte, pregledajte problematični poziv i pratite ispravke.

Na nadzornoj ploči: Problemi (/dashboard/issues) te označavanje za svaki poziv u Povijesti poziva. Pogledajte Trijaža problema.

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

Izvješća#

Izvješće odgovara na pitanje na prirodnom jeziku o podacima Vaših poziva ("Koja su bila tri najčešća razloga zbog kojih su pozivatelji prošli tjedan zatražili čovjeka?") analizom koju je napisao AI, ograničenom na agente i raspon datuma koje odaberete.

Na nadzornoj ploči: Izvješća (/dashboard/reports). Pogledajte Izvješća.

Praćenje#

Praćenje je površina za metrike: volumen poziva, ishodi i kvaliteta tijekom vremena, uz filtriranje prema agentu i vremenskom razdoblju te izvoz za naknadnu analizu.

Na nadzornoj ploči: Praćenje (/dashboard/observability). Pogledajte Praćenje.

Upozorenja#

Pravilo upozorenja prati metriku (stopu uspješnosti, stopu neuspjeha, prosječnu ocjenu, volumen poziva, regresije paketa) tijekom vremenskog razdoblja i aktivira se kada prijeđe Vaš prag. Obavijesti se šalju e-poštom i putem Slacka te aktiviraju događaj alert.triggered za Vaše krajnje točke webhooka.

Na nadzornoj ploči: Organizacija → Upozorenja. Pogledajte Upozorenja.

Webhookovi#

ThunderPhone šalje HTTP POST webhookove na Vaš poslužitelj kada se događaji odvijaju tijekom i nakon poziva. Dva modela isporuke:

• Webhook krajnje točke (preporučeno): upravljajte mnogim URL-ovima na /v1/developer/webhook-endpoints s tajnama po krajnjoj točki i pretplatama na događaje po krajnjoj točki.
• Naslijeđeni webhook s jednim URL-om: jedan URL po organizaciji. Njime se upravlja na /v1/webhook ili u odjeljku Organizacija → Općenito. Zadržan je radi kompatibilnosti sa starijim verzijama.

Događaji se dijele u dvije klase:

• Blokirajući događaji očekuju da vaš poslužitelj odgovori konfiguracijom koja oblikuje poziv u tijeku — to su događaji dolaznog poziva (telephony.incoming / web.incoming). Telefonski poziv čeka do 13 sekundi, uključujući jedan ponovni pokušaj, a sesija widgeta 10 sekundi. Ne postoji zamjenski agent: bez upotrebljive konfiguracije telefonski se poziv prekida, a sesija widgeta ne uspijeva.
• Neblokirajući događaji obavijesti su koje se šalju bez čekanja na odgovor, uz ponovne pokušaje s eksponencijalnim odgodama — pogledajte semantiku isporuke.

Svaki zahtjev sadrži vremenski označen potpis HMAC-SHA256 u X-ThunderPhone-Signature-V2, kao i naslijeđeni potpis koji obuhvaća samo tijelo X-ThunderPhone-Signature. Pogledajte provjeru potpisa.

Alati funkcija#

Alat funkcije HTTP je krajnja točka koju Vaš agent može pozvati usred razgovora. ThunderPhoneu dajete shemu funkcije u stilu OpenAI-ja i URL krajnje točke; agent odlučuje kada će je pozvati, a ThunderPhone sa svojih poslužitelja šalje potpisani HTTP zahtjev i vraća rezultat agentu.

Agenti uključuju i ugrađene mogućnosti poziva — preusmjeravanje poziva, slanje unosa tipkovnice (DTMF), završavanje poziva, čekanje na vezi — koje omogućujete jednostavnim redovima u promptu umjesto definicijama alata.

Na upravljačkoj ploči: odjeljak sastavljača API veze (pogledajte Veze).

U API-ju: /v1/integrations i specifikacija alata funkcija.

Tim i uloge#

Svaka organizacija ima popis članova s dvjema ulogama: Članovi izrađuju i upravljaju agentima; Administratori upravljaju i timom i naplatom. Pozovite e-poštom — pozivnice istječu nakon 7 dana i mogu se opozvati; izbornik ⋯ u retku člana mijenja uloge ili uklanja osobu. Jedinstvena prijava može se konfigurirati za cijelu organizaciju — pogledajte SSO.

Na upravljačkoj ploči: Organizacija → Općenito. Pogledajte Pozovite svoj tim.

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

Naplata#

ThunderPhone je unaprijed plaćen. Svaka organizacija ima saldo u USD; pozivi ga terete prema cijeni agenta po minuti (razina mehanizma i dodatne naknade — sastavljač prikazuje ukupnu cijenu uživo dok mijenjate postavke, a odabrani dodatni jezici dodaju 3 ¢/min). Kada saldo dosegne nulu, dolazni pozivi se odbijaju, a odlazni pozivi vraćaju 402 Payment Required.

Dopunite saldo ručno ili omogućite automatsku dopunu s pragom salda, iznosom dopune i neobaveznim mjesečnim ograničenjem potrošnje — tako poziv nikada ne prekida usred rečenice.

Na upravljačkoj ploči: Organizacija → Postavke naplate i Povijest naplate. Pogledajte Dodajte sredstva i uključite automatsku dopunu, kao i potpunu referencu cijena.

U API-ju: /v1/billing.

Kopilot u aplikaciji#

Upravljačka ploča uključuje ugrađeni kopilot — pitajte ga „kako mogu X” i odgovorit će na temelju ove dokumentacije, ponuditi detaljna uputstva klik po klik koja ističu stvarne kontrole te može ponovno pokrenuti bilo koji od vođenih obilazaka. To je najbrži način za pronalaženje kontrole spomenute na ovoj stranici. Pogledajte Pitajte kopilota u aplikaciji.

Sve zajedno#