--- title: "Concepte de bază" description: "O hartă a tuturor elementelor din platformă — ce face fiecare obiect, unde se află în tabloul de bord și ce API îl utilizează." --- ThunderPhone este o platformă completă pentru crearea, rularea și îmbunătățirea agenților vocali AI. Această pagină este harta: fiecare concept pe care îl veți întâlni, câte o secțiune scurtă pentru fiecare, împreună cu zona corespunzătoare 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ă explicații. Bara laterală a tabloului de bord reflectă această structură: [Agenți](#agents), [voci](#voices), [numere de telefon](#phone-numbers), [widgeturi web](#web-widgets), [apeluri](#calls), [portaluri pentru clienți](#client-portals), [cunoștințe](#knowledge-bases). [Monitorizare în timp real](#live-monitoring) și [campanii](#campaigns) outbound. [Aplicații, API-uri, servere MCP și furnizori VoIP](#connections) pe care agenții dumneavoastră le pot utiliza. [Simulări](#simulations), [seturi de validare](#validation-sets), [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 cod. --- ## Organizații O **organizație** este unitatea de găzduire. 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 direct: nu introduceți niciodată un ID de organizație în căile URL, deoarece cheia dumneavoastră îl identifică deja. **În tabloul de bord:** selectorul de organizații (în subsolul barei laterale) și setările **Organizație** — file pentru Contul meu, Generale, Chei, Alerte, Setări de facturare și Istoric facturare. Consultați [referința setărilor organizației](/ro/guides/organization-settings). **Î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 rulează un apel. Aceasta include: - Un **prompt** care stabilește ce spune agentul și cum se comportă — inclusiv acțiuni în apel, precum transferuri, apăsări de taste și închideri de apel, care sunt linii obișnuite în prompt, nu configurații separate. - Un **nivel de motor** (`spark`, `bolt`, `storm-*`): Spark este optimizat pentru cost, Bolt pentru viteză, iar Storm pentru inteligență în cazul prompturilor complexe. - O **voce**, o **limbă principală** și opțional **limbi suplimentare** — agentul comută automat 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) integrate. - Setări de comportament: ordinea vorbirii, modul de confirmare, pista de fundal, timpul limită de 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 **Publicați**. Fiecare publicare este salvată 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 [Crearea primului agent vocal](/ro/guides/build-an-agent). **În API:** [`/v1/agents`](/api-reference/agents) — CRUD, duplicare, transfer, istoric al versiunilor și ajutoare pentru prompturi. --- ## Voci **Biblioteca de voci** conține vocile pe care le poate utiliza un agent, mostrele redabile ale acestora, limbile compatibile, grupările după gen și accent, precum și orice suprataxă pentru voci/limbi premium. Un instrument de testare plătit poate sintetiza propria frază de 1–500 de caractere înainte de a alege. Organizațiile eligibile pot crea și **voci personalizate** dintr-o mostră WAV sau MP3 scurtă. Vocile personalizate au o cotă și un statut de creare asincron; când sunt gata, apar în același selector de agenți ca vocile din bibliotecă. **În tabloul de bord:** **Voci** (`/dashboard/voices`). Consultați [Biblioteca de voci și vocile personalizate](/ro/guides/voice-library). **În API:** [`/v1/voices`](/api-reference/voices), [mostre vocale](/api-reference/voice-samples) și [voci personalizate](/api-reference/custom-voices). --- ## 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 de ieșire). Există două surse: - **Numere ThunderPhone** — numere reale din SUA furnizate din grupul de numere ThunderPhone, active în câteva secunde, {/* rate:phone */}$1/lună plus o suprataxă de 1¢/minut{/* /rate */}. La început, acestea permit doar apeluri primite. Un administrator al organizației poate solicita apeluri efectuate din pagina Numere de telefon; ThunderPhone examinează fiecare solicitare manual, iar numerele aprobate pot efectua apeluri și rula campanii. O organizație poate deține implicit 25 de numere. - **Numere VoIP** — aduse de la propriul furnizor printr-o [conexiune VoIP](#connections). Twilio și Telnyx se conectează direct cu o cheie API (Telnyx oferă și configurare ghidată pentru conturi noi); SignalWire, Vonage, Plivo și orice alt trunk SIP se conectează prin configurare SIP, o configurare SIP manuală. După import ș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ă alegeț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 de ieșire, simulare și sesiune de widget devine un **jurnal de apeluri**. Un apel conține transcrierea completă etichetată cu roluri, istoricul structurat al tururilor (inclusiv apelurile de instrumente), o înregistrare, totalul facturării și, opțional, evaluare AI și rapoarte de probleme. Cât timp un apel este **activ**, îl puteți deschide și **asculta în direct** — 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 detalii pentru fiecare apel; **Live** pentru apelurile în desfășurare. Consultați [Examinați, ascultați și ghidați 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). --- ## Portaluri pentru clienți Un **portal pentru clienți** este o vizualizare de istoric al apelurilor, de marcă și doar pentru citire, pentru un client extern. Administratorii organizației aleg agenții ale căror apeluri apar, adaugă adresele de e-mail ale vizualizatorilor aprobați, încarcă o siglă și o culoare de accent și, opțional, verifică un domeniu personalizat. Vizualizatorii portalului pot examina detaliile apelurilor, transcrierile și înregistrările disponibile fără a primi acces la tabloul de bord. **În tabloul de bord:** **Portaluri pentru clienți** (`/dashboard/client-portals`). Consultați [Portaluri pentru clienți](/ro/guides/client-portals). **În API:** [`/v1/client-portals`](/api-reference/client-portals) pentru interfața de administrare. ## Widgeturi web **Widgetul web** le oferă vizitatorilor site-ului dumneavoastră o conversație cu un agent vocal prin microfon, fără a fi necesar un număr de telefon. Se autentifică printr-o **cheie publicabilă** (`pk_live_...`) pe care browserele o pot utiliza numai de pe domeniile permise, astfel încât poate fi folosită în siguranță în codul din partea clientului. Lista de domenii nu reprezintă autentificare, iar setările de sesiune pe care o pagină le poate trimite sunt dezactivate până când le permiteți pentru cheie. Cheile funcționează într-unul dintre două moduri: `agent` (asociată static cu un singur agent) sau `webhook` (serverul dumneavoastră alege configurația pentru fiecare vizitator — consultați [Configurare dinamică pentru fiecare apel](/ro/guides/dynamic-call-config)). Sesiunile widgetului folosesc 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 widgeturi](/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, lipiți text sau importați pagini web prin URL, apoi atașați baza de cunoștințe la un agent în builder. 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** din builder 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 să acceseze lumea externă. Patru tipuri, un singur grup în bara laterală: - **Aplicații** (`/dashboard/app-connections`) — conexiuni OAuth la Slack, HubSpot, Salesforce, Google Calendar, Google Sheets și Cal.com. Conectați-vă o singură dată, apoi activați pentru fiecare operațiune instrumente (publicați un mesaj Slack, creați sau actualizați un contact HubSpot, rezervați un interval Cal.com…) pentru orice agent. 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. Lipiți o comandă cURL, iar asistentul AI redactează definiția instrumentului sau creați-o manual; un buton **Cerere de testare** efectuează un apel în 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 prin URL și permiteți agentului 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). ThunderPhone expune, de asemenea, propriul endpoint MCP, astfel încât un client MCP extern să poată lista agenți, inspecta apeluri și transcrieri și efectua apeluri. Consultați [Utilizați ThunderPhone ca server MCP](/ro/guides/thunderphone-mcp-server). **În API:** [`/v1/integrations`](/api-reference/integrations), [`/v1/mcp-servers`](/api-reference/mcp-servers) și [`/v1/voip-connections`](/api-reference/voip-connections); consultați și [Construiți o integrare de instrumente](/ro/guides/build-tool-integration). --- ## Campanii O **campanie** efectuează apeluri outbound la scară largă: încărcați un CSV cu contacte, alegeți agentul și numărul apelant și setați intervalul 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 vor fi 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 apeluri outbound](/ro/guides/outbound-campaigns). **Pentru apeluri programatice punctuale:** [API-ul pentru apeluri outbound](/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 a 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 supravegheați o campanie în desfășurare. **În tabloul de bord:** **În direct** (`/dashboard/live`). Consultați [Urmăriți și supravegheați apelurile în timp real](/ro/guides/monitor-live-calls). --- ## Simulări O **simulare** este un apelant AI care poartă o conversație reală cu agentul dumneavoastră — aceeași rută de telefonie, transcriere reală, evaluare reală — astfel încât să puteți testa înainte (și după) lansare. Direcționați-o către un agent sau un număr de telefon, scrieți chiar dumneavoastră scenariul apelantului sau **generați scenarii cu AI** din promptul agentului (inclusiv cazuri-limită, dacă solicitați acest lucru) și urmăriți apelul în timp real. Scenariile sunt grupate în **suite** care stabilesc o rată minimă de reușită și pot bloca lansările în CI; regresiile față de baza de referință acceptată sunt raportate pentru fiecare scenariu. **În tabloul de bord:** **Simulări** (`/dashboard/simulations`), plus butonul **Simulare** din generatorul de agenți. 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 complet](/ro/guides/test-agents). --- ## Seturi de validare Un **set de validare** transformă momente reale din apeluri în verificări de regresie repetabile, cu un singur tur. Fiecare exemplu fixează contextul conversației, sunetul relevant al apelantului, răspunsul original și comportamentul așteptat. Reluările se execută pe versiunea curentă de lucru a agentului fără a plasa un alt apel, iar dialogul de implementare poate indica dacă ultima execuție corespunde în continuare acelei versiuni. **În tabloul de bord:** **Seturi de validare** (`/dashboard/validation`) pentru setul de date al organizației și fila **Validare** din generatorul de agenți pentru execuții. Consultați [Seturi de validare](/ro/guides/validation-sets). **În API:** [`/v1/validation-sets`](/api-reference/validation-sets) și punctele finale de reluare pentru agent/exemplu de pe aceeași pagină de referință. --- ## Experimente Un **experiment** testează A/B configurațiile agenților 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-l în loc să implementați manual logica de repartizare într-un webhook. **În tabloul de bord:** **Experimente** (`/dashboard/experiments`) și fila **A/B** din generatorul de agenți. Consultați [Experimente (testare A/B)](/ro/guides/experiments-ab-testing). --- ## Probleme O **problemă** este o situație semnalată într-un apel specific — 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 remediile. **În tabloul de bord:** **Probleme** (`/dashboard/issues`), plus semnalarea pentru fiecare apel în Istoricul apelurilor. Consultați [Triajul 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 om 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 interfața de metrici: volumul apelurilor, rezultatele și calitatea în timp, filtrabile după agent și interval de timp, cu export pentru analiză ulterioară. **Î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 suitei) într-un interval de timp și se declanșează când aceasta depășește pragul dumneavoastră. Notificările sunt trimise prin e-mail și Slack și declanșează un eveniment `alert.triggered` către [punctele finale 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 au loc evenimente î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 pentru fiecare endpoint și abonamente la evenimente pentru fiecare endpoint. - **Webhook vechi 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 cu versiunile anterioare. Evenimentele se împart în două clase: - **Evenimentele blocante** se așteaptă ca serverul dumneavoastră să răspundă cu o configurație care modelează apelul în desfășurare — [evenimentele pentru apeluri primite](/ro/webhooks/call-incoming) (`telephony.incoming` / `web.incoming`). Un apel telefonic așteaptă până la 13 secunde, inclusiv o reîncercare, iar o sesiune de widget 10 secunde. Nu există un agent de rezervă: fără o configurație utilizabilă, apelul telefonic este încheiat, iar sesiunea de widget eșuează. - **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 solicitare include o semnătură HMAC-SHA256 cu marcă temporală în `X-ThunderPhone-Signature-V2`, precum și semnătura moștenită, bazată doar pe corp, `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 timpul conversației. Oferiț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 **capabilități de apel integrate** — transferarea apelului, trimiterea de date de intrare de la tastatură (DTMF), încheierea apelului, așteptarea în pauză — pe care le activați cu linii simple în prompt, nu cu definiții de instrumente. **În tabloul de bord:** secțiunea **Conexiuni API** din constructor (consultați [Conexiuni](#connections)). **În API:** [`/v1/integrations`](/api-reference/integrations) și [specificația Instrumente de funcție](/ro/tools/overview). --- ## Echipă și roluri 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ă. Conectarea unică poate fi configurată la nivelul întregii organizații — 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 [anumite limbi suplimentare](/ro/guides/supported-languages) adaugă {/* rate:language */}3¢/min{/* /rate */}). Când soldul ajunge la zero, apelurile primite sunt respinse, iar apelurile efectuate returnează `402 Payment Required`. Alimentați manual soldul sau activați **alimentarea 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 jumătatea propoziției. **În tabloul de bord:** **Organizație → Setări de facturare** și **Istoric facturare**. Consultați [Adăugați fonduri și activați alimentarea automată](/ro/guides/billing-and-topups), precum și [referința completă privind prețurile](/ro/guides/pricing). **Î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 vă răspunde pe baza acestei documentații, vă 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 integrează Expertul î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 cu fonduri, 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țetele API: apeluri primite, apeluri efectuate, configurare dinamică, instrumente, testare. Configurați corect verificarea HMAC o dată și reutilizați-o peste tot.