---
title: "Osnovni pojmovi"
description: "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:
[Agenti](#agents), [glasovi](#voices), [telefonski brojevi](#phone-numbers),
[web-widgeti](#web-widgets), [pozivi](#calls),
[klijentski portali](#client-portals), [znanje](#knowledge-bases).
[Praćenje uživo](#live-monitoring) i odlazne
[kampanje](#campaigns).
[Aplikacije, API-ji, MCP poslužitelji i VoIP pružatelji](#connections) koje
vaši agenti mogu koristiti.
[Simulacije](#simulations), [skupovi za provjeru](#validation-sets),
[eksperimenti](#experiments),
[problemi](#issues), [izvješća](#reports),
[promatranje](#observability).
[Tim i uloge](#team-and-roles), [API ključevi](#organizations),
[upozorenja](#alerts), [naplata](#billing).
[Webhookovi](#webhooks) i [funkcijski alati](#function-tools) za
vlastiti kod.
---
## 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](/hr/guides/organization-settings).
**U API-ju:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/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](/hr/guides/supported-languages).
- Povezane mogućnosti: [povezane aplikacije](#connections),
[API veze](#connections), [baze znanja](#knowledge-bases),
[MCP poslužitelji](#connections) i ugrađeni
[funkcijski alati](#function-tools).
- 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](/hr/guides/build-an-agent).
**U API-ju:** [`/v1/agents`](/api-reference/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](/hr/guides/voice-library).
**U API-ju:** [`/v1/voices`](/api-reference/voices),
[uzorci glasova](/api-reference/voice-samples) i
[prilagođeni glasovi](/api-reference/custom-voices).
---
## 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, {/* rate:phone */}$1/mjesec plus dodatnih 1¢/minuti{/* /rate */}.
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](#connections). 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](/hr/guides/get-a-phone-number).
**U API-ju:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/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](/hr/guides/review-calls).
**U API-ju:** [`/v1/calls`](/api-reference/calls) — popis, transkript,
povijest, zvuk, ocjenjivanje, izvoz;
[`/v1/issue-reports`](/api-reference/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](/hr/guides/client-portals).
**U API-ju:** [`/v1/client-portals`](/api-reference/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](/hr/guides/dynamic-call-config)). 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](/hr/guides/embed-a-web-widget-dashboard).
**U API-ju:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) i
[dokumentaciju za Widget SDK](/hr/widget/overview).
---
## 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](/hr/guides/knowledge-base).
---
## 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](/hr/guides/connect-apps).
- **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](/hr/guides/api-connections) — prikaz na nadzornoj ploči za
[`/v1/integrations`](/api-reference/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](/hr/guides/mcp-servers).
- **VoIP** (`/dashboard/voip-connections`) — vjerodajnice pružatelja usluge za
[korištenje vlastitih telefonskih brojeva](#phone-numbers). Pogledajte
[Povežite VoIP pružatelja usluge](/hr/guides/voip-providers).
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](/hr/guides/thunderphone-mcp-server).
**U API-ju:** [`/v1/integrations`](/api-reference/integrations),
[`/v1/mcp-servers`](/api-reference/mcp-servers) i
[`/v1/voip-connections`](/api-reference/voip-connections); pogledajte i
[Izradite integraciju alata](/hr/guides/build-tool-integration).
---
## 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](/hr/guides/outbound-campaigns).
**Za jednokratne programatske pozive:**
[API za odlazne pozive](/hr/guides/place-outbound-calls).
## 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](#calls) 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](/hr/guides/monitor-live-calls).
---
## 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](/hr/guides/simulate-a-call).
**U API-ju:** [`/v1/test-calls`](/api-reference/test-calls) i pokretač paketa — pogledajte [Testiranje agenta od početka do kraja](/hr/guides/test-agents).
---
## 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](/hr/guides/validation-sets).
**U API-ju:** [`/v1/validation-sets`](/api-reference/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)](/hr/guides/experiments-ab-testing).
---
## 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](/hr/guides/issues).
**U API-ju:** [`/v1/issue-reports`](/api-reference/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](/hr/guides/reports).
---
## 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](/hr/guides/observability).
---
## 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](/hr/webhooks/endpoints).
**Na nadzornoj ploči:** **Organizacija → Upozorenja**. Pogledajte [Upozorenja](/hr/guides/alerts).
---
## 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`](/hr/webhooks/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`](/api-reference/organizations#legacy-single-url-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](/hr/webhooks/call-incoming)
(`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](/hr/webhooks/overview).
Svaki zahtjev sadrži HMAC-SHA256 potpis u zaglavlju
`X-ThunderPhone-Signature`. Pogledajte
[provjeru potpisa](/hr/webhooks/overview).
---
## 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](#connections)).
**U API-ju:** [`/v1/integrations`](/api-reference/integrations) i
[specifikacija funkcijskih alata](/hr/tools/overview).
---
## 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](/hr/guides/sso).
**Na nadzornoj ploči:** **Organizacija → Općenito**. Pogledajte
[Pozovite svoj tim](/hr/guides/invite-your-team).
**U API-ju:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/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](/hr/guides/supported-languages) dodaju {/* rate:language */}3¢/min{/* /rate */}). 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](/hr/guides/billing-and-topups), kao i
[potpunu referencu cijena](/hr/guides/pricing).
**U API-ju:** [`/v1/billing`](/api-reference/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](/hr/guides/ask-the-copilot).
---
## Kako sve povezati
Čarobnjak u pet koraka: agent → naplata → broj → simulacija → pregled.
Isti prvi poziv u četiri REST poziva.
Izradite agenta, uplatite sredstva, nabavite broj, simulirajte i pregledajte pozive.
OAuth aplikacije, prilagođeni API-ji, MCP poslužitelji i VoIP pružatelji usluga.
Izvješća, nadziranost, eksperimenti, problemi i upozorenja.
Pozivnice i uloge, API ključevi, sigurnost i SSO.
API recepti: dolazni pozivi, odlazni pozivi, dinamička konfiguracija, alati, testiranje.
Jednom ispravno postavite HMAC provjeru i ponovno je upotrebljavajte svugdje.