> ## 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.
# Concepte de bază
> O hartă a tuturor elementelor din platformă — ce face fiecare obiect, unde se află în tabloul de bord și ce API îl gestionează.
ThunderPhone este o platformă completă pentru construirea, rularea și îmbunătățirea
agenților vocali AI. Această pagină este harta: fiecare concept pe care îl veți întâlni, într-o
secțiune scurtă, cu suprafața din tabloul de bord și API-ul care o susține.
Parcurgeți-o o dată, apoi reveniți ori de câte ori un termen necesită clarificări.
Bara laterală a tabloului de bord reflectă această structură:
[Agenți](#agents), [numere de telefon](#phone-numbers),
[widgeturi web](#web-widgets), [apeluri](#calls),
[baze de cunoștințe](#knowledge-bases).
[Monitorizare live](#live-monitoring) și
[campanii](#campaigns) de apeluri efectuate.
[Aplicații, API-uri, servere MCP și furnizori VoIP](#connections) pe care
agenții dumneavoastră le pot utiliza.
[Simulări](#simulations), [experimente](#experiments),
[probleme](#issues), [rapoarte](#reports),
[observabilitate](#observability).
[Echipă și roluri](#team-and-roles), [chei API](#organizations),
[alerte](#alerts), [facturare](#billing).
[Webhookuri](#webhooks) și [instrumente de funcții](#function-tools) pentru
propriul dumneavoastră cod.
***
## Organizații
O **organizație** este unitatea de tenant. Fiecare altă resursă —
agenți, numere de telefon, apeluri, chei — aparține exact unei organizații. Contul dumneavoastră
poate aparține mai multor organizații; fiecare are propriul sold, propriile
chei și propria listă de membri.
Cheia API `sk_live_` pe care o creați în **Organizație → Chei** este
asociată unei organizații. Această asociere face ca API-ul REST să fie atât de
simplu: nu introduceți niciodată un ID de organizație în căile URL, deoarece cheia dumneavoastră
o identifică deja.
**În tabloul de bord:** selectorul de organizații (în subsolul barei laterale) și
setările **Organizație** — filele General, Chei, Alerte, Setări de facturare
și Istoric facturare.
**În API:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Agenți
Un **agent** este configurația AI care gestionează un apel. Aceasta include:
* Un **prompt** care stabilește ce spune agentul și cum se comportă —
inclusiv acțiuni din apel, precum transferuri, apăsări de taste și închideri de apel,
care sunt linii simple în prompt, nu configurații separate.
* Un **nivel de motor** (`spark`, `bolt`, `storm-*`): Spark este optimizat
pentru cost, Bolt pentru viteză, Storm pentru inteligență în cazul prompturilor complexe.
* O **voce**, o **limbă principală** și opțional **limbi
suplimentare** — agentul schimbă automat limba atunci când apelantul schimbă
limba. Consultați [Limbile acceptate](/ro/guides/supported-languages).
* Capacități atașate: [aplicații conectate](#connections),
[conexiuni API](#connections), [baze de cunoștințe](#knowledge-bases),
[servere MCP](#connections) și
[instrumente de funcții](#function-tools) inline.
* Opțiuni de comportament: ordinea vorbirii, modul de confirmare, pista de fundal,
timpul de expirare pentru așteptare.
Modificările din builder se **salvează automat într-o schiță**; nimic nu devine activ până când
nu faceți clic pe **Implementați**. Fiecare implementare este păstrată ca instantaneu în fila
**Istoric** a builderului, astfel încât puteți inspecta și restaura orice versiune anterioară.
**În tabloul de bord:** **Agenți vocali** → builderul de agenți
(`/dashboard/agents`). Consultați
[Construiți primul agent vocal](/ro/guides/build-an-agent).
**În API:** [`/v1/agents`](/api-reference/agents) — CRUD,
duplicare, transfer, istoric al versiunilor și instrumente ajutătoare pentru prompturi.
***
## Numere de telefon
Un **număr de telefon** aparține unei organizații și direcționează apelurile primite către un
agent (și poate gestiona apeluri efectuate). Două surse:
* **Numere demo** — numere reale din SUA, provisionate din grupul de numere al ThunderPhone,
active în câteva secunde. Doar pentru apeluri primite, răspund cu un scurt
mesaj vocal de informare, iar tabloul de bord limitează o organizație la 10 astfel de numere. Perfecte pentru
un prim test; nu pentru producție.
* **Numere VoIP** — aduse de la propriul furnizor printr-o
[conexiune VoIP](#connections). Twilio și Telnyx se conectează direct
(Telnyx are o configurare ghidată); SignalWire și Vonage vor fi disponibile în curând —
în prezent le puteți accesa prin configurare SIP manuală, care acceptă orice
trunk SIP. După importare și verificare, numerele VoIP acceptă apeluri
primite și efectuate.
Fiecare rând de număr vă permite să setați un mod de rutare, să selectați
agentul pentru apeluri primite și să etichetați numărul.
**În tabloul de bord:** **Numere de telefon** (`/dashboard/phone-numbers`).
Consultați [Obțineți un număr de telefon](/ro/guides/get-a-phone-number).
**În API:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).
***
## Apeluri
Fiecare apel primit, apel efectuat, simulare și sesiune de widget
devine un **jurnal de apel**. Un apel include transcrierea completă cu roluri etichetate,
istoricul structurat al schimburilor de replici (inclusiv apelurile de instrumente), o
înregistrare, totalul facturării și, opțional, evaluarea AI și rapoarte de probleme.
Cât timp un apel este **activ**, îl puteți deschide și îl puteți **asculta** — vă alăturați
în mod silențios și nimeni din apel nu vă aude. După ce ascultați, puteți
**șopti**: introduceți o instrucțiune care ajunge direct la agentul dumneavoastră
în timpul apelului; apelantul nu o aude niciodată, iar agentul o urmează în timp real.
**În tabloul de bord:** **Istoric apeluri** (`/dashboard/call-history`) pentru
arhivă și detaliile fiecărui apel; **Live** pentru apelurile în desfășurare. Consultați
[Revizuiți, ascultați și ghidați-vă apelurile](/ro/guides/review-calls).
**În API:** [`/v1/calls`](/api-reference/calls) — listă, transcriere,
istoric, audio, evaluare, export;
[`/v1/issue-reports`](/api-reference/issue-reports).
***
## Widgeturi web
**Widgetul web** le oferă vizitatorilor site-ului dumneavoastră o conversație bazată pe microfon
cu un agent — nu este necesar un număr de telefon. Se autentifică folosind o
**cheie publicabilă** (`pk_live_...`) restricționată la originea domeniilor
permise, astfel încât poate fi utilizată în siguranță în codul de partea clientului.
Cheile funcționează într-unul dintre două moduri: `agent` (asociat static cu un agent)
sau `webhook` (serverul dumneavoastră selectează configurația pentru fiecare vizitator — consultați
[Configurare dinamică pentru fiecare apel](/ro/guides/dynamic-call-config)). Sesiunile widgetului
trec prin aceeași infrastructură de apeluri ca apelurile telefonice.
**În tabloul de bord:** **Widgeturi web** (`/dashboard/web-widgets`) —
creați widgeturi, setați modul și agentul, gestionați domeniile permise și
copiați fragmentul de încorporare. Consultați
[Creați un widget web](/ro/guides/embed-a-web-widget-dashboard).
**În API:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) și
[documentația SDK pentru widget](/ro/widget/overview).
***
## Baze de cunoștințe
O **bază de cunoștințe** este un set de documente pe care agentul dumneavoastră le poate căuta
în timpul apelului pentru a-și fundamenta răspunsurile — încărcați fișiere direct sau importați din
Google Drive, apoi atașați baza de cunoștințe la un agent în
constructor. Agentul o interoghează cu un instrument de căutare integrat ori de câte ori
conversația o necesită.
**În tabloul de bord:** **Cunoștințe** (`/dashboard/knowledge`) pentru
biblioteca de documente; secțiunea **Cunoștințe** a constructorului pentru a atașa una
la un agent. Consultați
[Oferiți agentului dumneavoastră o bază de cunoștințe](/ro/guides/knowledge-base).
***
## Conexiuni
Conexiunile permit agenților vocali să ajungă în lumea exterioară. Patru tipuri, un
grup în bara laterală:
* **Aplicații** (`/dashboard/app-connections`) — conexiuni OAuth la
Slack, HubSpot, Salesforce, Google Calendar, Google Sheets și
Cal.com. Conectați o dată, apoi activați instrumente pentru fiecare operațiune
(trimiteți un mesaj Slack, actualizați sau creați un contact HubSpot, programați un interval Cal.com…)
pentru orice agent vocal. Consultați [Conectați aplicații](/ro/guides/connect-apps).
* **API-uri** (`/dashboard/api-connections`) — transformați orice API HTTP într-o
acțiune a agentului vocal. Lipiți o comandă cURL, iar asistentul AI creează o schiță a
definiției instrumentului sau construiți-o manual; un buton **Testare solicitare** efectuează un
apel sandbox înainte de lansare. Consultați
[Conexiuni API](/ro/guides/api-connections) — interfața din tabloul de bord pentru
[`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — adăugați un server Model Context
Protocol după URL și permiteți agentului vocal să utilizeze instrumentele pe care le expune.
Consultați [Adăugați un server MCP](/ro/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — acreditări de furnizor pentru
[utilizarea propriilor numere de telefon](#phone-numbers). Consultați
[Conectați un furnizor VoIP](/ro/guides/voip-providers).
**În API:** [`/v1/integrations`](/api-reference/integrations) și
[`/v1/voip-connections`](/api-reference/voip-connections); consultați și
[Construiți o integrare de instrument](/ro/guides/build-tool-integration).
***
## Campanii
O **campanie** efectuează apeluri de ieșire la scară largă: încărcați un CSV cu
contacte, alegeți agentul vocal și numărul apelant și setați fereastra de apelare
(zile și ore, cu fus orar), concurența și politica de reîncercare
(numărul maxim de încercări și rezultatele — fără răspuns, mesagerie vocală, eșuat —
care sunt reîncercate). Campania parcurge lista și înregistrează fiecare apel
în Istoricul apelurilor.
**În tabloul de bord:** **Campanii** (`/dashboard/campaigns`). Consultați
[Derulați o campanie de apelare de ieșire](/ro/guides/outbound-campaigns).
**Pentru apeluri programatice unice:** utilizați
[API-ul pentru apeluri de ieșire](/ro/guides/place-outbound-calls).
***
## Monitorizare în timp real
**În direct** afișează fiecare apel în desfășurare din organizație și vă permite să
deschideți oricare dintre ele pentru a [asculta și interveni în șoaptă](#calls) în timp real. Este
interfața de supraveghere: urmăriți cum un prompt nou primește primul trafic real
sau monitorizați o campanie în desfășurare.
**În tabloul de bord:** **În direct** (`/dashboard/live`). Consultați
[Urmăriți și supravegheați apeluri în timp real](/ro/guides/monitor-live-calls).
***
## Simulări
O **simulare** reprezintă un apelant AI care poartă o conversație reală cu
agentul dumneavoastră vocal — același traseu de telefonie, transcriere reală, evaluare reală —
astfel încât să puteți testa înainte de lansare (și după aceasta). Direcționați-o către un agent vocal sau un număr
de telefon, scrieți personal scenariul apelantului sau **generați scenarii
cu AI** din promptul agentului vocal (inclusiv cazuri limită, dacă solicitați acest lucru)
și urmăriți apelul în direct.
Scenariile sunt grupate în **suite** care stabilesc o rată minimă de reușită și pot
condiționa lansările în CI; regresiile față de etalonul acceptat sunt
raportate pentru fiecare scenariu.
**În tabloul de bord:** **Simulări** (`/dashboard/simulations`), plus
butonul **Simulare** din constructorul de agenți vocali. Consultați
[Simulați un apel](/ro/guides/simulate-a-call).
**În API:** [`/v1/test-calls`](/api-reference/test-calls) și
executorul de suite — consultați [Testați un agent vocal integral](/ro/guides/test-agents).
***
## Experimente
Un **experiment** testează A/B configurații de agenți vocali pe trafic real:
definiți variante (prompturi, motoare sau setări diferite), împărțiți
traficul între acestea și comparați rezultatele pentru fiecare variantă. Utilizați această opțiune în loc să
implementați manual logica de repartizare pe grupuri într-un webhook.
**În tabloul de bord:** **Experimente** (`/dashboard/experiments`) și
fila **A/B** din constructorul de agenți vocali. Consultați
[Experimente (testare A/B)](/ro/guides/experiments-ab-testing).
## Probleme
O **problemă** este o deficiență semnalată într-un anumit apel — raportată de un
evaluator uman sau detectată prin evaluare AI. Problemele includ gravitatea,
sursa și starea, iar pagina Probleme este coada de triaj: filtrați,
inspectați apelul problematic și urmăriți remedierea.
**În tabloul de bord:** **Probleme** (`/dashboard/issues`), plus
semnalarea per apel în Istoricul apelurilor. Consultați [Trierea problemelor](/ro/guides/issues).
**În API:** [`/v1/issue-reports`](/api-reference/issue-reports).
***
## Rapoarte
Un **raport** răspunde la o întrebare în limbaj natural despre datele apelurilor
dumneavoastră („Care au fost primele trei motive pentru care apelanții au solicitat un
agent uman săptămâna trecută?”) cu o analiză redactată de AI, limitată la
agenții și intervalul de date pe care le alegeți.
**În tabloul de bord:** **Rapoarte** (`/dashboard/reports`). Consultați
[Rapoarte](/ro/guides/reports).
***
## Observabilitate
**Observabilitatea** este zona de metrici: volumul apelurilor, rezultatele și
calitatea în timp, filtrabile după agent și interval de timp, cu export
pentru analize ulterioare.
**În tabloul de bord:** **Observabilitate** (`/dashboard/observability`).
Consultați [Observabilitate](/ro/guides/observability).
***
## Alerte
O **regulă de alertă** monitorizează o metrică (rata de succes, rata de eșec,
scorul mediu, volumul apelurilor, regresiile suitelor) într-un interval de timp și
se declanșează când depășește pragul dumneavoastră. Notificările sunt trimise prin e-mail și
Slack și declanșează un eveniment `alert.triggered` către
[endpointurile webhook](/ro/webhooks/endpoints).
**În tabloul de bord:** **Organizație → Alerte**. Consultați
[Alerte](/ro/guides/alerts).
***
## Webhookuri
ThunderPhone trimite **webhookuri HTTP POST** către serverul dumneavoastră atunci când se
întâmplă lucruri în timpul și după un apel. Două modele de livrare:
* **Endpointuri webhook** (recomandat): gestionați mai multe URL-uri la
[`/v1/developer/webhook-endpoints`](/ro/webhooks/endpoints), cu
secrete per endpoint și abonamente la evenimente per endpoint.
* **Webhook moștenit cu un singur URL**: un URL per organizație. Gestionat la
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
sau în **Organizație → General**. Păstrat pentru compatibilitate inversă.
Evenimentele se împart în două clase:
* **Evenimentele blocante** așteaptă ca serverul dumneavoastră să răspundă cu o configurație
care modelează apelul în desfășurare — evenimentele de
[apel primit](/ro/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Aveți la dispoziție până la 10 secunde
pentru a răspunde; la expirarea timpului, agentul atribuit static gestionează
apelul.
* **Evenimentele neblocante** sunt notificări de tip fire-and-forget, reîncercate
cu backoff exponențial — consultați
[semantica livrării](/ro/webhooks/overview).
Fiecare cerere include o semnătură HMAC-SHA256 în
`X-ThunderPhone-Signature`. Consultați
[Verificarea semnăturii](/ro/webhooks/overview).
***
## Instrumente de funcție
Un **instrument de funcție** este un endpoint HTTP pe care agentul dumneavoastră îl poate apela
în mijlocul conversației. Furnizați ThunderPhone o schemă de funcție în stil OpenAI
plus un URL de endpoint; agentul decide când să îl apeleze, iar
ThunderPhone efectuează cererea HTTP semnată de pe serverele sale și transmite
rezultatul înapoi agentului.
Agenții includ și **capacități de apel integrate** — transferarea apelului,
trimiterea de intrare de la tastatură (DTMF), încheierea apelului, așteptarea în așteptare — pe care
le activați prin linii simple de prompt, în locul definițiilor de instrumente.
**În tabloul de bord:** secțiunea **Conexiuni API** a constructorului (consultați
[Conexiuni](#connections)).
**În API:** [`/v1/integrations`](/api-reference/integrations) și
[specificația Instrumente de funcție](/ro/tools/overview).
***
## Echipa și rolurile
Fiecare organizație are o listă de membri cu două roluri: **Membrii** construiesc
și operează agenți; **Administratorii** gestionează și echipa și facturarea.
Invitați prin e-mail — invitațiile expiră după 7 zile și pot fi revocate;
meniul ⋯ din rândul unui membru schimbă rolurile sau elimină o persoană. Autentificarea
unică poate fi configurată pentru întreaga organizație — consultați [SSO](/ro/guides/sso).
**În tabloul de bord:** **Organizație → General**. Consultați
[Invitați-vă echipa](/ro/guides/invite-your-team).
**În API:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
***
## Facturare
ThunderPhone este **preplătit**. Fiecare organizație are un sold în USD; apelurile îl debitează la tariful pe minut al agentului (nivelul motorului plus suprataxe —
constructorul afișează în timp real tariful total pe măsură ce modificați setările, iar
[limbile premium](/ro/guides/supported-languages) adaugă 2¢/min). Când
soldul ajunge la zero, apelurile de intrare sunt respinse, iar apelurile de ieșire returnează
`402 Payment Required`.
Alimentați manual sau activați **reîncărcarea automată** cu un prag de sold, o
sumă de reîncărcare și o limită lunară opțională de cheltuieli — astfel încât un apel
să nu se întrerupă niciodată la mijlocul unei propoziții.
**În tabloul de bord:** **Organizație → Setări de facturare** și
**Istoric facturare**. Consultați
[Adăugați fonduri și activați reîncărcarea automată](/ro/guides/billing-and-topups).
**În API:** [`/v1/billing`](/api-reference/billing).
***
## Copilotul din aplicație
Tabloul de bord include un **copilot** integrat — întrebați-l „cum fac X”
și răspunde pe baza acestei documentații, oferă ghiduri pas cu pas
care evidențiază controalele reale și poate relua oricare dintre tururile
ghidate. Este cea mai rapidă modalitate de a găsi un control menționat pe această pagină.
Consultați [Întrebați copilotul din aplicație](/ro/guides/ask-the-copilot).
***
## Cum se îmbină toate
Asistentul în cinci pași: agent → facturare → număr → simulare → revizuire.
Același prim apel în patru apeluri REST.
Creați un agent, alimentați-l, obțineți un număr, simulați și revizuiți apelurile.
Aplicații OAuth, API-uri personalizate, servere MCP și furnizori VoIP.
Rapoarte, observabilitate, experimente, probleme și alerte.
Invitații și roluri, chei API, securitate și SSO.
Rețete API: apeluri de intrare, apeluri de ieșire, configurare dinamică, instrumente, testare.
Configurați corect verificarea HMAC o dată și reutilizați-o peste tot.