> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Pamatjēdzieni
> Pārskats par visu platformā — ko dara katrs objekts, kur tas atrodas vadības panelī un kura API ar to mijiedarbojas.
ThunderPhone ir pilnvērtīga platforma MI balss aģentu veidošanai, darbībai un uzlabošanai. Šī lapa ir karte: katram jēdzienam, ar kuru sastapsieties, ir veltīta viena īsa sadaļa ar informācijas paneļa saskarni un to nodrošinošo API. Ātri pārskatiet to vienreiz un atgriezieties, kad nepieciešams izskaidrot kādu terminu.
Informācijas paneļa sānjosla atspoguļo šo struktūru:
[Aģenti](#agents), [tālruņa numuri](#phone-numbers),
[tīmekļa logrīki](#web-widgets), [zvani](#calls),
[zināšanu bāzes](#knowledge-bases).
[Tiešraides pārraudzība](#live-monitoring) un izejošās
[kampaņas](#campaigns).
[Lietotnes, API, MCP serveri un VoIP pakalpojumu sniedzēji](#connections), ko var izmantot jūsu
aģenti.
[Simulācijas](#simulations), [eksperimenti](#experiments),
[problēmas](#issues), [pārskati](#reports),
[novērojamība](#observability).
[Komanda un lomas](#team-and-roles), [API atslēgas](#organizations),
[brīdinājumi](#alerts), [norēķini](#billing).
[Tīmekļa aizķeres](#webhooks) un [funkciju rīki](#function-tools) jūsu
kodam.
***
## Organizācijas
**Organizācija** ir nomnieka vienība. Katrs cits resurss —
aģenti, tālruņa numuri, zvani, atslēgas — pieder tieši vienai organizācijai. Jūsu
konts var piederēt vairākām organizācijām; katrai ir savs atlikums, savas
atslēgas un savs dalībnieku saraksts.
API atslēga `sk_live_`, ko izveidojat sadaļā **Organizācija → Atslēgas**, ir
saistīta ar vienu organizāciju. Šī saistība padara REST API tik
vienkāršu: URL ceļos nekad nav jānorāda organizācijas ID, jo jūsu atslēga to jau
identificē.
**Informācijas panelī:** organizācijas pārslēdzējs (sānjoslas kājenē) un
**Organizācijas** iestatījumi — cilnes Vispārīgi, Atslēgas, Brīdinājumi, Norēķinu
iestatījumi un Norēķinu vēsture.
**API:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Aģenti
**Aģents** ir MI konfigurācija, kas apkalpo zvanu. Tajā ir apvienots:
* **Uzvedne**, kas nosaka, ko aģents saka un kā tas rīkojas —
tostarp zvana darbības, piemēram, pārsūtīšana, taustiņu nospiešana un zvana beigšana,
kas ir parastas uzvednes rindas, nevis atsevišķa konfigurācija.
* **Dzinēja līmenis** (`spark`, `bolt`, `storm-*`): Spark ir optimizēts
izmaksām, Bolt — ātrumam, Storm — intelektam darbā ar sarežģītām uzvednēm.
* **Balss**, kā arī **primārā valoda** un izvēles **papildu
valodas** — aģents automātiski pārslēdzas, kad zvanītājs maina
valodu. Skatiet [Atbalstītās valodas](/lv/guides/supported-languages).
* Pievienotās iespējas: [savienotās lietotnes](#connections),
[API savienojumi](#connections), [zināšanu bāzes](#knowledge-bases),
[MCP serveri](#connections) un iekļautie
[funkciju rīki](#function-tools).
* Darbības iestatījumi: runāšanas secība, apstiprināšanas režīms, fona celiņš,
gaidīšanas noildze.
Rediģējumi veidotājā tiek **automātiski saglabāti melnrakstā**; nekas netiek publicēts, līdz
nenoklikšķināt uz **Izvietot**. Katrs izvietojums tiek saglabāts veidotāja
cilnē **Vēsture**, lai varētu pārbaudīt un atjaunot jebkuru iepriekšējo versiju.
**Informācijas panelī:** **Balss aģenti** → aģenta veidotājs
(`/dashboard/agents`). Skatiet
[Izveidojiet savu pirmo balss aģentu](/lv/guides/build-an-agent).
**API:** [`/v1/agents`](/api-reference/agents) — CRUD,
dublēšana, pārsūtīšana, versiju vēsture un uzvedņu palīgrīki.
***
## Tālruņa numuri
**Tālruņa numurs** pieder organizācijai un novirza ienākošos zvanus uz
balss aģentu (un var tikt izmantots izejošajiem zvaniem). Divi avoti:
* **Demonstrācijas numuri** — īsti ASV numuri, kas tiek nodrošināti no ThunderPhone
kopas un ir aktīvi dažu sekunžu laikā. Tikai ienākošajiem zvaniem — tie atbild ar īsu mutisku
atrunu, un informācijas panelis vienai organizācijai ļauj izmantot ne vairāk kā 10 šādus numurus. Lieliski
pirmajam testam; ne produkcijas videi.
* **VoIP numuri** — tiek pievienoti no jūsu pakalpojumu sniedzēja, izmantojot
[VoIP savienojumu](#connections). Twilio un Telnyx tiek savienoti tieši
(Telnyx piedāvā vadītu iestatīšanu); SignalWire un Vonage būs pieejami drīzumā —
pašlaik tos var izmantot, veicot manuālu SIP konfigurāciju, kas pieņem jebkuru
SIP maģistrāli. Pēc importēšanas un verificēšanas VoIP numuri atbalsta
ienākošos un izejošos zvanus.
Katra numura rinda ļauj iestatīt maršrutēšanas režīmu, izvēlēties ienākošo zvanu balss aģentu
un pievienot numuram etiķeti.
**Informācijas panelī:** **Tālruņa numuri** (`/dashboard/phone-numbers`).
Skatiet [Tālruņa numura iegūšana](/lv/guides/get-a-phone-number).
**API:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).
***
## Zvani
Katrs ienākošais zvans, izejošais zvans, simulācija un logrīka sesija
kļūst par **zvanu žurnālu**. Zvanā tiek saglabāta pilna transkripcija ar lomu atzīmēm,
strukturēta sarunas gaitu vēsture (tostarp rīku izsaukumi), ieraksts,
kopējā maksa un neobligāts MI novērtējums un problēmu ziņojumi.
Kamēr zvans ir **aktīvs**, varat to atvērt un **klausīties sarunu** — jūs pievienojaties
klusumā, un neviens sarunas dalībnieks jūs nedzird. Kad klausāties, varat
**čukstēt**: ierakstiet norādījumu, kas zvana laikā tiek nosūtīts tieši jūsu balss aģentam;
zvanītājs to nekad nedzird, un balss aģents to izpilda uzreiz.
**Informācijas panelī:** **Zvanu vēsture** (`/dashboard/call-history`) —
arhīvam un detalizētai informācijai par katru zvanu; **Tiešraide** — zvaniem, kas pašlaik notiek. Skatiet
[Pārskatiet, klausieties un vadiet savus zvanus](/lv/guides/review-calls).
**API:** [`/v1/calls`](/api-reference/calls) — saraksts, transkripcija,
vēsture, audio, novērtēšana, eksportēšana;
[`/v1/issue-reports`](/api-reference/issue-reports).
***
## Tīmekļa logrīki
**Tīmekļa logrīks** nodrošina jūsu vietnes apmeklētājiem sarunu ar balss aģentu,
izmantojot mikrofonu — tālruņa numurs nav nepieciešams. Tas autentificējas ar
**publicējamu atslēgu** (`pk_live_...`), kas ir piesaistīta jūsu
atļauto domēnu izcelsmei, tāpēc to var droši izmantot klienta puses kodā.
Atslēgas darbojas vienā no diviem režīmiem: `agent` (statiski piesaistīts vienam balss aģentam)
vai `webhook` (jūsu serveris katram apmeklētājam izvēlas konfigurāciju — skatiet
[Dinamiska konfigurācija katram zvanam](/lv/guides/dynamic-call-config)). Logrīku
sesijās tiek izmantota tā pati zvanu infrastruktūra kā tālruņa zvaniem.
**Informācijas panelī:** **Tīmekļa logrīki** (`/dashboard/web-widgets`) —
izveidojiet logrīkus, iestatiet režīmu un balss aģentu, pārvaldiet atļautos domēnus un
kopējiet iegulšanas fragmentu. Skatiet
[Tīmekļa logrīka izveide](/lv/guides/embed-a-web-widget-dashboard).
**API:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) un
[logrīka SDK dokumentācija](/lv/widget/overview).
***
## Zināšanu bāzes
**Zināšanu bāze** ir dokumentu kopa, kurā jūsu balss aģents var meklēt
zvana laikā, lai pamatotu savas atbildes — augšupielādējiet failus tieši vai importējiet tos no
Google Drive, pēc tam veidotājā pievienojiet zināšanu bāzi balss aģentam. Balss
aģents veic vaicājumus tajā ar iebūvētu meklēšanas rīku, kad tas ir nepieciešams
sarunai.
**Informācijas panelī:** **Zināšanas** (`/dashboard/knowledge`) —
dokumentu bibliotēkai; veidotāja sadaļa **Zināšanas**, lai pievienotu to
balss aģentam. Skatiet
[Piešķiriet savam balss aģentam zināšanu bāzi](/lv/guides/knowledge-base).
***
## Savienojumi
Savienojumi ļauj balss aģentiem sasniegt ārējo pasauli. Četri veidi, viena
sānjoslas grupa:
* **Lietotnes** (`/dashboard/app-connections`) — OAuth savienojumi ar
Slack, HubSpot, Salesforce, Google Calendar, Google Sheets un
Cal.com. Savienojiet vienreiz, pēc tam ieslēdziet atsevišķu darbību rīkus
(nosūtīt Slack ziņojumu, atjaunināt vai izveidot HubSpot kontaktu, rezervēt Cal.com laiku…)
jebkuram balss aģentam. Skatiet [Savienot lietotnes](/lv/guides/connect-apps).
* **API** (`/dashboard/api-connections`) — pārvērtiet jebkuru HTTP API par
balss aģenta darbību. Ielīmējiet cURL komandu, un MI vednis sagatavos rīka
definīciju, vai izveidojiet to manuāli; poga **Testēt pieprasījumu** veic
smilškastes izsaukumu pirms izvietošanas. Skatiet
[API savienojumi](/lv/guides/api-connections) — informācijas paneļa saskarni
[`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — pievienojiet Model Context
Protocol serveri pēc URL un ļaujiet balss aģentam izmantot tā pieejamos rīkus.
Skatiet [Pievienot MCP serveri](/lv/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — pakalpojumu sniedzēja akreditācijas dati
[savu tālruņa numuru izmantošanai](#phone-numbers). Skatiet
[Savienot VoIP pakalpojumu sniedzēju](/lv/guides/voip-providers).
**API:** [`/v1/integrations`](/api-reference/integrations) un
[`/v1/voip-connections`](/api-reference/voip-connections); skatiet arī
[Izveidot rīka integrāciju](/lv/guides/build-tool-integration).
***
## Kampaņas
**Kampaņa** veic izejošos zvanus lielā apjomā: augšupielādējiet kontaktu
CSV failu, izvēlieties balss aģentu un izejošo numuru, kā arī iestatiet zvanīšanas logu
(dienas un stundas, ņemot vērā laika joslu), vienlaicīgo zvanu skaitu un atkārtoto mēģinājumu politiku
(maksimālo mēģinājumu skaitu un kuriem rezultātiem — neatbildēja, balss pasts, neizdevās —
tiek veikti atkārtoti mēģinājumi). Kampaņa apstrādā sarakstu un reģistrē katru zvanu
Zvanu vēsturē.
**Informācijas panelī:** **Kampaņas** (`/dashboard/campaigns`). Skatiet
[Veikt izejošo zvanu kampaņu](/lv/guides/outbound-campaigns).
**Atsevišķiem programmatiskiem zvaniem:** izmantojiet
[izejošo zvanu API](/lv/guides/place-outbound-calls).
***
## Tiešraides uzraudzība
**Tiešraide** rāda katru organizācijā notiekošo zvanu un ļauj jums
atvērt jebkuru no tiem, lai [klausītos un sniegtu norādes](#calls) reāllaikā. Tā ir
uzraudzības vide: vērojiet, kā jauna uzvedne saņem pirmo reālo datplūsmu,
vai pārraugiet aktīvu kampaņu.
**Informācijas panelī:** **Tiešraide** (`/dashboard/live`). Skatiet
[Skatīt un uzraudzīt tiešraides zvanus](/lv/guides/monitor-live-calls).
***
## Simulācijas
**Simulācija** ir MI zvanītājs, kas veido reālu sarunu ar jūsu
balss aģentu — tas pats telefonijas ceļš, reāls transkripts, reāla novērtēšana — lai jūs
varētu testēt pirms (un pēc) izvietošanas. Norādiet balss aģentu vai tālruņa
numuru, paši uzrakstiet zvanītāja scenāriju vai **ģenerējiet scenārijus
ar MI** no balss aģenta uzvednes (tostarp robežgadījumus, ja tos pieprasāt),
un vērojiet zvanu tiešraidē.
Scenāriji tiek grupēti **komplektos**, kuros tiek fiksēts minimālais sekmju rādītājs un kuri
var bloķēt laidienus CI vidē; regresijas attiecībā pret apstiprināto bāzlīniju tiek
ziņotas katram scenārijam.
**Informācijas panelī:** **Simulācijas** (`/dashboard/simulations`), kā arī
poga **Simulācija** balss aģenta veidotājā. Skatiet
[Simulēt zvanu](/lv/guides/simulate-a-call).
**API:** [`/v1/test-calls`](/api-reference/test-calls) un
komplektu izpildītājs — skatiet [Testēt balss aģentu no sākuma līdz beigām](/lv/guides/test-agents).
***
## Eksperimenti
**Eksperiments** veic balss aģenta konfigurāciju A/B testēšanu reālajā datplūsmā:
definējiet variantus (dažādas uzvednes, dzinējus vai iestatījumus), sadaliet
datplūsmu starp tiem un salīdziniet rezultātus katram variantam. Izmantojiet to,
nevis manuāli veidojiet segmentu loģiku tīmekļa aizķerē.
**Informācijas panelī:** **Eksperimenti** (`/dashboard/experiments`) un
cilne **A/B** balss aģenta veidotājā. Skatiet
[Eksperimenti (A/B testēšana)](/lv/guides/experiments-ab-testing).
***
## Problēmas
**Problēma** ir atzīmēta problēma konkrētā zvanā — to reģistrē
cilvēks, kas veic pārskatīšanu, vai tā tiek noteikta ar AI vērtējumu. Problēmām ir smaguma pakāpe,
avots un statuss, un lapa Problēmas ir prioritāšu izvērtēšanas rinda: filtrējiet,
pārbaudiet problemātisko zvanu un sekojiet labojumiem.
**Panelī:** **Problēmas** (`/dashboard/issues`), kā arī atzīmēšana katram zvanam
zvanu vēsturē. Skatiet [Problēmu izvērtēšana](/lv/guides/issues).
**API:** [`/v1/issue-reports`](/api-reference/issue-reports).
***
## Pārskati
**Pārskats** sniedz atbildi uz dabiskās valodas jautājumu par jūsu zvanu datiem
("Kādi bija trīs galvenie iemesli, kādēļ zvanītāji pagājušajā nedēļā lūdza cilvēka palīdzību?")
ar AI izveidotu analīzi, kas attiecas uz jūsu izvēlētajiem
balss aģentiem un datumu diapazonu.
**Panelī:** **Pārskati** (`/dashboard/reports`). Skatiet
[Pārskati](/lv/guides/reports).
***
## Novērojamība
**Novērojamība** ir metrikas skats: zvanu apjoms, rezultāti un
kvalitāte laika gaitā, filtrējama pēc balss aģenta un laika perioda, ar eksportēšanu
turpmākai analīzei.
**Panelī:** **Novērojamība** (`/dashboard/observability`).
Skatiet [Novērojamība](/lv/guides/observability).
***
## Brīdinājumi
**Brīdinājuma kārtula** uzrauga metriku (veiksmju rādītāju, kļūmju rādītāju,
vidējo vērtējumu, zvanu apjomu, komplektu regresijas) noteiktā laika periodā un
aktivizējas, kad tā pārsniedz jūsu slieksni. Paziņojumi tiek sūtīti uz e-pastu un
Slack, kā arī tiek izraisīts `alert.triggered` notikums jūsu
[tīmekļa aizķeres galapunktos](/lv/webhooks/endpoints).
**Panelī:** **Organizācija → Brīdinājumi**. Skatiet
[Brīdinājumi](/lv/guides/alerts).
***
## Tīmekļa aizķeres
ThunderPhone nosūta **HTTP POST tīmekļa aizķeres** uz jūsu serveri, kad
zvana laikā un pēc tā notiek darbības. Divi piegādes modeļi:
* **Tīmekļa aizķeres galapunkti** (ieteicams): pārvaldiet daudzus URL adresē
[`/v1/developer/webhook-endpoints`](/lv/webhooks/endpoints), izmantojot
katram galapunktam paredzētus noslēpumus un notikumu abonementus.
* **Mantotā viena URL tīmekļa aizķere**: viens URL katrai organizācijai. Pārvalda adresē
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
vai sadaļā **Organizācija → Vispārīgi**. Saglabāta atpakaļsaderībai.
Notikumi ir sadalīti divās klasēs:
* **Bloķējošie notikumi** paredz, ka jūsu serveris atbildēs ar konfigurāciju,
kas ietekmē notiekošo zvanu — tie ir
[ienākošo zvanu notikumi](/lv/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Jums ir līdz 10 sekundēm,
lai atbildētu; noildzes gadījumā zvanu apstrādā statiski piešķirtais
balss aģents.
* **Nebloķējošie notikumi** ir nosūtīšanas un aizmiršanas paziņojumi, kas tiek atkārtoti
ar eksponenciāli pieaugošu aizkavi — skatiet
[piegādes semantiku](/lv/webhooks/overview).
Katram pieprasījumam ir HMAC-SHA256 paraksts laukā
`X-ThunderPhone-Signature`. Skatiet
[Paraksta verifikācija](/lv/webhooks/overview).
***
## Funkciju rīki
**Funkciju rīks** ir HTTP galapunkts, ko jūsu balss aģents var izsaukt
sarunas laikā. Jūs sniedzat ThunderPhone OpenAI stila funkcijas
shēmu un galapunkta URL; balss aģents nosaka, kad to izsaukt, un
ThunderPhone no saviem serveriem nosūta parakstītu HTTP pieprasījumu un nodod
rezultātu atpakaļ balss aģentam.
Balss aģentiem ir arī **iebūvētas zvanu iespējas** — zvana pārsūtīšana,
tastatūras (DTMF) ievades sūtīšana, zvana beigšana, gaidīšana aizturēšanā — kuras
iespējojat ar parastām uzvednes rindām, nevis rīku definīcijām.
**Panelī:** veidotāja sadaļa **API savienojumi** (skatiet
[Savienojumi](#connections)).
**API:** [`/v1/integrations`](/api-reference/integrations) un
[Funkciju rīku specifikācija](/lv/tools/overview).
***
## Komanda un lomas
Katrai organizācijai ir dalībnieku saraksts ar divām lomām: **Dalībnieki** izveido
un pārvalda balss aģentus; **Administratori** pārvalda arī komandu un norēķinus.
Uzaiciniet pa e-pastu — uzaicinājumu derīgums beidzas pēc 7 dienām, un tos var atsaukt;
izvēlne ⋯ dalībnieka rindā maina lomas vai noņem personu. Vienoto
pieteikšanos var konfigurēt visai organizācijai — skatiet [SSO](/lv/guides/sso).
**Panelī:** **Organizācija → Vispārīgi**. Skatiet
[Uzaiciniet savu komandu](/lv/guides/invite-your-team).
**API:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
***
## Norēķini
ThunderPhone ir **priekšapmaksas** pakalpojums. Katrai organizācijai ir USD atlikums; zvani to samazina atbilstoši balss aģenta minūtes likmei (dzinēja līmenis un piemaksas —
veidotājs, mainot iestatījumus, reāllaikā parāda kopējo likmi, un
[augstākās klases valodas](/lv/guides/supported-languages) pievieno 2¢/min). Kad
atlikums sasniedz nulli, ienākošie zvani tiek noraidīti, bet izejošie zvani atgriež
`402 Payment Required`.
Papildiniet atlikumu manuāli vai iespējojiet **automātisko papildināšanu**, norādot atlikuma slieksni,
papildināšanas summu un izvēles mēneša tēriņu limitu — lai zvans
nekad nepārtrūktu teikuma vidū.
**Vadības panelī:** **Organizācija → Norēķinu iestatījumi** un
**Norēķinu vēsture**. Skatiet
[Pievienojiet līdzekļus un ieslēdziet automātisko papildināšanu](/lv/guides/billing-and-topups).
**API:** [`/v1/billing`](/api-reference/billing).
***
## Lietotnē iebūvētais palīgs
Vadības panelī ir iebūvēts **palīgs** — pajautājiet tam: “kā veikt X”,
un tas atbildēs, izmantojot šo dokumentāciju, piedāvās detalizētus
norādījumus pa klikšķiem, kas izceļ faktiskās vadīklas, un var atkārtoti palaist jebkuru
no vadītajiem ceļvežiem. Tas ir ātrākais veids, kā atrast vadīklu, kas minēta šajā lapā.
Skatiet [Jautājiet lietotnē iebūvētajam palīgam](/lv/guides/ask-the-copilot).
***
## Apkopojot
Piecu darbību vednis: aģents → norēķini → numurs → simulācija → pārskatīšana.
Tas pats pirmais zvans četros REST izsaukumos.
Izveidojiet aģentu, papildiniet tā atlikumu, iegūstiet numuru, simulējiet un pārskatiet zvanus.
OAuth lietotnes, pielāgotas API, MCP serveri un VoIP pakalpojumu sniedzēji.
Pārskati, novērojamība, eksperimenti, problēmas un brīdinājumi.
Uzaicinājumi un lomas, API atslēgas, drošība un SSO.
API receptes: ienākošie zvani, izejošie zvani, dinamiska konfigurācija, rīki, testēšana.
Vienreiz pareizi ieviesiet HMAC pārbaudi un izmantojiet to visur.