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

# Bejövő hívások kezelése (API)

> Teljes folyamat: konfiguráljon egy ügynököt, rendelje hozzá egy telefonszámhoz, fogadjon egy hívást, és tekintse meg az átiratot.

<Note>
  Első ügynökét kézzel építi fel? Az irányítópult egy vezetett
  varázslóval végigvezeti pontosan ezen a folyamaton — az ügynök
  létrehozása, szám hozzáadása, szimuláció, ellenőrzés. Kezdje az
  [irányítópult gyorsindítójával](/hu/quickstart-dashboard).
</Note>

A kanonikus „telefonhívás fogadása AI-val” folyamat a terminálból.
A következőket fogja tenni:

1. Létrehoz egy ügynököt prompttal és hanggal.
2. Kiépít (vagy hoz) egy telefonszámot, és az ügynököt a bejövő
   hívások kezelőjeként rendeli hozzá.
3. Felhívja a számot. Megtekinti a hívásnaplót, az átiratot és a felvételt.

Összes API-hívás: négy. Teljes idő: kevesebb mint öt perc.

## 1. Ügynök létrehozása

Az ügynök egyesíti a hívást vezérlő promptot, hangot és termékszintet.
Az összes konfigurációs mezőt lásd az [Ügynökök](/api-reference/agents) oldalon; a minimum:

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

Mentse el a visszakapott `id` értéket — a 2. lépésben szüksége lesz rá.

<Tip>
  Egyszerű kérdés-válasz feladatokhoz a legalacsonyabb költségért válassza a `spark`-ot, ha pedig a sebesség a legfontosabb, a `bolt`-ot. Frissítsen `storm-base-with-ack` szintre, ha a promptja mélyebb érvelést igényel, és elvisel egy fél másodperces kitöltő szöveget, amíg a modell gondolkodik. Lásd a
  [termékszinteket](/api-reference/agents#product-tiers-at-a-glance).
</Tip>

## 2. Telefonszám beszerzése

Ha csak egy hívható számra van szüksége, építsen ki egy demószámot
a ThunderPhone készletéből:

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

A válasz tartalmaz egy `id` értéket és egy E.164 formátumú `number` értéket.
A demószámok `status="provisioning"` állapotban indulnak, és néhány
másodpercen belül `active` állapotúvá válnak — ha fontos Önnek, ismételten kérdezze le a
[`GET /v1/phone-numbers/{id}`](/api-reference/phone-numbers#retrieve-a-phone-number)
végpontot az átmenet követéséhez.

<Note>
  Éles használathoz hagyja ki a demószámokat, és
  [hozza saját számait VoIP-on keresztül](/hu/guides/bring-your-own-numbers).
  A demószámok csak bejövő hívásokhoz használhatók, és korlátozott a forgalmuk.
</Note>

## 3. Az ügynök hozzárendelése

Rendelje hozzá az 1. lépésben létrehozott ügynököt a szám bejövő
irányához:

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

Ennyi — a szám éles. Ugyanebben a PATCH kérésben az `outbound_agent_id`
értékét is beállíthatja, hogy a szám kimenő hívásokra is készen álljon.

## 4. Hívás fogadása

Hívja fel a számot a telefonjáról. Az ügynök felveszi, a promptjának
megfelelően bemutatkozik, és elkezdődik a beszélgetés.

Amíg a hívás folyamatban van, megjelenik a
[`GET /v1/calls`](/api-reference/calls#list-calls) válaszában
`status="in_progress"` állapottal. Amikor véget ér, a rekord frissül
az `end_reason`, `duration_seconds`, `billable_minutes` értékekkel, valamint
(később) egy felvételi URL-lel és AI-értékeléssel.

## 5. Az eredmények ellenőrzése

Kérje le a legutóbbi hívások listáját:

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

Kérje le az átiratot:

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

És a felvétel URL-jét (rövid élettartamú, aláírt):

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

Ha feliratkozott a
[`telephony.complete` webhookra](/hu/webhooks/events),
ugyanezeket az adatokat POST kérésként kapja meg a szerverén — lásd:
[call.complete](/hu/webhooks/call-complete).

***

## Következő lépések

<CardGroup cols={2}>
  <Card title="Dinamikus hívásonkénti konfiguráció" icon="bolt" href="/hu/guides/dynamic-call-config">
    Válasszon hívónként eltérő AI-ügynököt a telefonszám vagy egy webhookban megadott egyéni logika alapján.
  </Card>

  <Card title="Eszközintegrációk hozzáadása" icon="screwdriver-wrench" href="/hu/guides/build-tool-integration">
    Tegye lehetővé, hogy az ügynök a beszélgetés közben meghívja az API-jait.
  </Card>

  <Card title="call.complete webhookok fogadása" icon="bolt" href="/hu/webhooks/call-complete">
    Minden befejezett hívást továbbíthat CRM- vagy analitikai folyamatába.
  </Card>

  <Card title="AI-értékelés és problémajelentések" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Értékeljen automatikusan minden hívást, és irányítsa a megjelölteket felülvizsgálatra.
  </Card>
</CardGroup>