---
title: "Zpracování příchozích hovorů (API)"
description: "Kompletní postup: nakonfigurujte 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ě? Dashboard vás provede přesně
  tímto postupem — vytvořením agenta, přidáním čísla, simulací a kontrolou — pomocí
  prohlídky. Začněte v
  [rychlém startu dashboardu](/cs/quickstart-dashboard).
</Note>

Základní postup „odpovědět na telefon pomocí AI“ z vašeho terminálu.
Budete:

1. Vytvoříte agenta s promptem a hlasem.
2. Zřídíte (nebo přenesete) telefonní číslo a přiřadíte agenta jako jeho
   obsluhu příchozích hovorů.
3. Zavoláte na číslo. Zkontrolujete protokol hovoru, přepis a nahrávku.

Celkový počet 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. U agenta můžete také nastavit limity hovoru, například `max_call_duration_seconds`
a `ring_duration_seconds`. U odchozích hovorů můžete také nastavit
`max_hold_seconds`, abyste omezili, jak dlouho agent čeká na přidržení, než hovor
ukončí. Agenti Bolt podporují také `audio_tier`, `endpointing` a `intelligence`
pro řízení toho, jak poslouchají a odpovídají: `intelligence` je `core` nebo `pro`
a `audio_tier` (Hearing) je `lite`, `standard`, `plus` nebo `max` (Max není
obecně dostupný). Starší hodnoty (`lite` a `standard` pro
intelligence; `lean`, `hearing` a `deep_hearing` pro poslech) jsou stále
akceptovány. Agenti s plným duplexem zachovávají stejný hlas ve podporovaných jazycích,
proto se u těchto hovorů nepoužívá přepínání hlasu podle jazyka. Agenti také
podporují `intro_clip` a `intro_ring_count` pro přehrání přednahraného úvodu a
až dvou zazvonění předtím, než agent promluví. Noví agenti také potřebují časové pásmo. Pokud
je váš agent vícejazyčný, můžete nastavit `language_switching` a určit,
zda se má před přepnutím jazyka zeptat, nebo se řídit jazykem volajícího.
U agenta můžete také nastavit `words` pro řízení výslovnosti konkrétních výrazů
a výrazů, kterým naslouchá.
Všechna konfigurační pole najdete v části [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": "bolt"
  }'
```

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

<Tip>
  Každý agent běží na `bolt`. Nastavte jej pomocí `intelligence` (Core je
  nejlevnější, Pro nejlépe následuje dlouhé prompty) a `audio_tier` (Plus pro
  hláskovaná jména a kódy). Viz
  [Nasazená pole](/api-reference/agents#deployed-fields).
</Tip>

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

Pokud potřebujete pouze číslo, na které lze volat, získejte čí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"}'
```

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

<Note>
  Čísla ThunderPhone jsou zpočátku pouze pro příchozí hovory. Administrátor organizace může
  na stránce Telefonní čísla požádat o odchozí volání. ThunderPhone každou
  žádost ručně posuzuje; po schválení mohou čísla uskutečňovat hovory a spouštět
  kampaně. VoIP čísla zákazníků zůstávají beze změny.
</Note>

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

Přiřaďte agenta z kroku 1 ke směru příchozích hovorů daného čí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še — číslo je aktivní. Po schválení odchozího volání pro vaši
organizaci můžete ve stejném PATCH nastavit také `outbound_agent_id`. Do té
doby API toto přiřazení odmítne s kódem `400`.

Pokud příchozí hovory směrujete přes konfigurační webhook namísto pevně nastaveného
`inbound_agent_id`, může tento webhook nyní pro každý hovor vrátit `timezone`
spolu s `agent_id` a `variables`. U agentů Bolt můžete při zápisech přes API
také nastavit `audio_tier`, `endpointing` a `intelligence` agenta.
API stále přijímá starší název `eagerness` jako alias pro
`endpointing`. Pokud váš agent používá připojení API s `trigger="call_start"`,
ThunderPhone může tyto nástroje spustit jednou na začátku každého telefonního hovoru před
pozdravem s využitím jejich uložených `call_start_arguments`.

### Zpětná volání k vašim odchozím hovorům

Když někdo zavolá zpět na číslo, které mu volalo během posledních 30
dnů, odpovídající agent obdrží stručnou poznámku na pozadí o daném hovoru:
kdy proběhl, který agent ho uskutečnil a co se stalo (bez odpovědi,
hlasová schránka nebo konverzace). Číslo bez příchozího agenta odešle
stejné údaje do vašeho webhooku konfigurace jako `returning_call`. Pokud
toto číslo nemá webhook nebo webhook vyprší či není dostupný, hovor se
místo ukončení přesměruje na agenta, který uskutečnil předchozí hovor.
ID volajícího lze zfalšovat, proto se souhrn a proměnné předchozího hovoru
sdílejí pouze tehdy, když administrátor v nabídce Organizace → Obecné → Zpětná volání zapne možnost **Sdílet podrobnosti předchozího hovoru**. Viz
[Zpětná volání](/cs/webhooks/call-incoming).

## 4. Přijměte hovor

Zavolejte na čí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.

Příchozí hovory se započítávají do limitu vaší organizace pro
[souběžné hovory](/api-reference/introduction#call-limits) (ve výchozím nastavení 20
probíhajících hovorů, sdílených s odchozími, webovými a testovacími
hovory). Hovor, který dorazí při dosažení limitu, je odmítnut předtím, než jej agent
přijme, a je ukončen, není účtován a je zaznamenán jako neúspěšný hovor
s důvodem ukončení `concurrent_call_limit_reached`. Pokud
potřebujete vyšší limit, napište na support@thunderphone.com.

## 5. Zkontrolujte výsledky

Načtěte seznam posledních hovorů:

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

Získejte přepis:

```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ě platnou, podepsanou):

```bash
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 požadavek POST na váš server — viz
[call.complete](/cs/webhooks/call-complete).

Pokud má váš agent nakonfigurovaná pole pro extrakci, může datová struktura dokončeného hovoru obsahovat také extrahovaná data ve strukturované podobě. Shrnutí hovorů se zapisují v jazyce, který vaše organizace používá v ThunderPhone, pokud agent toto nastavení nepřepíše.

---

## Další kroky

<CardGroup cols={2}>
  <Card title="Dynamická konfigurace pro každý hovor" icon="bolt" href="/cs/guides/dynamic-call-config">
    Vyberte jiného agenta pro každého volajícího podle telefonního čísla nebo
    vlastní logiky ve webhooku.
  </Card>
  <Card title="Přidejte integrace nástrojů" icon="screwdriver-wrench" href="/cs/guides/build-tool-integration">
    Umožněte agentovi volat vaše rozhraní API během konverzace.
  </Card>
  <Card title="Přepojování hovorů" icon="phone-arrow-right" href="/cs/guides/call-transfers">
    Směrujte volající přímo nebo před spojením prověřte cílovou stranu.
  </Card>
  <Card title="Přijímejte webhooky 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í pomocí 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 směrujte ke kontrole.
  </Card>
</CardGroup>
