> ## 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.

# Gestionați apelurile primite (API)

> De la început până la sfârșit: configurați un agent, alocați-l unui număr de telefon, preluați un apel și inspectați transcrierea.

<Note>
  Construiți primul agent manual? Tabloul de bord vă ghidează prin acest flux exact — creați agentul, adăugați un număr, simulați, verificați — cu un asistent pas cu pas. Începeți cu
  [ghidul rapid pentru tabloul de bord](/ro/quickstart-dashboard).
</Note>

Fluxul canonic „răspunde la telefon cu un 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 gestionar pentru apelurile primite.
3. Apela numărul. Observa jurnalul apelului, transcrierea și înregistrarea.

Total 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. Consultați [Agenți](/api-reference/agents) pentru toate câmpurile de configurare; minimul este:

```bash theme={null}
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.

<Tip>
  Alegeți `spark` pentru întrebări și răspunsuri simple la cel mai mic cost, `bolt` când viteza contează cel mai mult. Faceți upgrade la `storm-base-with-ack` când promptul dumneavoastră necesită raționament mai aprofundat ș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).
</Tip>

## 2. Obțineți un număr de telefon

Dacă aveți nevoie doar de ceva pe care să îl apelați, furnizați un număr demo din grupul de numere ThunderPhone:

```bash theme={null}
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 demo pornesc 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 urmări tranziția, dacă vă interesează.

<Note>
  Pentru producție, omiteți numerele demo și
  [aduceți propriile numere prin VoIP](/ro/guides/bring-your-own-numbers).
  Numerele demo sunt numai pentru apeluri primite și au volum limitat.
</Note>

## 3. Atribuiți agentul

Asociați agentul de la pasul 1 cu direcția de apeluri primite a numărului:

```bash theme={null}
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. Puteți seta și `outbound_agent_id`
în același PATCH, astfel încât numărul să fie pregătit și pentru apeluri efectuate.

## 4. Preluați un apel

Apelați numărul de pe telefonul dumneavoastră. Agentul răspunde, se prezintă
conform promptului dumneavoastră și conversația începe.

În timp ce apelul este în desfășurare, 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 de înregistrare și evaluarea AI.

## 5. Inspectați rezultatele

Preluați lista apelurilor recente:

```bash theme={null}
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Preluați transcrierea:

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Și URL-ul înregistrării (cu durată scurtă de viață, semnat):

```bash theme={null}
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Dacă v-ați abonat la
[webhookul `telephony.complete`](/ro/webhooks/events),
veți primi aceleași date ca un POST către serverul dumneavoastră — consultați
[call.complete](/ro/webhooks/call-complete).

***

## Pașii următori

<CardGroup cols={2}>
  <Card title="Configurare dinamică pentru fiecare apel" icon="bolt" href="/ro/guides/dynamic-call-config">
    Alegeți un agent diferit pentru fiecare apelant, pe baza numărului de telefon sau a
    logicii personalizate dintr-un webhook.
  </Card>

  <Card title="Adăugați integrări de instrumente" icon="screwdriver-wrench" href="/ro/guides/build-tool-integration">
    Permiteți agentului să apeleze API-urile dumneavoastră în timpul conversației.
  </Card>

  <Card title="Primiți webhookuri call.complete" icon="bolt" href="/ro/webhooks/call-complete">
    Transmiteți fiecare apel finalizat către fluxul dumneavoastră CRM / de analiză.
  </Card>

  <Card title="Evaluare AI și rapoarte de probleme" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Evaluați automat fiecare apel și direcționați-le spre verificare pe cele semnalate.
  </Card>
</CardGroup>