--- title: "Põhimõisted" description: "Ülevaade kõigest platvormil — mida iga objekt teeb, kus see juhtpaneelis asub ja milline API sellega suhtleb." --- ThunderPhone on terviklik platvorm AI häälagentide loomiseks, käitamiseks ja täiustamiseks. See leht on kaart: kõik mõisted, millega kokku puutud, igaüks lühikeses jaotises koos seda toetava juhtpaneeli vaate ja API-ga. Sirvi see üks kord läbi, seejärel tule tagasi, kui mõni termin vajab selgitamist. Juhtpaneeli külgriba järgib sama struktuuri: [Agendid](#agents), [hääled](#voices), [telefoninumbrid](#phone-numbers), [veebividinad](#web-widgets), [kõned](#calls), [kliendiportaalid](#client-portals), [teadmusbaasid](#knowledge-bases). [Reaalajas jälgimine](#live-monitoring) ja väljaminevad [kampaaniad](#campaigns). [Rakendused, API-d, MCP-serverid ja VoIP-teenusepakkujad](#connections), mida sinu agendid saavad kasutada. [Simulatsioonid](#simulations), [valideerimiskomplektid](#validation-sets), [katsed](#experiments), [probleemid](#issues), [aruanded](#reports), [jälgitavus](#observability). [Meeskond ja rollid](#team-and-roles), [API-võtmed](#organizations), [teavitused](#alerts), [arveldamine](#billing). [Veebikonksud](#webhooks) ja [funktsioonitööriistad](#function-tools) sinu enda koodi jaoks. --- ## Organisatsioonid **Organisatsioon** on eraldatud kasutusruumi üksus. Kõik muud ressursid — agendid, telefoninumbrid, kõned, võtmed — kuuluvad täpselt ühele organisatsioonile. Sinu konto võib kuuluda mitmesse organisatsiooni; igal neist on oma saldo, oma võtmed ja oma liikmete loend. API-võti `sk_live_`, mille lood jaotises **Organisatsioon → Võtmed**, on seotud ühe organisatsiooniga. See seos muudab REST API nii lihtsaks: sa ei lisa kunagi URL-i radadesse organisatsiooni ID-d, sest sinu võti juba tuvastab selle. **Juhtpaneelil:** organisatsiooni valija (külgriba jaluses) ja **Organisatsiooni** seaded — vahekaardid Minu konto, Üldine, Võtmed, Teavitused, Arvelduse seaded ja Arveldusajalugu. Vaata [organisatsiooni seadete viidet](/et/guides/organization-settings). **API-s:** [`/v1/orgs`](/api-reference/organizations), [`/v1/developer/api-keys`](/api-reference/developer-api-keys). --- ## Agendid **Agent** on kõnet käitav AI-konfiguratsioon. See hõlmab järgmist: - **Juhis**, mis määrab, mida agent ütleb ja kuidas see käitub — sealhulgas kõnetoimingud nagu ülekanded, klahvistiku vajutused ja kõne lõpetamine, mis on eraldi konfiguratsiooni asemel tavalised juhiseread. - **Mootori tase** (`spark`, `bolt`, `storm-*`): Spark on optimeeritud hinna, Bolt kiiruse ja Storm keerukate juhiste intelligentsuse jaoks. - **Hääl** ning **esmane keel** ja valikulised **lisakeeled** — agent vahetab automaatselt keelt, kui helistaja keelt vahetab. Vaata [toetatud keeli](/et/guides/supported-languages). - Lisatud võimalused: [ühendatud rakendused](#connections), [API-ühendused](#connections), [teadmusbaasid](#knowledge-bases), [MCP-serverid](#connections) ja tekstisisesed [funktsioonitööriistad](#function-tools). - Käitumise seaded: rääkimisjärjekord, kinnitamisrežiim, taustaheli, ooteaja aegumine. Muudatused koostajas **salvestatakse automaatselt mustandina**; miski ei avaldu enne, kui klõpsad **Juuruta**. Iga juurutus salvestatakse koostaja **Ajaloo** vahekaardile, nii et saad kontrollida ja taastada mis tahes varasema versiooni. **Juhtpaneelil:** **Häälagendid** → agendi koostaja (`/dashboard/agents`). Vaata [oma esimese häälagendi loomist](/et/guides/build-an-agent). **API-s:** [`/v1/agents`](/api-reference/agents) — CRUD, paljundamine, ülekanne, versiooniajalugu ja juhiste abifunktsioonid. --- ## Hääled **Hääleteek** sisaldab hääli, mida agent saab kasutada, nende esitatavaid näidiseid, ühilduvaid keeli, soo- ja aktsendirühmi ning võimalikke premium-häälte või -keelte lisatasusid. Tasuline näidisfunktsioon võimaldab sul enne valimist sünteesida oma 1–500 tähemärgi pikkuse fraasi. Nõuetele vastavad organisatsioonid saavad luua ka **kohandatud hääli** lühikese WAV- või MP3-näidise põhjal. Kohandatud häältel on kvoot ja asünkroonne loomise olek; kui need on valmis, kuvatakse need agendi valikus koos teegi häältega. **Töölaual:** **Hääled** (`/dashboard/voices`). Vaata [Hääleteeki ja kohandatud hääli](/et/guides/voice-library). **API-s:** [`/v1/voices`](/api-reference/voices), [häälenäidised](/api-reference/voice-samples) ja [kohandatud hääled](/api-reference/custom-voices). --- ## Telefoninumbrid **Telefoninumber** kuulub organisatsioonile ja suunab sissetulevad kõned agendile (ning seda saab kasutada väljaminevate kõnede jaoks). Kaks allikat: - **ThunderPhone'i numbrid** — päris USA numbrid, mis hangitakse ThunderPhone'i numbripargist, on aktiivsed sekunditega ja maksavad {/* rate:phone */}$1/kuus pluss 1¢/minut{/* /rate */} lisatasu. Ainult sissetulevateks kõnedeks; väljaminevate kõnede jaoks vajad oma operaatorit. Organisatsioonil võib vaikimisi olla 25 numbrit. - **VoIP-numbrid** — tood oma teenusepakkujalt [VoIP-ühenduse](#connections) kaudu. Twilio ja Telnyx ühenduvad otse (Telnyxil on juhendatud seadistus); SignalWire ja Vonage lisanduvad peagi — praegu saad nendeni jõuda käsitsi SIP-konfiguratsiooni kaudu, mis toetab mis tahes SIP-trunki. Pärast importimist ja kinnitamist toetavad VoIP-numbrid nii sissetulevaid kui ka väljaminevaid kõnesid. Iga numbri real saad määrata suunamisrežiimi, valida sissetulevate kõnede agendi ja lisada numbrile sildi. **Töölaual:** **Telefoninumbrid** (`/dashboard/phone-numbers`). Vaata [Telefoninumbri hankimine](/et/guides/get-a-phone-number). **API-s:** [`/v1/phone-numbers`](/api-reference/phone-numbers), [`/v1/voip-connections`](/api-reference/voip-connections), [`/v1/phone-number-labels`](/api-reference/phone-number-labels). --- ## Kõned Igast sissetulevast kõnest, väljaminevast kõnest, simulatsioonist ja vidinaseansist saab **kõnelogi**. Kõne sisaldab täielikku rollisiltidega transkripti, struktureeritud voorude ajalugu (sealhulgas tööriistakutseid), salvestist, arvelduse kogusummat ning valikulist AI-poolset hindamist ja probleemiaruandeid. Kui kõne on **aktiivne**, saad selle avada ja seda **pealt kuulata** — liitud vaikselt ning keegi kõnes osalejatest ei kuule sind. Kuulamise ajal saad **sosistada**: kirjuta juhis, mis saadetakse kõne ajal otse sinu agendile; helistaja ei kuule seda kunagi ja agent järgib seda reaalajas. **Töölaual:** **Kõneajalugu** (`/dashboard/call-history`) arhiivi ja kõne üksikasjade jaoks; **Aktiivsed** pooleliolevate kõnede jaoks. Vaata [Oma kõnede ülevaatamine, pealtkuulamine ja juhendamine](/et/guides/review-calls). **API-s:** [`/v1/calls`](/api-reference/calls) — loend, transkript, ajalugu, heli, hindamine, eksport; [`/v1/issue-reports`](/api-reference/issue-reports). --- ## Kliendiportaalid **Kliendiportaal** on väliskliendile mõeldud kaubamärgistatud kirjutuskaitstud kõneajaloo vaade. Organisatsiooni administraatorid valivad agendid, kelle kõnesid kuvatakse, lisavad heaks kiidetud vaatlejate e-posti aadressid, laadivad üles logo ja aktsentvärvi ning saavad soovi korral kinnitada kohandatud domeeni. Portaali vaatlejad saavad vaadata kõne üksikasju, transkripte ja saadaolevaid salvestisi, ilma et neile antaks juurdepääs töölauale. **Töölaual:** **Kliendiportaalid** (`/dashboard/client-portals`). Vaata [Kliendiportaalid](/et/guides/client-portals). **API-s:** [`/v1/client-portals`](/api-reference/client-portals) administraatori haldusliidese jaoks. --- ## Veebividinad **Veebividin** võimaldab sinu saidi külastajatel mikrofoni kaudu agendiga vestelda — telefoninumbrit pole vaja. See autentib end **avaliku võtmega** (`pk_live_...`), mis on päritolupiiranguga seotud sinu lubatud domeenidega, nii et seda on turvaline kasutada kliendipoolses koodis. Võtmed töötavad ühes kahest režiimist: `agent` (staatiliselt seotud ühe agendiga) või `webhook` (sinu server valib konfiguratsiooni iga külastaja jaoks — vt [Dünaamiline kõnepõhine konfiguratsioon](/et/guides/dynamic-call-config)). Vidina seansid kasutavad sama kõnetaristut nagu telefonikõned. **Töölaual:** **Veebividinad** (`/dashboard/web-widgets`) — loo vidinaid, määra režiim ja agent, halda lubatud domeene ning kopeeri manustamiskood. Vaata [Veebividina loomine](/et/guides/embed-a-web-widget-dashboard). **API-s:** [`/v1/publishable-key`](/api-reference/publishable-keys), [`/v1/mic-session`](/api-reference/mic-sessions) ja [Widget SDK dokumentatsioon](/et/widget/overview). --- ## Teadmistebaasid **Teadmistebaas** on dokumentide kogum, millest sinu agent saab kõne ajal vastuste põhjendamiseks otsida — laadi üles faile, kleebi teksti või impordi veebilehti URL-i järgi ning seejärel seo teadmistebaas koosturis agendiga. Agent esitab sellele sisseehitatud otsingutööriistaga päringuid alati, kui vestlus seda nõuab. **Töölaual:** **Teadmised** (`/dashboard/knowledge`) dokumentide kogu jaoks; koosturi jaotis **Teadmised**, et see agendiga siduda. Vaata [Anna oma agendile teadmistebaas](/et/guides/knowledge-base). --- ## Ühendused Ühenduste kaudu saavad agendid välismaailmaga suhelda. Neli tüüpi, üks külgriba rühm: - **Rakendused** (`/dashboard/app-connections`) — OAuth-ühendused Slacki, HubSpoti, Salesforce'i, Google Calendar'i, Google Sheetsi ja Cal.comiga. Ühenda üks kord, seejärel lülita toimingupõhiseid tööriistu (Slacki sõnumi saatmine, HubSpoti kontakti lisamine või värskendamine, Cal.comi aja broneerimine…) sisse mis tahes agendi jaoks. Vaata [Rakenduste ühendamine](/et/guides/connect-apps). - **API-d** (`/dashboard/api-connections`) — muuda mis tahes HTTP API agendi toiminguks. Kleebi cURL-käsk ning AI-viisard koostab tööriista definitsiooni mustandi, või loo see käsitsi; nupp **Testpäring** teeb enne avaldamist liivakastis kõne. Vaata [API-ühendused](/et/guides/api-connections) — töölaualiides [`/v1/integrations`](/api-reference/integrations) jaoks. - **MCP** (`/dashboard/mcp-connections`) — lisa Model Context Protocoli server URL-i järgi ja lase agendil kasutada selle pakutavaid tööriistu. Vaata [MCP-serveri lisamine](/et/guides/mcp-servers). - **VoIP** (`/dashboard/voip-connections`) — teenusepakkuja mandaadid [oma telefoninumbrite kasutamiseks](#phone-numbers). Vaata [VoIP-teenusepakkuja ühendamine](/et/guides/voip-providers). ThunderPhone pakub ka oma MCP-lõpp-punkti, et väline MCP-klient saaks loetleda agente, vaadata kõnesid ja transkriptsioone ning teha kõnesid. Vaata [ThunderPhone'i kasutamine MCP-serverina](/et/guides/thunderphone-mcp-server). **API-s:** [`/v1/integrations`](/api-reference/integrations), [`/v1/mcp-servers`](/api-reference/mcp-servers) ja [`/v1/voip-connections`](/api-reference/voip-connections); vaata ka [Tööriistaintegratsiooni loomine](/et/guides/build-tool-integration). --- ## Kampaaniad **Kampaania** teeb väljaminevaid kõnesid suurel mahul: laadi üles kontaktide CSV, vali agent ja lähtev number ning määra helistamisaken (päevad ja kellaajad, ajavööndit arvestades), samaaegsuse tase ja uuestiproovimise poliitika (maksimaalne katsete arv ning milliste tulemuste — vastamata kõne, kõnepost, ebaõnnestunud — korral proovitakse uuesti). Kampaania liigub läbi loendi ja salvestab iga kõne kõneajalukku. **Töölaual:** **Kampaaniad** (`/dashboard/campaigns`). Vaata [Väljaminevate kõnede kampaania käivitamine](/et/guides/outbound-campaigns). **Ühekordsete programmiliste kõnede jaoks:** kasuta [väljaminevate kõnede API-t](/et/guides/place-outbound-calls). ## Reaalajas jälgimine **Reaalajas** kuvab kõik organisatsioonis käimasolevad kõned ja võimaldab avada neist ükskõik millise, et [pealt kuulata ja sosistada](#calls) reaalajas. See on järelevalvevaade: jälgi, kuidas uus viip saab oma esimese päris liikluse, või hoia käimasoleval kampaanial silm peal. **Töölaual:** **Reaalajas** (`/dashboard/live`). Vaata [Jälgi ja halda reaalajas kõnesid](/et/guides/monitor-live-calls). --- ## Simulatsioonid **Simulatsioon** on AI-helistaja päris vestlus sinu häälagendiga — sama telefonitee, päris transkript, päris hindamine — et saaksid testida enne (ja pärast) avaldamist. Suuna see häälagendile või telefoninumbrile, kirjuta helistaja stsenaarium ise või **genereeri stsenaariumid AI abil** häälagendi viibast (soovi korral ka äärejuhtumid) ning jälgi kõnet reaalajas. Stsenaariumid koonduvad **komplektidesse**, mis määravad minimaalse läbimise määra ja võivad CI-s väljalaskeid blokeerida; kõrvalekalletest aktsepteeritud baasjoonest teatatakse iga stsenaariumi kohta eraldi. **Töölaual:** **Simulatsioonid** (`/dashboard/simulations`) ning nupp **Simulatsioon** häälagendi koostajas. Vaata [Simuleeri kõnet](/et/guides/simulate-a-call). **API-s:** [`/v1/test-calls`](/api-reference/test-calls) ja komplekti käitaja — vaata [Testi häälagenti otsast lõpuni](/et/guides/test-agents). --- ## Valideerimiskomplektid **Valideerimiskomplekt** muudab päris kõnede hetked korratavateks ühe vooru regressioonikontrollideks. Iga näide talletab vestluse konteksti, asjakohase helistaja heli, algse vastuse ja oodatud käitumise. Taasesitused käitatakse praeguse häälagendi mustandi vastu ilma uut kõnet tegemata ning avaldamise dialoog võib näidata, kas viimane käitus vastab endiselt sellele mustandile. **Töölaual:** **Valideerimiskomplektid** (`/dashboard/validation`) organisatsiooni andmestiku jaoks ning häälagendi koostaja vahekaart **Valideerimine** käituste jaoks. Vaata [Valideerimiskomplektid](/et/guides/validation-sets). **API-s:** [`/v1/validation-sets`](/api-reference/validation-sets) ning häälagendi/näite taasesituse lõpp-punktid samal viitelehel. --- ## Eksperimendid **Eksperiment** A/B-testib häälagendi konfiguratsioone päris liiklusel: määratle variandid (erinevad viibad, mootorid või seaded), jaga liiklus nende vahel ning võrdle tulemusi variandi kaupa. Kasuta seda veebikonksus käsitsi kohortide loogika koostamise asemel. **Töölaual:** **Eksperimendid** (`/dashboard/experiments`) ja häälagendi koostaja vahekaart **A/B**. Vaata [Eksperimendid (A/B-testimine)](/et/guides/experiments-ab-testing). --- ## Probleemid **Probleem** on märgitud tõrge konkreetsel kõnel — selle on esitanud inimülevaataja või tuvastanud AI-hindamine. Probleemidel on tõsidusaste, allikas ja olek ning leht Probleemid on triaažijärjekord: filtreeri, kontrolli probleemset kõnet ja jälgi parandusi. **Töölaual:** **Probleemid** (`/dashboard/issues`) ning kõnepõhine märgistamine kõneajaloos. Vaata [Probleemide triaaž](/et/guides/issues). **API-s:** [`/v1/issue-reports`](/api-reference/issue-reports). --- ## Aruanded **Aruanne** vastab sinu kõneandmete kohta esitatud loomulikus keeles küsimusele ("Mis olid kolm peamist põhjust, miks helistajad eelmisel nädalal inimest küsisid?") AI kirjutatud analüüsiga, mis on piiratud sinu valitud häälagentide ja kuupäevavahemikuga. **Töölaual:** **Aruanded** (`/dashboard/reports`). Vaata [Aruanded](/et/guides/reports). --- ## Jälgitavus **Jälgitavus** on mõõdikute vaade: kõnede maht, tulemused ja kvaliteet ajas, filtreeritav häälagendi ja ajavahemiku järgi ning eksporditav edasise analüüsi jaoks. **Töölaual:** **Jälgitavus** (`/dashboard/observability`). Vaata [Jälgitavus](/et/guides/observability). --- ## Teavitused **Teavitusreegel** jälgib mõõdikut (õnnestumiste määr, ebaõnnestumiste määr, keskmine skoor, kõnede maht, komplekti regressioonid) ajavahemiku jooksul ja käivitub, kui see ületab sinu lävendi. Teavitused saadetakse e-posti ja Slacki ning käivitavad sinu [veebikonksu lõpp-punktides](/et/webhooks/endpoints) sündmuse `alert.triggered`. **Töölaual:** **Organisatsioon → Teavitused**. Vaata [Teavitused](/et/guides/alerts). --- ## Veebihaagid ThunderPhone saadab sinu serverisse **HTTP POST veebihaake**, kui kõne ajal või pärast seda midagi toimub. Kasutusel on kaks edastusmudelit: - **Veebihaagi lõpp-punktid** (soovitatav): halda mitut URL-i aadressil [`/v1/developer/webhook-endpoints`](/et/webhooks/endpoints), kasutades lõpp-punktipõhiseid saladusi ja sündmuste tellimusi. - **Pärandveebihaak ühe URL-iga**: üks URL organisatsiooni kohta. Hallatav aadressil [`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook) või jaotises **Organisatsioon → Üldine**. Säilitatud tagasiühilduvuse tagamiseks. Sündmused jagunevad kahte klassi: - **Blokeerivad sündmused** eeldavad, et sinu server vastab konfiguratsiooniga, mis kujundab pooleliolevat kõnet — need on [sissetuleva kõne sündmused](/et/webhooks/call-incoming) (`telephony.incoming` / `web.incoming`). Vastamiseks on aega kuni 10 sekundit; ajalõpu korral käsitleb kõnet staatiliselt määratud häälagent. - **Mitteblokeerivad sündmused** on saada-ja-unusta-teavitused, mida proovitakse eksponentsiaalse viivitusega uuesti — vaata [edastuse semantikat](/et/webhooks/overview). Iga päring sisaldab HMAC-SHA256 allkirja päises `X-ThunderPhone-Signature`. Vaata [allkirja kontrollimist](/et/webhooks/overview). --- ## Funktsioonitööriistad **Funktsioonitööriist** on HTTP-lõpp-punkt, mida sinu agent saab vestluse keskel kutsuda. Annad ThunderPhone'ile OpenAI-stiilis funktsiooniskeemi ja lõpp-punkti URL-i; agent otsustab, millal seda kutsuda, ning ThunderPhone teeb allkirjastatud HTTP-päringu oma serveritest ja edastab tulemuse agendile. Agentidel on ka **sisseehitatud kõnevõimalused** — kõne suunamine, klahvistiku (DTMF) sisendi saatmine, kõne lõpetamine, ootel ootamine —, mille lubad lihtsate viiparidadega tööriistade määratluste asemel. **Töölaual:** koosturi jaotis **API-ühendused** (vaata [Ühendused](#connections)). **API-s:** [`/v1/integrations`](/api-reference/integrations) ja [Function Tools spetsifikatsioon](/et/tools/overview). --- ## Meeskond ja rollid Igal organisatsioonil on liikmete loend kahe rolliga: **Liikmed** loovad ja haldavad agente; **Administraatorid** haldavad lisaks meeskonda ja arveldust. Kutsu liikmeid e-posti teel — kutsed aeguvad 7 päeva pärast ja neid saab tühistada; liikme rea menüü ⋯ võimaldab rolle muuta või kedagi eemaldada. Ühekordse sisselogimise saab konfigureerida kogu organisatsiooni jaoks — vaata [SSO](/et/guides/sso). **Töölaual:** **Organisatsioon → Üldine**. Vaata [Kutsu oma meeskond](/et/guides/invite-your-team). **API-s:** [`/v1/members`](/api-reference/members), [`/v1/invites`](/api-reference/invites). --- ## Arveldus ThunderPhone on **ettemakstud**. Igal organisatsioonil on USA dollarites saldo; kõned vähendavad seda agendi minutihinna alusel (mootori tase koos lisatasudega — koostur näitab seadete muutmisel reaalajas koguhinda ning [valitud lisakeeled](/et/guides/supported-languages) lisavad {/* rate:language */}3¢/min{/* /rate */}). Kui saldo jõuab nulli, lükatakse sissetulevad kõned tagasi ja väljaminevad kõned tagastavad `402 Payment Required`. Lisa raha käsitsi või luba **automaatne saldo täiendamine** saldo lävendi, täiendussumma ja valikulise igakuise kululimiidiga — nii ei katke kõne kunagi poole lause pealt. **Töölaual:** **Organisatsioon → Arveldusseaded** ja **Arveldusajalugu**. Vaata [Lisa raha ja lülita automaatne saldo täiendamine sisse](/et/guides/billing-and-topups) ning [täielikku hinnastuse viidet](/et/guides/pricing). **API-s:** [`/v1/billing`](/api-reference/billing). --- ## Rakendusesisene kopiloot Töölaual on sisseehitatud **kopiloot** — küsi sellelt „kuidas ma X-i teen“ ning see vastab nende dokumentide põhjal, pakub samm-sammulisi juhiseid, mis toovad esile tegelikud juhtelemendid, ja saab taasesitada mis tahes juhendatud ringkäigu. See on kiireim viis leida juhtelementi, mida sellel lehel mainitakse. Vaata [Küsi rakendusesiseselt kopiloodilt](/et/guides/ask-the-copilot). --- ## Kõik kokku Viieetapiline juhend: agent → arveldamine → number → simulatsioon → ülevaatus. Sama esimene kõne nelja REST-kutsega. Loo agent, lisa raha, hangi number, simuleeri ja vaata kõned üle. OAuth-rakendused, kohandatud API-d, MCP-serverid ja VoIP-teenusepakkujad. Aruanded, jälgitavus, eksperimendid, probleemid ja teavitused. Kutsed ja rollid, API-võtmed, turvalisus ja SSO. API retseptid: sissetulevad, väljaminevad, dünaamiline konfiguratsioon, tööriistad, testimine. Tee HMAC-kontroll üks kord õigesti ja kasuta seda kõikjal uuesti.