---
title: "Spracovanie prichádzajúcich hovorov (API)"
description: "Kompletný postup: nakonfigurujte agenta, priraďte ho k telefónnemu číslu, prijmite hovor a skontrolujte prepis."
---

<Note>
  Vytvárate svojho prvého agenta ručne? Ovládací panel vás prevedie presne
  týmto postupom — vytvoríte agenta, pridáte číslo, nasimulujete, skontrolujete —
  pomocou sprievodcu. Začnite v
  [rýchlom štarte ovládacieho panela](/sk/quickstart-dashboard).
</Note>

Štandardný postup „odpovedať na telefón pomocou AI“ z vášho terminálu.
Budete:

1. Vytvoríte agenta s promptom a hlasom.
2. Zriadite (alebo prinesiete) telefónne číslo a priradíte agenta ako jeho
   obsluhu prichádzajúcich hovorov.
3. Zavoláte na číslo. Skontrolujete protokol hovoru, prepis a nahrávku.

Celkový počet volaní API: štyri. Celkový čas: menej ako päť minút.

## 1. Vytvorenie agenta

Agent spája prompt, hlas a produktovú úroveň, ktoré budú riadiť
hovor. Všetky konfiguračné polia nájdete v časti [Agenti](/api-reference/agents);
minimum je:

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

Uložte vrátené `id` — budete ho potrebovať v kroku 2.

<Tip>
  Pre jednoduché otázky a odpovede pri najnižších nákladoch vyberte `spark`,
  keď je najdôležitejšia rýchlosť, vyberte `bolt`. Prejdite na `storm-base-with-ack`,
  keď váš prompt vyžaduje hlbšie uvažovanie a znesie polsekundovú výplň,
  kým model premýšľa. Pozrite si
  [produktové úrovne](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Získanie telefónneho čísla

Ak potrebujete iba číslo, na ktoré môžete volať, získajte číslo ThunderPhone
z fondu 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"}'
```

Odpoveď obsahuje `id` a `number` vo formáte E.164. Čísla ThunderPhone
začínajú v stave `status="provisioning"` a do niekoľkých sekúnd sa stanú
`active` — ak chcete sledovať tento prechod, periodicky volajte
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number).

<Note>
  Čísla ThunderPhone sú určené iba pre prichádzajúce hovory. Pre odchádzajúce hovory
  [použite vlastné čísla cez VoIP](/sk/guides/bring-your-own-numbers).
</Note>

## 3. Priradenie agenta

Priraďte agenta z kroku 1 k prichádzajúcemu smeru čísla:

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

To je všetko — číslo je aktívne. V tom istom požiadavku PATCH môžete nastaviť aj
`outbound_agent_id`, aby bolo číslo pripravené aj na odchádzajúce hovory.

## 4. Prijatie hovoru

Zavolajte na číslo zo svojho telefónu. Agent hovor prijme, predstaví sa
podľa vášho promptu a konverzácia sa začne.

Kým hovor prebieha, zobrazí sa v
[`GET /v1/calls`](/api-reference/calls#list-calls) so stavom
`status="in_progress"`. Keď sa skončí, záznam sa aktualizuje o
`end_reason`, `duration_seconds`, `billable_minutes` a (neskôr)
adresu URL nahrávky a hodnotenie AI.

## 5. Kontrola výsledkov

Načítajte zoznam posledných hovorov:

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

Získajte prepis:

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

A adresu URL nahrávky (krátkodobá, podpísaná):

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

Ak ste sa prihlásili na odber
[webhooku `telephony.complete`](/sk/webhooks/events),
rovnaké údaje dostanete ako požiadavku POST na váš server — pozrite si
[call.complete](/sk/webhooks/call-complete).

---

## Ďalšie kroky

<CardGroup cols={2}>
  <Card title="Dynamická konfigurácia pre jednotlivé hovory" icon="bolt" href="/sk/guides/dynamic-call-config">
    Vyberte pre každého volajúceho iného agenta na základe telefónneho čísla alebo
    vlastnej logiky vo webhoooku.
  </Card>
  <Card title="Pridať integrácie nástrojov" icon="screwdriver-wrench" href="/sk/guides/build-tool-integration">
    Umožnite agentovi počas konverzácie volať vaše API.
  </Card>
  <Card title="Prepojiť hovory" icon="phone-arrow-right" href="/sk/guides/call-transfers">
    Presmerujte volajúcich priamo alebo pred spojením preverte cieľovú stranu.
  </Card>
  <Card title="Prijímať webhooky call.complete" icon="bolt" href="/sk/webhooks/call-complete">
    Odosielajte každý dokončený hovor do svojho CRM / analytického procesu.
  </Card>
  <Card title="Hodnotenie AI a hlásenia problémov" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Automaticky vyhodnoťte každý hovor a označené hovory odošlite na kontrolu.
  </Card>
</CardGroup>