Osnovni pojmovi

Pregled svega na platformi — što svaki objekt radi, 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 karta: svaki pojam s kojim ćete se susresti, po jedan kratki odjeljak, 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 objasniti.

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

Organizacije#

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

API ključ sk_live_ koji izradite u odjeljku Organizacija → Ključevi povezan je s jednom organizacijom. Ta povezanost čini REST API tako jednostavnim: nikada ne stavljate ID organizacije u URL putanje jer je vaš ključ već identificira.

Na nadzornoj ploči: birač 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 kao što su preusmjeravanja, pritisci tipki i prekidi poziva, koje su obični redci prompta, a ne zasebna konfiguracija.
• Razinu pogona (spark, bolt, storm-*): Spark je optimiziran za trošak, Bolt za brzinu, a Storm za inteligentno rješavanje složenih promptova.
• Glas te primarni jezik i neobavezne dodatne jezike — agent se automatski prebacuje kada pozivatelj promijeni jezik. Pogledajte podržane jezike.
• Povezane mogućnosti: povezane aplikacije, API veze, baze znanja, MCP poslužitelji i ugrađeni funkcijski alati.
• Postavke ponašanja: redoslijed govora, način potvrđivanja, pozadinska snimka, vremensko ograničenje čekanja.

Uređivanja u alatu za izradu automatski se spremaju u skicu; ništa ne postaje aktivno dok ne kliknete Objavite. Svaka objava snima se u kartici Povijest alata za izradu, pa 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ćne funkcije za prompt.

Glasovi#

Biblioteka glasova sadrži glasove koje agent može koristiti, njihove uzorke koje možete preslušati, kompatibilne jezike, grupiranja prema spolu i naglasku te sve dodatne naknade za premium glasove/jezike. Plaćeni alat za isprobavanje 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, prikazuju se u istom biraču agenata 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 prema agentu (te može podržavati odlazne pozive). Dva izvora:

• ThunderPhone brojevi — stvarni brojevi u SAD-u dodijeljeni iz ThunderPhoneovog skupa, aktivni u roku od nekoliko sekundi, $1/mjesec plus dodatnih 1¢/minuti. Samo za dolazne pozive; za odlazne je potreban vlastiti pružatelj usluga. Organizacija prema zadanim postavkama može imati 25 brojeva.
• VoIP brojevi — dodaju se od vlastitog pružatelja putem VoIP veze. Twilio i Telnyx povezuju se izravno (Telnyx ima vođeno postavljanje); SignalWire i Vonage uskoro stižu — trenutačno ih možete koristiti putem ručne SIP konfiguracije, koja prihvaća bilo koji SIP trunk. Nakon uvoza i provjere VoIP brojevi podržavaju dolazne i odlazne pozive.

Svaki red broja omogućuje postavljanje načina usmjeravanja, odabir agenta za dolazne pozive i označavanje broja.

Na nadzornoj ploči: Telefonski brojevi (/dashboard/phone-numbers). Pogledajte Nabavite 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 označenim ulogama, strukturiranu povijest razmjena (uključujući pozive alata), snimku, ukupan iznos naplate te opcionalno AI ocjenjivanje i izvješća o problemima.

Dok je poziv aktivan, možete ga otvoriti i slušati — uključujete se nečujno i nitko u pozivu vas ne čuje. Nakon uključivanja u slušanje 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živo.

Na nadzornoj ploči: Povijest poziva (/dashboard/call-history) za arhivu i pojedinosti o svakom pozivu; 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 prikaz je povijesti poziva samo za čitanje, prilagođen robnoj marki, za vanjskog klijenta. Administratori organizacije odabiru agente čiji se pozivi prikazuju, dodaju odobrene e-adrese pregledavatelja, prenose logotip i boju naglaska te po želji potvrđuju prilagođenu domenu. Pregledavatelji portala mogu pregledavati pojedinosti poziva, transkripte i dostupne snimke bez 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 administrativno upravljanje.

Web-widgeti#

Web-widget posjetiteljima vaše web-lokacije omogućuje razgovor s glasovnim agentom putem mikrofona — telefonski broj nije potreban. Autentificira se javnim ključem (pk_live_...) koji je zaključan na izvore vaših dopuštenih domena, pa je siguran za upotrebu u kodu na strani klijenta.

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 za svaki poziv). Sesije widgeta prolaze kroz istu infrastrukturu za pozive kao i telefonski pozivi.

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

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 uvezite web-stranice putem URL-a, a zatim priložite bazu znanja agentu u alatu za izradu. Agent je pretražuje ugrađenim alatom za pretraživanje kad god to razgovor zahtijeva.

Na nadzornoj ploči: Znanje (/dashboard/knowledge) za biblioteku dokumenata; odjeljak Znanje u alatu za izradu za priloživanje baze agentu. Pogledajte Dodijelite agentu bazu znanja.

Povezivanja#

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

• Aplikacije (/dashboard/app-connections) — OAuth povezivanja sa Slackom, HubSpotom, Salesforceom, Google Calendarom, Google Sheetsom i Cal.comom. Povežite ih jednom, a zatim alate za pojedinačne radnje (objava Slack poruke, stvaranje ili ažuriranje HubSpot kontakta, rezervacija termina na Cal.comu…) uključite za bilo kojeg agenta. Pogledajte Povežite aplikacije.
• API-ji (/dashboard/api-connections) — pretvorite bilo koji HTTP API u radnju agenta. Zalijepite naredbu cURL, a AI čarobnjak izradit će nacrt definicije alata, ili je izradite ručno; gumb Testirajte zahtjev pokreće poziv u izoliranom okruženju prije puštanja u rad. Pogledajte API povezivanja — prikaz na nadzornoj ploči za /v1/integrations.
• MCP (/dashboard/mcp-connections) — dodajte poslužitelj Model Context Protocol putem URL-a i dopustite agentu da upotrebljava 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, pregledavati pozive i prijepise te upućivati pozive. Pogledajte Upotrebljavajte 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 polazni broj te postavite vremenski prozor pozivanja (dane i sate, uz podršku za vremenske zone), istodobnost i pravila ponavljanja (maksimalan broj pokušaja i koji se ishodi — nema odgovora, govorna pošta, neuspjeh — ponavljaju). Kampanja prolazi kroz popis i bilježi svaki poziv u Povijesti poziva.

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

