---
title: "Osnovni koncepti"
description: "Pregled vsega na platformi — kaj počne posamezen objekt, kje se nahaja na nadzorni plošči in kateri API ga uporablja."
---
ThunderPhone je celovita platforma za gradnjo, zagon in izboljševanje
glasovnih agentov z UI. Ta stran je zemljevid: vsak pojem, s katerim se boste srečali, je predstavljen
v kratkem razdelku, skupaj s površino na nadzorni plošči in API-jem, ki ga podpira. Enkrat jo na hitro preglejte, nato pa se nanjo vrnite, kadar želite razjasniti izraz.
Stranska vrstica nadzorne plošče odraža to strukturo:
[Agenti](#agents), [glasovi](#voices), [telefonske številke](#phone-numbers),
[spletni gradniki](#web-widgets), [klici](#calls),
[portali za stranke](#client-portals), [baze znanja](#knowledge-bases).
[Spremljanje v živo](#live-monitoring) in odhodne
[kampanje](#campaigns).
[Aplikacije, API-ji, strežniki MCP in ponudniki VoIP](#connections), ki jih lahko uporabljajo
vaši agenti.
[Simulacije](#simulations), [nabori za preverjanje](#validation-sets),
[poskusi](#experiments),
[težave](#issues), [poročila](#reports),
[opazljivost](#observability).
[Ekipa in vloge](#team-and-roles), [ključi API](#organizations),
[opozorila](#alerts), [obračunavanje](#billing).
[Spletne kljuke](#webhooks) in [funkcijska orodja](#function-tools) za
vašo lastno kodo.
---
## 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 **Organizacija → Ključi**,
je vezan na eno organizacijo. Ta vezava omogoča tako plosko strukturo REST API-ja:
ID-ja organizacije nikoli ne vključite v poti URL, saj ga vaš ključ že določa.
**Na nadzorni plošči:** izbirnik organizacije (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](/sl/guides/organization-settings).
**V API-ju:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/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 na tipkovnici in prekinitev klica,
ki so navadne vrstice poziva in ne ločena konfiguracija.
- **Raven pogona** (`spark`, `bolt`, `storm-*`): Spark je optimiziran
za stroške, Bolt za hitrost, Storm pa za inteligenco pri kompleksnih pozivih.
- **Glas** ter **primarni jezik** in izbirni **dodatni
jeziki** — agent samodejno preklopi, ko klicatelj zamenja
jezik. Oglejte si [podprte jezike](/sl/guides/supported-languages).
- Pripete zmožnosti: [povezane aplikacije](#connections),
[povezave API](#connections), [baze znanja](#knowledge-bases),
[strežniki MCP](#connections) in vdelana
[funkcijska orodja](#function-tools).
- Nastavitve vedenja: vrstni red govora, način potrditve, glasba v ozadju,
časovna omejitev čakanja.
Urejanja v gradniku se **samodejno shranijo kot osnutek**; nič ne postane aktivno, dokler
ne kliknete **Objavite**. Vsaka objava se posname na posnetek v 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
[Gradnja prvega glasovnega agenta](/sl/guides/build-an-agent).
**V API-ju:** [`/v1/agents`](/api-reference/agents) — CRUD,
podvajanje, preusmeritev, zgodovina različic in pomočniki za pozive.
---
## Glasovi
**Knjižnica glasov** vsebuje glasove, ki jih lahko uporablja agent, njihove
predvajane vzorce, združljive jezike, razvrstitve po spolu in naglasu ter
morebitni dodatek za premijske glasove oziroma jezike. Pred izbiro lahko s
plačljivim preizkuševalnikom sintetizirate lastno frazo z 1–500 znaki.
Upravičene organizacije lahko iz kratkega vzorca WAV ali MP3 ustvarijo tudi
**glasove po meri**. Glasovi po meri imajo kvoto in stanje asinhronega
ustvarjanja; ko so pripravljeni, se prikažejo v istem izbirniku agentov kot
glasovi iz knjižnice.
**Na nadzorni plošči:** **Glasovi** (`/dashboard/voices`). Oglejte si
[Knjižnica glasov in glasovi po meri](/sl/guides/voice-library).
**V API-ju:** [`/v1/voices`](/api-reference/voices),
[vzorci glasov](/api-reference/voice-samples) in
[glasovi po meri](/api-reference/custom-voices).
---
## 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, {/* rate:phone */}$1/mesec plus 1 ¢/minuto{/* /rate */}
dodatka. Samo za dohodne klice; za odhodne klice potrebujete lastnega ponudnika.
Organizacija jih lahko privzeto ima 25.
- **VoIP-številke** — prenesene od vašega ponudnika prek
[povezave VoIP](#connections). Twilio in Telnyx se povežeta neposredno
(Telnyx ima vodeno nastavitev); SignalWire in Vonage bosta na voljo kmalu —
trenutno ju dosežete z ročno konfiguracijo SIP, ki sprejema kateri koli
SIP-trunk. Ko so VoIP-številke uvožene in preverjene, podpirajo dohodne
in odhodne klice.
V vsaki vrstici številke lahko nastavite način usmerjanja, izberete agenta za
dohodne klice in številko označite.
**Na nadzorni plošči:** **Telefonske številke** (`/dashboard/phone-numbers`).
Oglejte si [Pridobite telefonsko številko](/sl/guides/get-a-phone-number).
**V 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).
---
## 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
izbirno ocenjevanje z UI in poročila o težavah.
Ko je klic **v živo**, ga lahko odprete in mu **prisluhnete** — pridružite se
neslišno in nihče v klicu vas ne sliši. Ko prisluhnete, lahko
**šepetate**: vnesite navodilo, ki se med klicem neposredno pošlje vašemu
agentu; 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. Oglejte si
[Preglejte, prisluhnite in usmerjajte svoje klice](/sl/guides/review-calls).
**V API-ju:** [`/v1/calls`](/api-reference/calls) — seznam, prepis,
zgodovina, zvok, ocenjevanje, izvoz;
[`/v1/issue-reports`](/api-reference/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`). Oglejte si
[Portali za stranke](/sl/guides/client-portals).
**V API-ju:** [`/v1/client-portals`](/api-reference/client-portals) za
skrbniško upravljanje.
## Spletni gradniki
**Spletni gradnik** obiskovalcem vašega spletnega mesta omogoča pogovor z agentom prek mikrofona — telefonska številka ni potrebna. Preverja pristnost z **javno objavljivim ključem** (`pk_live_...`), ki je vezan na izvor vaših dovoljenih domen, zato je varen za uporabo v kodi na strani odjemalca.
Ključi delujejo v enem od dveh načinov: `agent` (statično vezan na enega agenta) ali `webhook` (vaš strežnik izbere konfiguracijo za vsakega obiskovalca — glejte [Dinamična konfiguracija za posamezen klic](/sl/guides/dynamic-call-config)). Seje gradnika potekajo prek iste klicne infrastrukture kot telefonski klici.
**Na nadzorni plošči:** **Spletni gradniki** (`/dashboard/web-widgets`) —
ustvarite gradnike, nastavite način in agenta, upravljajte dovoljene domene ter
kopirajte delček za vdelavo. Glejte
[Ustvarite spletni gradnik](/sl/guides/embed-a-web-widget-dashboard).
**V API-ju:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) in
[dokumentacijo SDK-ja za gradnike](/sl/widget/overview).
---
## Baze znanja
**Baza znanja** je zbirka dokumentov, po katerih lahko vaš agent med
klicem išče, da utemelji svoje odgovore — naložite datoteke, prilepite besedilo
ali uvozite spletne strani prek URL-ja, nato pa bazo znanja v gradniku
pripnite agentu. Agent jo po potrebi poizveduje z vgrajenim iskalnim orodjem.
**Na nadzorni plošči:** **Znanje** (`/dashboard/knowledge`) za
knjižnico dokumentov; razdelek **Znanje** v gradniku za pripenjanje baze
agentu. Glejte
[Dodajte svojemu agentu bazo znanja](/sl/guides/knowledge-base).
---
## Povezave
Povezave agentom omogočajo dostop do zunanjega sveta. Štiri vrste, ena
skupina v stranski vrstici:
- **Aplikacije** (`/dashboard/app-connections`) — povezave OAuth s
Slackom, HubSpotom, Salesforceom, Google Calendarjem, Google Sheetsom in
Cal.comom. Povežite jih enkrat, nato pa za posamezna opravila vklopite orodja
(objava sporočila v Slacku, posodobitev ali vstavljanje stika v HubSpotu,
rezervacija termina v Cal.comu …) za katerega koli agenta. Glejte [Povežite aplikacije](/sl/guides/connect-apps).
- **API-ji** (`/dashboard/api-connections`) — spremenite kateri koli HTTP API v
dejanje agenta. Prilepite ukaz cURL in čarovnik z umetno inteligenco pripravi
osnutek definicije orodja, lahko pa jo ustvarite ročno; gumb **Preizkusna zahteva** izvede
klic v peskovniku, preden ga uvedete. Glejte
[Povezave API](/sl/guides/api-connections) — vmesnik nadzorne plošče za
[`/v1/integrations`](/api-reference/integrations).
- **MCP** (`/dashboard/mcp-connections`) — dodajte strežnik Model Context
Protocol prek URL-ja in agentu omogočite uporabo orodij, ki jih ponuja.
Glejte [Dodajte strežnik MCP](/sl/guides/mcp-servers).
- **VoIP** (`/dashboard/voip-connections`) — poverilnice ponudnika za
[uporabo lastnih telefonskih številk](#phone-numbers). Glejte
[Povežite ponudnika VoIP](/sl/guides/voip-providers).
ThunderPhone ponuja tudi lastno končno točko MCP, tako da lahko zunanji odjemalec MCP
navede agente, pregleda klice in prepise ter izvaja klice. Glejte
[Uporabite ThunderPhone kot strežnik MCP](/sl/guides/thunderphone-mcp-server).
**V API-ju:** [`/v1/integrations`](/api-reference/integrations),
[`/v1/mcp-servers`](/api-reference/mcp-servers) in
[`/v1/voip-connections`](/api-reference/voip-connections); glejte tudi
[Ustvarite integracijo orodja](/sl/guides/build-tool-integration).
---
## Kampanje
**Kampanja** izvaja odhodne klice v velikem obsegu: naložite CSV s
stiki, izberite agenta in izhodno številko ter nastavite okno za klice
(dneve in ure ob upoštevanju časovnega pasu), sočasnost in pravilnik ponovnih poskusov
(največje število poskusov in izide — brez odgovora, glasovna pošta, neuspešno —
za katere se klic ponovi). Kampanja obdeluje seznam in vsak klic zabeleži
v zgodovini klicev.
**Na nadzorni plošči:** **Kampanje** (`/dashboard/campaigns`). Glejte
[Izvedite kampanjo odhodnih klicev](/sl/guides/outbound-campaigns).
**Za posamezne programske klice:** [API za odhodne klice](/sl/guides/place-outbound-calls).
## Spremljanje v živo
**V živo** prikazuje vsak klic, ki trenutno poteka v organizaciji, in vam omogoča,
da katerega koli od njih odprete ter ga [poslušate in šepetate](#calls) v realnem času. To je površina za nadzor: spremljajte, kako nov poziv prejme prvi dejanski promet, ali nadzorujte aktivno kampanjo.
**Na nadzorni plošči:** **V živo** (`/dashboard/live`). Oglejte si
[Spremljanje in nadzor klicev v živo](/sl/guides/monitor-live-calls).
---
## Simulacije
**Simulacija** je klicatelj z umetno inteligenco, ki ima resničen pogovor z vašim
agentom — ista telefonska pot, dejanski prepis in dejansko ocenjevanje — zato
lahko preizkusite pred objavo (in po njej). Usmerite jo na agenta ali telefonsko
številko, sami napišite scenarij klicatelja ali **ustvarite scenarije z umetno
inteligenco** iz poziva agenta (vključno z robnimi primeri, če jih zahtevate) in
spremljajte klic v živo.
Scenariji se združujejo v **zbirke**, ki določajo najmanjšo stopnjo uspešnosti in
lahko omejijo izdaje v CI; regresije glede na sprejeto izhodišče so prijavljene
za vsak scenarij.
**Na nadzorni plošči:** **Simulacije** (`/dashboard/simulations`) ter gumb
**Simulacija** v urejevalniku agenta. Oglejte si
[Simuliranje klica](/sl/guides/simulate-a-call).
**V API-ju:** [`/v1/test-calls`](/api-reference/test-calls) in izvajalnik zbirk —
oglejte si [Celovito testiranje agenta](/sl/guides/test-agents).
---
## Nabori za preverjanje
**Nabor za preverjanje** spremeni trenutke iz resničnih klicev v ponovljive
regresijske preglede z enim obratom. Vsak primer zamrzne kontekst pogovora,
ustrezni zvok klicatelja, izvirni odgovor in pričakovano vedenje. Ponovitve se
izvajajo na trenutnem osnutku agenta brez novega klica, pogovorno okno za objavo
pa lahko prikaže, ali se najnovejši zagon še vedno ujema s tem osnutkom.
**Na nadzorni plošči:** **Nabori za preverjanje** (`/dashboard/validation`) za
nabor podatkov organizacije in zavihek **Preverjanje** v urejevalniku agenta za
zagone. Oglejte si [Nabori za preverjanje](/sl/guides/validation-sets).
**V API-ju:** [`/v1/validation-sets`](/api-reference/validation-sets) in
končne točke za ponovitev agenta/primera na isti referenčni strani.
---
## Poskusi
**Poskus** izvaja A/B-test konfiguracij agenta na dejanskem prometu:
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 segmentov v spletnem kavlju.
**Na nadzorni plošči:** **Poskusi** (`/dashboard/experiments`) in
zavihek **A/B** v urejevalniku agenta. Oglejte si
[Poskusi (A/B-testiranje)](/sl/guides/experiments-ab-testing).
---
## 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 vsebujejo
resnost, vir in stanje, stran Težave pa je čakalna vrsta za triažo: filtrirajte,
preglejte problematični klic in spremljajte popravke.
**Na nadzorni plošči:** **Težave** (`/dashboard/issues`) ter označevanje za
posamezne klice v zgodovini klicev. Oglejte si [Triaža težav](/sl/guides/issues).
**V API-ju:** [`/v1/issue-reports`](/api-reference/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
agente ter časovno obdobje, ki ju izberete.
**Na nadzorni plošči:** **Poročila** (`/dashboard/reports`). Oglejte si
[Poročila](/sl/guides/reports).
---
## Opazljivost
**Opazljivost** je površina za metrike: obseg klicev, rezultati in
kakovost skozi čas, z možnostjo filtriranja po agentu in časovnem oknu ter
izvoza za nadaljnjo analizo.
**Na nadzorni plošči:** **Opazljivost** (`/dashboard/observability`).
Oglejte si [Opazljivost](/sl/guides/observability).
---
## Opozorila
**Pravilo opozorila** spremlja metriko (stopnjo uspešnosti, stopnjo neuspešnosti,
povprečno oceno, obseg klicev, regresije zbirk) v časovnem oknu in se sproži,
ko preseže vaš prag. Obvestila se pošljejo po e-pošti in v Slack ter sprožijo
dogodek `alert.triggered` za vaše
[končne točke spletnih kavljev](/sl/webhooks/endpoints).
**Na nadzorni plošči:** **Organizacija → Opozorila**. Oglejte si
[Opozorila](/sl/guides/alerts).
---
## Spletni kavlji
ThunderPhone pošilja **spletne kljuke HTTP POST** na vaš strežnik, ko se med klicem ali po njem
zgodijo določeni dogodki. Na voljo sta dva modela dostave:
- **Končne točke spletnih kljuk** (priporočeno): upravljajte več URL-jev na
[`/v1/developer/webhook-endpoints`](/sl/webhooks/endpoints) s
skrivnostmi in naročninami na dogodke za posamezne končne točke.
- **Podedovana spletna kljuka z enim URL-jem**: en URL na organizacijo. Upravljate jo na
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
ali v razdelku **Organizacija → Splošno**. Ohranjena je zaradi združljivosti s starejšimi različicami.
Dogodki se delijo v dva razreda:
- **Blokirajoči dogodki** pričakujejo, da vaš strežnik odgovori s konfiguracijo,
ki oblikuje klic v teku — to so
[dogodki dohodnega klica](/sl/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Za odgovor imate do 10 sekund;
ob prekoračitvi časovne omejitve klic obravnava statično dodeljeni agent.
- **Neblokirajoči dogodki** so obvestila po načelu pošlji in pozabi, ki se ponavljajo
z eksponentnim zamikom — glejte
[semantiko dostave](/sl/webhooks/overview).
Vsaka zahteva vsebuje podpis HMAC-SHA256 v
`X-ThunderPhone-Signature`. Glejte
[preverjanje podpisov](/sl/webhooks/overview).
---
## Funkcijska orodja
**Funkcijsko orodje** je končna točka HTTP, ki jo lahko vaš agent pokliče
med pogovorom. ThunderPhone posredujete funkcijsko shemo v slogu OpenAI
ter URL končne točke; agent odloči, kdaj jo bo poklical, ThunderPhone pa
iz svojih strežnikov izvede 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
zadržani zvezi — ki jih omogočite z navadnimi vrsticami poziva namesto z
definicijami orodij.
**Na nadzorni plošči:** razdelek gradnika **Povezave API** (glejte
[Povezave](#connections)).
**V API-ju:** [`/v1/integrations`](/api-reference/integrations) in
[specifikacija funkcijskih orodij](/sl/tools/overview).
---
## Ekipa in vloge
Vsaka organizacija ima seznam članov z dvema vlogama: **Člani** gradijo
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 odstrani osebo. Enotno prijavo
lahko konfigurirate za celotno organizacijo — glejte [SSO](/sl/guides/sso).
**Na nadzorni plošči:** **Organizacija → Splošno**. Glejte
[Povabite svojo ekipo](/sl/guides/invite-your-team).
**V API-ju:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
---
## Obračunavanje
ThunderPhone je **predplačniški**. Vsaka organizacija ima dobroimetje v USD;
klici ga bremenijo po minutni tarifi agenta (stopnja pogona in doplačila —
gradnik med spreminjanjem nastavitev sproti prikazuje skupno tarifo, izbrani
[dodatni jeziki](/sl/guides/supported-languages) pa dodajo {/* rate:language */}3 ¢/min{/* /rate */}). Ko
dobroimetje doseže nič, so dohodni klici zavrnjeni, odhodni klici pa vrnejo
`402 Payment Required`.
Dobroimetje lahko dopolnite ročno ali omogočite **samodejno dopolnjevanje**
s pragom dobroimetja, zneskom dopolnitve 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 dopolnjevanje](/sl/guides/billing-and-topups) ter
[celoten pregled cen](/sl/guides/pricing).
**V API-ju:** [`/v1/billing`](/api-reference/billing).
---
## Kopilot v aplikaciji
Nadzorna plošča vključuje vgrajenega **kopilota** — vprašajte ga »kako naredim X«
in odgovoril bo na podlagi te dokumentacije, ponudil navodila po korakih s
poudarjenimi dejanskimi kontrolniki ter lahko znova predvaja katero koli od
vodenih predstavitev. To je najhitrejši način za iskanje kontrolnika, ki ga
omenja ta stran. Glejte [Vprašajte kopilota v aplikaciji](/sl/guides/ask-the-copilot).
---
## Povezovanje vsega skupaj
Čarovnik v petih korakih: agent → obračunavanje → številka → simulacija → pregled.
Enak prvi klic v štirih klicih REST.
Ustvarite agenta, ga financirajte, pridobite številko, simulirajte in preglejte klice.
Aplikacije OAuth, API-ji po meri, strežniki MCP in ponudniki VoIP.
Poročila, opazljivost, poskusi, težave in opozorila.
Povabila in vloge, ključi API, varnost in SSO.
Recepti za API: dohodni klici, odhodni klici, dinamična konfiguracija, orodja, testiranje.
Preverjanje HMAC nastavite pravilno enkrat in ga uporabljajte povsod.