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

# Zpracování příchozích hovorů (API)

> Kompletní postup: nastavte agenta, přiřaďte ho k telefonnímu číslu, přijměte hovor a zkontrolujte přepis.

<Note>
  Vytváříte svého prvního agenta ručně? Řídicí panel vás tímto přesným
  postupem — vytvoření agenta, přidání čísla, simulace, kontrola —
  provede pomocí průvodce. Začněte v
  [rychlém startu pro řídicí panel](/cs/quickstart-dashboard).
</Note>

Standardní postup „zvednout telefon pomocí AI“ přímo z vašeho terminálu.
Budete:

1. Vytvořte agenta s promptem a hlasem.
2. Zřiďte (nebo přidejte vlastní) telefonní číslo a přiřaďte agenta jako jeho
   obsluhu příchozích hovorů.
3. Zavolejte na číslo. Zkontrolujte protokol hovoru, přepis a nahrávku.

Celkem volání API: čtyři. Celkový čas: méně než pět minut.

## 1. Vytvořte agenta

Agent sdružuje prompt, hlas a produktovou úroveň, které budou řídit
hovor. Všechny konfigurační parametry najdete v části [Agenti](/api-reference/agents);
minimum je:

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

Uložte vrácené `id` — budete ho potřebovat v kroku 2.

<Tip>
  Pro jednoduché otázky a odpovědi za nejnižší cenu vyberte `spark`, pokud je
  nejdůležitější rychlost, vyberte `bolt`. Pokud váš prompt vyžaduje hlubší
  uvažování a snese půlsekundovou výplň, zatímco model přemýšlí, přejděte na
  `storm-base-with-ack`. Viz
  [produktové úrovně](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Získejte telefonní číslo

Pokud potřebujete pouze číslo, na které lze volat, zřiďte si ukázkové číslo
z fondu 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"}'
```

Odpověď obsahuje `id` a `number` ve formátu E.164. Ukázková čísla
začínají se stavem `status="provisioning"` a během několika sekund se stanou
`active` — pokud vás to zajímá, sledujte přechod dotazováním
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number).

<Note>
  Pro produkční použití ukázková čísla vynechte a
  [přidejte vlastní čísla přes VoIP](/cs/guides/bring-your-own-numbers).
  Ukázková čísla podporují pouze příchozí hovory a mají omezený objem.
</Note>

## 3. Přiřaďte agenta

Přidružte agenta z kroku 1 k příchozímu směru čísla:

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

To je vše — číslo je aktivní. Ve stejném PATCH můžete také nastavit
`outbound_agent_id`, aby bylo číslo připravené i pro odchozí hovory.

## 4. Přijměte hovor

Vytočte číslo ze svého telefonu. Agent hovor přijme, představí se podle
vašeho promptu a konverzace začne.

Během probíhajícího hovoru se zobrazí v
[`GET /v1/calls`](/api-reference/calls#list-calls) se stavem
`status="in_progress"`. Po skončení se záznam aktualizuje o
`end_reason`, `duration_seconds`, `billable_minutes` a (nakonec)
adresu URL nahrávky a hodnocení AI.

## 5. Zkontrolujte výsledky

Načtěte seznam nedávných hovorů:

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

Získejte přepis:

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

A adresu URL nahrávky (krátkodobou, podepsanou):

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

Pokud jste se přihlásili k odběru
[webhooku `telephony.complete`](/cs/webhooks/events),
obdržíte stejná data jako POST na váš server — viz
[call.complete](/cs/webhooks/call-complete).

***

## Další kroky

<CardGroup cols={2}>
  <Card title="Dynamická konfigurace pro jednotlivé hovory" icon="bolt" href="/cs/guides/dynamic-call-config">
    Vyberte pro každého volajícího jiného agenta podle telefonního čísla nebo
    vlastní logiky ve webhooku.
  </Card>

  <Card title="Přidání integrací nástrojů" icon="screwdriver-wrench" href="/cs/guides/build-tool-integration">
    Umožněte agentovi volat vaše API během konverzace.
  </Card>

  <Card title="Příjem webhooků call.complete" icon="bolt" href="/cs/webhooks/call-complete">
    Odesílejte každý dokončený hovor do svého CRM / analytického procesu.
  </Card>

  <Card title="Hodnocení AI a hlášení problémů" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Automaticky vyhodnocujte každý hovor a označené hovory odesílejte ke kontrole.
  </Card>
</CardGroup>