> ## 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.
# Kimenő hívások indítása (API)
> Indítson AI-vezérelt kimenő hívást saját kódjából – felmérési, utánkövetési vagy megerősítési folyamatokhoz.
A kimenő hívásokkal megadhat egy céltelefonszámot és egy ügynök-
konfigurációt a ThunderPhone számára, hogy az AI-ügynök az Ön nevében
kezdeményezze a hívást. Tipikus felhasználási esetek:
* Időpont-visszaigazolások
* Visszahívások felmérésekhez
* „Második próbálkozásos” utánkövetések nem fogadott hívás után
* Diszpécserjellegű értesítések
Teljes listát hív? A vezérlőpult
[**Kampányok**](/hu/guides/outbound-campaigns) funkciója
(`/dashboard/campaigns`) fogadja a kapcsolatok CSV-fájlját, és kezeli
az időzóna szerinti hívási időablakokat, a párhuzamosságot és az
újrapróbálási szabályzatot. Ez az útmutató az egyedi, programozott
hívásokat ismerteti.
## Előfeltételek
A kimenő hívásokhoz Önnek kell birtokolnia a `from_number` számot egy
[VoIP-kapcsolaton](/api-reference/voip-connections) keresztül. A demószámok
csak bejövő hívásokhoz használhatók. Lásd:
[Saját telefonszámok használata](/hu/guides/bring-your-own-numbers).
A kimenő hívásokhoz készült promptok általában azzal kezdődnek, hogy az
ügynök bemutatkozik és ismerteti a célját — „Üdvözlöm, az Acme-től
hívom, hogy megerősítsem a holnap délután 3 órára szóló időpontját…” Állítsa
az `outbound_speak_order` értékét `agent_first` értékre (ez az alapértelmezett).
A kimenő hívások `402 Payment Required` választ adnak vissza, ha az egyenleg ≤
`$0.00`. Töltsön fel egyenleget a következővel:
[`POST /v1/billing/top-up`](/api-reference/billing#top-up-balance),
vagy engedélyezze az [automatikus feltöltést](/api-reference/billing#update-auto-reload).
## Hívás indítása mentett ügynökkel
A legegyszerűbb megoldás — hivatkozzon egy ügynökre azonosító alapján:
```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+14155550199",
"agent_id": 12
}'
```
Válasz:
```json theme={null}
{ "call_id": 987654321, "status": "initiated" }
```
A `status: "initiated"` csak azt jelenti, hogy a kérés elfogadásra került — a hívás
**még nincs kapcsolva**. Kérdezze le rendszeresen a
[`GET /v1/calls/{call_id}`](/api-reference/calls#retrieve-a-call)
végpontot az aktuális állapotért (`in_progress` → `completed` / `failed`).
## Hívás indítása beágyazott konfigurációval
Ha egyszeri promptot szeretne használni, amelyet nem érdemes ügynökként
menteni, adja meg helyette a `config` értéket. A szerkezete megegyezik a
[`call.incoming` webhook](/hu/webhooks/call-incoming)
válaszsémájával:
```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+14155550199",
"config": {
"prompt": "You are confirming Jane Doe appointment for 3pm tomorrow…",
"voice": "john",
"product": "spark"
}
}'
```
## A hívás követése
Ezzel párhuzamosan iratkozzon fel a
[`telephony.complete` webhookra](/hu/webhooks/events) —
ez a leggyorsabb módja annak, hogy megtudja, mikor fejeződött be egy hívás.
Ha nem tud bejövő webhookokat fogadni, kérdezze le a `GET /v1/calls/{call_id}`
végpontot néhány másodpercenként; a rekord a hívás befejezése után tartalmazza
az `end_reason`, a `duration_seconds` és a felvétel URL-jét.
## Kezelendő hibamódok
| Hiba | Javítás |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `402 Payment Required` | Töltse fel az egyenleget, vagy engedélyezze az automatikus feltöltést |
| `403` kimenő hívások blokkolva (demószám) | Használjon inkább VoIP-számot |
| `403` kimenő hívások blokkolva (nem hitelesített VoIP) | Futtassa a következőt: [`POST /v1/phone-numbers/{id}/verify-voip`](/api-reference/phone-numbers#verify-a-voip-sourced-number) |
| `404 from_number is not registered to this organization` | Ellenőrizze, hogy a `from_number` az Ön tulajdonában lévő telefonszámnak felel meg |
| `502 Bad Gateway` | Átmeneti SIP- / LiveKit-hiba; biztonságosan újrapróbálható |
## Várakoztatási idő szabályozása
Az olyan kimenő hívások, amelyek elhúzódnak, mert a hívott fél lassan válaszol
(IVR-menük, várólisták), a `max_hold_seconds` értékkel korlátozhatók:
```json theme={null}
{
"from_number": "+15551234567",
"to_number": "+14155550199",
"agent_id": 12,
"max_hold_seconds": 120
}
```
Az ügynök bontja a hívást, ha az elmúlt N másodpercben nem érkezett emberi hang. Az alapértelmezett érték 900 (15 perc).
***
## Következő lépések
Minden kérésmező és hibakód.
Továbbítsa a befejezett kimenő hívásokat a rendszerébe.
Automatikus feltöltés, hogy a kimenő hívások soha ne hiúsuljanak meg az egyenleg miatt.
Élesítés előtt futtasson próbahívást a kimenő ügynökével.