Osnovni koncepti

ThunderPhone je cjelovita platforma za izradu, pokretanje i poboljšavanje glasovnih AI agenata. Ova je stranica pregled: svaki koncept s kojim ćete se susresti, u jednom kratkom odjeljku, s prikazom na upravljačkoj ploči i API-jem koji ga podržava. Jednom je preletite, a zatim joj se vratite kad god neki pojam zahtijeva dodatno objašnjenje.

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

Organizacije

Organizacija je jedinica višezakupnosti. 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 povezivanje čini REST API tako jednostavnim: ID organizacije nikada ne unosite u URL putanje jer ga vaš ključ već identificira.

Na upravljačkoj ploči: prebacivač organizacija (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 na tipkovnici 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 te primarni jezik i neobavezne dodatne jezike — agent se automatski prebacuje kada pozivatelj promijeni jezik. Pogledajte Podržani jezici.
• Pridruž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 u kartici Povijest alata za izradu, tako da možete pregledati i vratiti bilo koju prethodnu verziju.

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

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

Glasovi

Biblioteka glasova sadrži glasove koje agent može upotrebljavati, njihove uzorke koji se mogu reproducirati, kompatibilne jezike, grupiranja prema spolu i naglasku te sve dodatne naknade za premium glasove/jezike. Naplativi 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 su spremni, prikazuju 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 prema agentu (a može se upotrebljavati i za odlazne pozive). Dva izvora:

• Demonstracijski brojevi — stvarni američki brojevi dodijeljeni iz ThunderPhoneovog skupa, aktivni u roku od nekoliko sekundi. Samo za dolazne pozive, javljaju se kratkom izgovorenom obavijesti, a nadzorna ploča ograničava organizaciju na njih 10. Prikladni su za prvo testiranje; nisu za produkciju.
• VoIP brojevi — preneseni od vlastitog pružatelja usluge putem VoIP veze. Twilio i Telnyx povezuju se izravno (Telnyx ima vođeno postavljanje); SignalWire i Vonage uskoro dolaze — danas ih možete povezati ručnom SIP konfiguracijom, koja prihvaća bilo koji SIP trunk. Nakon uvoza i potvrde, VoIP brojevi podržavaju dolazne i odlazne pozive.

Svaki redak broja omogućuje postavljanje načina usmjeravanja, odabir agenta za dolazne pozive i dodavanje oznake broju.

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 cjeloviti transkript s oznakama uloga, strukturiranu povijest izmjena (uključujući pozive alata), snimku, ukupan 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 odmah izvršava.

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 je prikaz povijesti poziva samo za čitanje, prilagođen brendu vanjskog klijenta. Administratori organizacije odabiru agente čiji se pozivi prikazuju, dodaju odobrene e-adrese pregledavatelja, učitavaju logotip i boju naglaska 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 administrativno sučelje upravljanja.

Web widgeti

Web widget posjetiteljima vaše web-lokacije omogućuje razgovor s agentom putem mikrofona — telefonski broj nije potreban. Autentificira se pomoću objavljivog ključa (pk_live_...) koji je ograničen na izvor vaših dopuštenih domena, pa ga je sigurno koristiti u kodu na klijentskoj strani.

Ključevi rade u jednom od dva načina: agent (statički vezan uz jednog agenta) ili webhook (vaš poslužitelj bira 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) — izradite 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 SDK widgeta.

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 prilaganje baze agentu. Pogledajte Dodajte bazu znanja svom agentu.

Povezivanja

Povezivanja su način na koji agenti pristupaju vanjskom svijetu. Četiri vrste, jedna skupina na bočnoj traci:

• Aplikacije (/dashboard/app-connections) — OAuth povezivanja sa Slackom, HubSpotom, Salesforceom, Google kalendarom, Google tablicama i Cal.comom. Povežite ih jednom, a zatim uključite alate za pojedinačne radnje (slanje Slack poruke, stvaranje ili ažuriranje HubSpot kontakta, rezerviranje 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 pokreće poziv u izoliranom okruženju prije objave. Pogledajte API povezivanja — inačicu za nadzornu ploču usluge /v1/integrations.
• MCP (/dashboard/mcp-connections) — dodajte poslužitelj protokola Model Context Protocol putem URL-a i omogućite agentu upotrebu alata koje izlaže. Pogledajte Dodajte MCP poslužitelj.
• VoIP (/dashboard/voip-connections) — vjerodajnice pružatelja za upotrebu vlastitih telefonskih brojeva. Pogledajte Povežite VoIP pružatelja.

ThunderPhone također nudi vlastitu MCP krajnju točku kako bi vanjski MCP klijent mogao prikazati popis agenata, pregledati pozive i transkripte 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 broj s kojeg se poziva te postavite vremenski prozor za pozivanje (dani i sati, uz vremensku zonu), broj istodobnih poziva i pravila ponovnih pokušaja (najveći broj pokušaja i ishode — nema odgovora, govorna pošta, neuspjeh — za koje se pokušaj ponavlja). Kampanja obrađuje popis i bilježi svaki poziv u Povijesti poziva.

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

Za jednokratne programske pozive: 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 ga slušali i šaptom se uključili u stvarnom vremenu. To je sučelje 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 put telefonije, 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 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 postavljaju 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) te gumb Simulacija u alatu za izradu agenta. Pogledajte Simuliranje poziva.

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

Skupovi za provjeru

Skup za provjeru pretvara stvarne trenutke poziva u ponovljive provjere regresija s jednim korakom. Svaki primjer zamrzava kontekst razgovora, relevantni zvuk pozivatelja, izvorni odgovor i očekivano ponašanje. Ponovna pokretanja izvode 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: Skupovi za provjeru (/dashboard/validation) za skup podataka organizacije i kartica Provjera u alatu za izradu agenta za pokretanja. Pogledajte Skupove za provjeru.

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, pogone ili postavke), raspodijelite promet među njima i usporedite rezultate za svaku varijantu. Upotrijebite ga umjesto ručne izrade logike raspodjele u webhooku.