Za jednokratne programatske pozive: API za odlazne pozive.

Praćenje uživo#

Uživo prikazuje svaki poziv koji je u tijeku u cijeloj organizaciji i omogućuje vam da otvorite bilo koji od njih kako biste ga 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 telekomunikacijski put, stvarni transkript, stvarno ocjenjivanje — tako da možete testirati prije (i nakon) objave. Usmjerite je na agenta ili telefonski broj, sami napišite scenarij pozivatelja ili generirajte scenarije s AI-jem na temelju prompta agenta (uključujući rubne slučajeve, ako to zatražite) i pratite poziv uživo.

Scenariji se grupiraju u pakete koji utvrđuju minimalnu stopu prolaznosti i mogu blokirati izdanja u CI-ju; regresije u odnosu na prihvaćenu osnovnu vrijednost prijavljuju se za svaki scenarij.

Na nadzornoj ploči: Simulacije (/dashboard/simulations), kao i gumb Simulacija unutar alata za izradu agenta. Pogledajte Simuliranje poziva.

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

Validacijski skupovi#

Validacijski skup pretvara stvarne trenutke poziva u ponovljive provjere regresije s jednim potezom. Svaki primjer zamrzava kontekst razgovora, relevantni zvuk pozivatelja, izvorni odgovor i očekivano ponašanje. Ponovna pokretanja izvršavaju se nad trenutnim 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: Validacijski skupovi (/dashboard/validation) za skup podataka organizacije i kartica Validacija u alatu za izradu agenta za pokretanja. Pogledajte Validacijski skupovi.

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

Eksperimenti#

Eksperiment provodi A/B testiranje konfiguracija agenta na stvarnom prometu: definirajte varijante (različite promptove, motore ili postavke), podijelite promet među njima i usporedite ishode po varijanti. Upotrijebite ga umjesto ručne izrade logike segmentiranja u webhooku.

Na nadzornoj ploči: Eksperimenti (/dashboard/experiments) i kartica A/B u alatu za izradu 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 ozbiljnost, izvor i status, a stranica Problemi red za trijažu: filtrirajte, pregledajte problematični poziv i pratite ispravke.

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

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

Izvještaji#

Izvještaj odgovara na pitanje na prirodnom jeziku o vašim podacima o pozivima ("Koja su bila tri glavna razloga zbog kojih su pozivatelji prošli tjedan tražili čovjeka?") analizom koju je izradio AI, ograničenom na agente i raspon datuma koje odaberete.

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

Praćenje#

Praćenje je površina za metrike: opseg poziva, ishodi i kvaliteta tijekom vremena, s filtriranjem prema agentu i vremenskom prozoru te izvozom za daljnju analizu.

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

Upozorenja#

Pravilo upozorenja prati metriku (stopu uspjeha, stopu neuspjeha, prosječnu ocjenu, opseg poziva, regresije paketa) tijekom vremenskog prozora i aktivira se kada prijeđe vaš prag. Obavijesti se šalju e-poštom i u Slack 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 vašem poslužitelju kada se događaji odvijaju tijekom i nakon poziva. Postoje dva modela isporuke:

• Krajnje točke webhookova (preporučeno): upravljajte mnogim URL-ovima na /v1/developer/webhook-endpoints s tajnama za svaku krajnju točku i pretplatama na događaje za svaku krajnju točku.
• 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 kategorije:

• 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). Za odgovor imate do 10 sekundi; pri isteku vremena poziv obrađuje statički dodijeljeni agent.
• Neblokirajući događaji obavijesti su koje se šalju bez čekanja odgovora i ponovno pokušavaju uz eksponencijalno odgađanje — pogledajte semantiku isporuke.

Svaki zahtjev sadrži HMAC-SHA256 potpis u zaglavlju X-ThunderPhone-Signature. Pogledajte provjeru potpisa.

Funkcijski alati#

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

Agenti imaju i ugrađene mogućnosti poziva — preusmjeravanje poziva, slanje unosa tipkovnice (DTMF), prekid poziva, čekanje na vezi — koje omogućujete običnim recima uputa umjesto definicijama alata.

Na nadzornoj ploči: odjeljak API veze u alatu za izradu (pogledajte Veze).

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

Tim i uloge#

Svaka organizacija ima popis članova s dvjema ulogama: Članovi izrađuju i upravljaju agentima; Administratori također upravljaju 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 nadzornoj 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 po agentovoj cijeni po minuti (razina mehanizma uz dodatne naknade — alat za izradu uživo prikazuje ukupnu cijenu dok mijenjate postavke, a odabrani dodatni jezici dodaju 3¢/min). Kada saldo dosegne nulu, dolazni se pozivi 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 da se poziv nikada ne prekine usred rečenice.

Na nadzornoj 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#

Nadzorna ploča uključuje ugrađeni kopilot — pitajte ga „kako mogu X” i odgovorit će na temelju ove dokumentacije, ponuditi vodiče korak po korak koji ističu stvarne kontrole te može ponovno pokrenuti bilo koji od vođenih obilazaka. To je najbrži način da pronađete kontrolu spomenutu na ovoj stranici. Pogledajte Pitajte kopilota u aplikaciji.

Kako sve povezati#