Interacțiune
Monitorizare live și
campanii de apeluri efectuate.
Conexiuni
Aplicații, API-uri, servere MCP și furnizori VoIP pe care
agenții dumneavoastră le pot utiliza.
Calitate și testare
Organizație
Evenimente
Webhookuri și instrumente de funcții 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 APIsk_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,
/v1/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.
- Capacități atașate: aplicații conectate, conexiuni API, baze de cunoștințe, servere MCP și instrumente de funcții inline.
- Opțiuni de comportament: ordinea vorbirii, modul de confirmare, pista de fundal, timpul de expirare pentru așteptare.
/dashboard/agents). Consultați
Construiți primul agent vocal.
În API: /v1/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. 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.
/dashboard/phone-numbers).
Consultați Obțineți un număr de telefon.
În API: /v1/phone-numbers,
/v1/voip-connections,
/v1/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.
În API: /v1/calls — listă, transcriere,
istoric, audio, evaluare, export;
/v1/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). 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.
În API: /v1/publishable-key,
/v1/mic-session și
documentația SDK pentru widget.
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.
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. - 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 — interfața din tabloul de bord pentru/v1/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. - VoIP (
/dashboard/voip-connections) — acreditări de furnizor pentru utilizarea propriilor numere de telefon. Consultați Conectați un furnizor VoIP.
/v1/integrations și
/v1/voip-connections; consultați și
Construiți o integrare de instrument.
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.
Pentru apeluri programatice unice: utilizați
API-ul pentru apeluri de ieșire.
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ă î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.
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.
În API: /v1/test-calls și
executorul de suite — consultați Testați un agent vocal integral.
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).
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.
În API: /v1/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.
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.
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 evenimentalert.triggered către
endpointurile webhook.
În tabloul de bord: Organizație → Alerte. Consultați
Alerte.
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, 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/webhooksau în Organizație → General. Păstrat pentru compatibilitate inversă.
- Evenimentele blocante așteaptă ca serverul dumneavoastră să răspundă cu o configurație
care modelează apelul în desfășurare — evenimentele de
apel primit
(
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.
X-ThunderPhone-Signature. Consultați
Verificarea semnăturii.
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). În API:/v1/integrations și
specificația Instrumente de funcție.
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. În tabloul de bord: Organizație → General. Consultați Invitați-vă echipa. În API:/v1/members,
/v1/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 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ă.
În API: /v1/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.Cum se îmbină toate
Pornire rapidă în tabloul de bord
Asistentul în cinci pași: agent → facturare → număr → simulare → revizuire.
Pornire rapidă pentru API
Același prim apel în patru apeluri REST.
Utilizarea tabloului de bord
Creați un agent, alimentați-l, obțineți un număr, simulați și revizuiți apelurile.
Conectați instrumente și date
Aplicații OAuth, API-uri personalizate, servere MCP și furnizori VoIP.
Analizați și îmbunătățiți
Rapoarte, observabilitate, experimente, probleme și alerte.
Echipă și cont
Invitații și roluri, chei API, securitate și SSO.
Rețetar pentru dezvoltatori
Rețete API: apeluri de intrare, apeluri de ieșire, configurare dinamică, instrumente, testare.
Verificați semnăturile webhook
Configurați corect verificarea HMAC o dată și reutilizați-o peste tot.