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

# Apstrādājiet ienākošos zvanus (API)

> No sākuma līdz beigām: konfigurējiet balss aģentu, piešķiriet to tālruņa numuram, pieņemiet zvanu un pārskatiet transkriptu.

<Note>
  Veidojat savu pirmo aģentu manuāli? Informācijas panelis ved cauri tieši
  šai plūsmai — izveidojiet aģentu, pievienojiet numuru, simulējiet, pārskatiet — ar
  vadītu vedni. Sāciet ar
  [informācijas paneļa ātro sākumu](/lv/quickstart-dashboard).
</Note>

Standarta plūsma “atbildēt uz tālruni ar balss aģentu” no jūsu termināļa.
Jūs:

1. Izveidosiet aģentu ar uzvedni un balsi.
2. Nodrošināsiet (vai pievienosiet) tālruņa numuru un piešķirsiet aģentu kā tā
   ienākošo zvanu apstrādātāju.
3. Piezvanīsiet uz numuru. Apskatīsiet zvanu žurnālu, transkriptu un ierakstu.

Kopējais API izsaukumu skaits: četri. Kopējais laiks: mazāk nekā piecas minūtes.

## 1. Izveidojiet aģentu

Aģents apvieno uzvedni, balsi un produkta līmeni, kas vadīs
zvanu. Visus konfigurācijas laukus skatiet sadaļā [Aģenti](/api-reference/agents); minimālais nepieciešamais ir:

```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"
  }'
```

Saglabājiet atgriezto `id` — tas būs nepieciešams 2. darbībā.

<Tip>
  Vienkāršiem jautājumiem un atbildēm ar zemākajām izmaksām izvēlieties `spark`, bet `bolt` — ja
  vissvarīgākais ir ātrums. Ja jūsu uzvednei nepieciešama padziļinātāka spriešana un tā
  var pieļaut pussekundes aizpildījumu, kamēr modelis domā, pārejiet uz `storm-base-with-ack`.
  Skatiet
  [produktu līmeņus](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Iegūstiet tālruņa numuru

Ja jums vienkārši nepieciešams numurs, uz kuru zvanīt, nodrošiniet demonstrācijas numuru
no ThunderPhone kopas:

```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"}'
```

Atbilde ietver `id` un `number` E.164 formātā. Demonstrācijas numuri
sākas ar `status="provisioning"` un dažu sekunžu laikā kļūst `active` — aptaujājiet
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number),
lai sekotu pārejai, ja tas jums ir svarīgi.

<Note>
  Ražošanas videi izlaidiet demonstrācijas numurus un
  [pievienojiet savus numurus, izmantojot VoIP](/lv/guides/bring-your-own-numbers).
  Demonstrācijas numuri ir paredzēti tikai ienākošajiem zvaniem, un tiem ir apjoma ierobežojums.
</Note>

## 3. Piešķiriet aģentu

Piesaistiet 1. darbībā izveidoto aģentu numura ienākošo zvanu apstrādei:

```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}'
```

Tas arī viss — numurs ir aktīvs. Tajā pašā PATCH varat iestatīt arī `outbound_agent_id`,
lai numurs būtu gatavs arī izejošajiem zvaniem.

## 4. Pieņemiet zvanu

Zvaniet uz numuru no sava tālruņa. Aģents atbild, iepazīstina ar sevi
atbilstoši jūsu uzvednei, un saruna sākas.

Kamēr zvans notiek, tas tiek rādīts sadaļā
[`GET /v1/calls`](/api-reference/calls#list-calls) ar
`status="in_progress"`. Kad tas beidzas, ieraksts tiek atjaunināts ar
`end_reason`, `duration_seconds`, `billable_minutes` un (vēlāk)
ieraksta URL un MI vērtējumu.

## 5. Pārskatiet rezultātus

Iegūstiet pēdējo zvanu sarakstu:

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

Iegūstiet transkriptu:

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

Un ieraksta URL (īslaicīgs, parakstīts):

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

Ja esat abonējis
[`telephony.complete` tīmekļa aizķeri](/lv/webhooks/events),
saņemsiet tos pašus datus kā POST pieprasījumu savā serverī — skatiet
[call.complete](/lv/webhooks/call-complete).

***

## Nākamās darbības

<CardGroup cols={2}>
  <Card title="Dinamiska konfigurācija katram zvanam" icon="bolt" href="/lv/guides/dynamic-call-config">
    Izvēlieties citu balss aģentu katram zvanītājam, pamatojoties uz tālruņa numuru vai
    pielāgotu loģiku tīmekļa aizķerē.
  </Card>

  <Card title="Pievienojiet rīku integrācijas" icon="screwdriver-wrench" href="/lv/guides/build-tool-integration">
    Ļaujiet balss aģentam sarunas laikā izsaukt jūsu API.
  </Card>

  <Card title="Saņemiet call.complete tīmekļa aizķeres" icon="bolt" href="/lv/webhooks/call-complete">
    Straumējiet katru pabeigto zvanu uz savu CRM / analītikas konveijeru.
  </Card>

  <Card title="MI vērtēšana un problēmu pārskati" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Automātiski novērtējiet katru zvanu un novirziet atzīmētos zvanus pārskatīšanai.
  </Card>
</CardGroup>