Na nadzornoj ploči: Eksperimenti (/dashboard/experiments) i kartica A/B u alatu za izradu agenta. Pogledajte Eksperimente (A/B testiranje).

Problemi

Problem je označeni problem na određenom pozivu — prijavio ga je ljudski pregledavatelj 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 po pozivu u Povijesti poziva. Pogledajte Trijažu problema.

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

Izvješća

Izvješće odgovara na pitanje na prirodnom jeziku o vašim podacima o pozivima ("Koja su bila tri najčešća razloga zbog kojih su pozivatelji prošlog tjedna tražili čovjeka?") analizom koju je napisao AI, ograničenom na agente i raspon datuma koji odaberete.

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

Opservabilnost

Opservabilnost je prikaz metrika: broj poziva, ishodi i kvaliteta tijekom vremena, uz filtriranje prema agentu i vremenskom rasponu te izvoz za daljnju analizu.

Na nadzornoj ploči: Opservabilnost (/dashboard/observability). Pogledajte Opservabilnost.

Upozorenja

Pravilo upozorenja prati metriku (stopu uspješnosti, stopu neuspjeha, prosječnu ocjenu, broj poziva, regresije paketa) tijekom vremenskog raspona i aktivira se kada prijeđe vaš prag. Obavijesti se šalju e-poštom i na 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 na vaš poslužitelj kada se događaji zbivaju tijekom i nakon poziva. Dva modela isporuke:

• Krajnje točke webhookova (preporučeno): upravljajte mnogim URL-ovima na /v1/developer/webhook-endpoints uz tajne za svaku krajnju točku i pretplate 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; u slučaju isteka vremena poziv obrađuje statički dodijeljeni agent.
• Neblokirajući događaji obavijesti su koje se šalju bez čekanja odgovora i ponovno pokušavaju isporuku uz eksponencijalno povećanje intervala — pogledajte semantiku isporuke.

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

Funkcijski alati

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

Agenti također uključuju ugrađene mogućnosti poziva — preusmjeravanje poziva, slanje unosa tipkovnice (DTMF), završavanje poziva, čekanje na vezi — koje omogućujete običnim redcima u promptu 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 dvije uloge: Č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 prema cijeni agenta po minuti (razina pogona i 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 — kako poziv nikada ne bi prekinuo 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 detaljne vodiče korak po korak koji ističu stvarne kontrole te može ponovno pokrenuti bilo koji vođeni obilazak. To je najbrži način za pronalaženje kontrole spomenute na ovoj stranici. Pogledajte Pitajte kopilota u aplikaciji.

Kako sve povezati