Developer cookbook

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.

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 oldalon; a minimum:

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

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:

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} végpontot az átmenet követéséhez.

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:

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 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:

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

Kérje le az átiratot:

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):

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

Ha feliratkozott a telephony.complete webhookra, ugyanezeket az adatokat POST kérésként kapja meg a szerverén — lásd: call.complete.

Következő lépések#