---
title: "Gyorsindítás (API)"
description: "Fogadja első telefonhívását egy AI-ügynökkel: szerezzen API-kulcsot, hozzon létre egy ügynököt, igényeljen telefonszámot, és indítson élő teszthívást — mindezt a REST API-n keresztül."
---
Ez az útmutató végigvezeti Önt azon a négy REST-híváson, amelyekkel
megválaszolhatja első telefonhívását egy AI-ügynökkel.
Szüksége lesz egy [ThunderPhone-fiókra](https://app.thunderphone.com).
A regisztráció ingyenes, és kevesebb mint egy percet vesz igénybe. Inkább kattintana, mint curl parancsot használna?
A [dashboard gyorsindítója](/hu/quickstart-dashboard) ugyanahhoz az
első híváshoz vezet kódírás nélkül.
## 1. lépés: API-kulcs beszerzése
Nyissa meg az [app.thunderphone.com](https://app.thunderphone.com) oldalt.
A dashboardon lépjen a **Szervezet → Kulcsok** menüponthoz.
Kattintson a **Kulcs létrehozása** lehetőségre, adjon neki nevet, majd másolja ki a
`sk_live_...` értéket. A nyers kulcs **csak egyszer** jelenik meg — azonnal tárolja
a titokkezelőjében.
Elakadt? A [szerveroldali API-kulcs létrehozása](/hu/guides/api-keys)
lépésről lépésre bemutatja ezt a folyamatot, és az alkalmazáson belüli másodpilóta
élőben kiemelheti Önnek az egyes vezérlőket.
Az útmutató során cserélje le a `sk_live_YOUR_API_KEY` értéket az imént
kimásolt értékre. A kulcs automatikusan azonosítja a szervezetét, így
soha nem kell szervezeti azonosítót megadnia az URL-ekben.
## 2. lépés: Ügynök létrehozása
Az ügynök határozza meg, hogyan kezeli az AI a beszélgetéseket — prompt, hang,
termékszint, eszközök és widgetjogosultság.
```bash cURL
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Customer Support",
"prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
"voice": "john",
"product": "spark"
}'
```
```python Python
import os, requests
agent = requests.post(
"https://api.thunderphone.com/v1/agents",
headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
json={
"name": "Customer Support",
"prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
"voice": "john",
"product": "spark",
},
).json()
print("Agent id:", agent["id"])
```
```javascript Node.js
const agent = await fetch("https://api.thunderphone.com/v1/agents", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Customer Support",
prompt: "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
voice: "john",
product: "spark",
}),
}).then((r) => r.json());
console.log("Agent id:", agent.id);
```
Termékszintek: a `spark` a költségekre, a `bolt` a sebességre van optimalizálva, a
`storm-base` / `storm-extra` pedig az összetett promptok intelligens kezelésére. A teljes
összehasonlításért tekintse meg az [Ügynökök](/api-reference/agents#product-tiers-at-a-glance)
oldalt.
## 3. lépés: Telefonszám biztosítása
Ez a hívás telefonszámot kér a ThunderPhone-tól, és az új
ügynökét állítja be a bejövő hívások kezelőjeként. (Ha saját számot szeretne
átvinni egy VoIP-szolgáltatótól, tekintse meg inkább a [VoIP-kapcsolatokat](/api-reference/voip-connections).)
```bash cURL
# First provision
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"}'
# Then assign the agent you created in Step 2
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/ \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'
```
```python Python
number = requests.post(
"https://api.thunderphone.com/v1/phone-numbers",
headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
json={"area_code": "415"},
).json()
requests.patch(
f"https://api.thunderphone.com/v1/phone-numbers/{number['id']}",
headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
json={"inbound_agent_id": agent["id"]},
)
print("Your ThunderPhone number:", number["number"])
```
Az új száma kezdetben `status="provisioning"` állapotban van, majd néhány
másodpercen belül `active` állapotba vált; mire bezárja a böngészőjét, a szám
készen áll a hívások fogadására.
## 4. lépés (opcionális): Webhook beállítása
Valós idejű eseményekhez (dinamikus hívásátirányítás, hívás utáni feldolgozás)
adjon hozzá egy webhookvégpontot. Csak azokra az eseményekre iratkozzon fel,
amelyekre szüksége van.
```bash
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"label": "Prod webhook",
"url": "https://your-server.com/thunderphone-webhook",
"events": ["telephony.incoming", "telephony.complete"]
}'
```
A válasz egy egyszer megjelenő `secret` értéket tartalmaz — másolja be a titokkezelőjébe. Ezzel a titokkal ellenőrizze a bejövő kérések `X-ThunderPhone-Signature-V2` fejlécét (lásd:
[Webhookok áttekintése](/hu/webhooks/overview)).
## 5. lépés: Az ügynök tesztelése
Hívja fel az imént biztosított számot. Az ügynök felveszi a hívást, bemutatkozik,
és követi az utasítását.
A hívás befejezése után tekintse meg annak részleteit:
```bash
curl https://api.thunderphone.com/v1/calls \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Egy adott hívás részleteiben kérje le az átiratot és a felvétel URL-jét:
```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
---
## Következő lépések
Tegye lehetővé, hogy ügynöke egy beszélgetés során meghívja az API-jait.
Indítson hívásokat saját kódból.
Reagáljon valós időben a hívási eseményekre.
Minden nyilvános végpont dokumentációja.