---
title: "Gestionați apelurile primite (API)"
description: "De la început până la final: configurați un agent, atribuiți-l unui număr de telefon, preluați un apel și examinați transcrierea."
---
Vă construiți primul agent manual? Tabloul de bord parcurge exact acest
flux — construiți agentul, adăugați un număr, simulați, verificați — cu un
asistent ghidat. Începeți cu
[ghidul rapid pentru tabloul de bord](/ro/quickstart-dashboard).
Fluxul canonic „răspundeți la telefon cu ajutorul AI”, din terminalul dumneavoastră.
Veți:
1. Crea un agent cu un prompt și o voce.
2. Furniza (sau aduce) un număr de telefon și atribui agentul ca
gestionarul său pentru apelurile primite.
3. Apela numărul. Consulta jurnalul apelului, transcrierea și înregistrarea.
Număr total de apeluri API: patru. Timp total: sub cinci minute.
## 1. Creați un agent
Un agent reunește promptul, vocea și nivelul de produs care vor gestiona
apelul. De asemenea, puteți seta limite pentru apel, precum `max_call_duration_seconds`
și `ring_duration_seconds`, pentru agent. Agenții acceptă și `intro_clip`
și `intro_ring_count` pentru a reda o introducere preînregistrată și până la două sonerii înainte
ca agentul să vorbească. Agenții noi au nevoie și de un fus orar. Dacă agentul dumneavoastră este
multilingv, puteți seta `language_switching` pentru a controla dacă întreabă înainte
de a schimba limba sau urmează limba apelantului.
Consultați [Agenți](/api-reference/agents) pentru toate câmpurile de configurare; valoarea
minimă este:
```bash
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Support",
"prompt": "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
"voice": "john",
"product": "spark"
}'
```
Salvați `id` returnat — veți avea nevoie de el la pasul 2.
Alegeți `spark` pentru întrebări și răspunsuri simple la cel mai mic cost,
`bolt` atunci când viteza contează cel mai mult. Treceți la `storm-base-with-ack`
când promptul necesită raționament mai profund și poate tolera un mesaj de
umplere de jumătate de secundă cât timp modelul procesează. Consultați
[nivelurile de produs](/api-reference/agents#product-tiers-at-a-glance).
## 2. Obțineți un număr de telefon
Dacă aveți nevoie doar de un număr pe care să îl apelați, obțineți un număr
ThunderPhone din grupul de numere ThunderPhone:
```bash
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"area_code": "415"}'
```
Răspunsul include un `id` și un `number` în format E.164. Numerele ThunderPhone
încep cu `status="provisioning"` și devin `active` în câteva secunde — interogați
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
pentru a monitoriza tranziția, dacă este relevant pentru dumneavoastră.
Numerele ThunderPhone sunt inițial doar pentru apeluri primite. Un administrator
al organizației poate solicita apelare inițiată din pagina Numere de telefon.
ThunderPhone examinează manual fiecare solicitare; după aprobare, numerele pot
efectua apeluri și rula campanii. Numerele VoIP ale clienților rămân neschimbate.
## 3. Atribuiți agentul
Asociați agentul de la pasul 1 cu direcția de apeluri primite a numărului:
```bash
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'
```
Atât — numărul este activ. După aprobarea apelării inițiate pentru organizația
dumneavoastră, puteți seta și `outbound_agent_id` în același PATCH. Până atunci,
API-ul respinge această atribuire cu `400`.
Dacă direcționați apelurile primite printr-un webhook de configurare în loc de un `inbound_agent_id` fix, acel webhook poate returna acum un `timezone` pentru fiecare apel, împreună cu `agent_id` și `variables`.
## 4. Preluați un apel
Apelați numărul de pe telefonul dumneavoastră. Agentul răspunde, se prezintă
conform promptului dumneavoastră, iar conversația începe.
În timpul apelului, acesta apare în
[`GET /v1/calls`](/api-reference/calls#list-calls) cu
`status="in_progress"`. Când se încheie, înregistrarea se actualizează cu
`end_reason`, `duration_seconds`, `billable_minutes` și, în cele din urmă,
un URL pentru înregistrare și un scor AI.
Apelurile primite se iau în calcul pentru
[limita de apeluri simultane](/api-reference/introduction#call-limits) a organizației dumneavoastră (implicit, 20 de
apeluri în desfășurare, partajate cu apelurile efectuate, web și de test). Un apel care ajunge când limita este atinsă este refuzat înainte ca agentul să răspundă și este închis, nu este facturat și este înregistrat ca apel eșuat cu motivul de încheiere `concurrent_call_limit_reached`. Trimiteți un e-mail la support@thunderphone.com dacă aveți
nevoie de o limită mai mare.
## 5. Inspectați rezultatele
Preluați lista apelurilor recente:
```bash
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Preluați transcrierea:
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Și URL-ul înregistrării (semnat, cu valabilitate scurtă):
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Dacă v-ați abonat la
[webhook-ul `telephony.complete`](/ro/webhooks/events),
veți primi aceleași date printr-un POST către serverul dumneavoastră — consultați
[call.complete](/ro/webhooks/call-complete).
Dacă agentul dumneavoastră are configurate câmpuri de extracție, încărcătura utilă a apelului finalizat poate
include și date extrase structurate.
---
## Pașii următori
Alegeți un agent diferit pentru fiecare apelant pe baza numărului de telefon sau a
logicii personalizate dintr-un webhook.
Permiteți agentului să apeleze API-urile dumneavoastră în timpul conversației.
Direcționați apelanții direct sau verificați destinația înainte de a-i conecta.
Transmiteți fiecare apel finalizat către fluxul dumneavoastră CRM / de analiză.
Evaluați automat fiecare apel și direcționați apelurile marcate pentru revizuire.