Obravnava dohodnih klicev (API)

Standardni potek »odgovarjanja na telefon z UI« iz vašega terminala. Izvedli boste:

1. Ustvarite agenta s pozivom in glasom.
2. Zagotovite (ali prinesite) telefonsko številko in agenta dodelite kot njenega upravljavca dohodnih klicev.
3. Pokličite številko. Oglejte si dnevnik klicev, prepis in posnetek.

Skupno število klicev API-ja: štiri. Skupni čas: manj kot pet minut.

1. Ustvarite agenta

Agent združuje poziv, glas in produktni paket, ki bodo vodili klic. Za vsa konfiguracijska polja glejte Agenti; najmanj potrebno je:

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

Shranite vrnjeni id — potrebovali ga boste v 2. koraku.

2. Pridobite telefonsko številko

Če potrebujete le številko za klicanje, zagotovite predstavitveno številko iz skupine ThunderPhone:

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

Odgovor vključuje id in number v obliki E.164. Predstavitvene številke se začnejo s status="provisioning" in v nekaj sekundah postanejo active — če želite spremljati prehod, preverjajte GET /v1/phone-numbers/{id}.

3. Dodelite agenta

Agenta iz 1. koraka povežite z dohodno smerjo številke:

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 vse — številka je aktivna. V istem PATCH-u lahko nastavite tudi outbound_agent_id, da bo številka pripravljena tudi za odhodne klice.

4. Sprejmite klic

Pokličite številko s svojim telefonom. Agent odgovori, se predstavi v skladu z vašim pozivom in pogovor se začne.

Med potekom klica se ta prikaže v GET /v1/calls s status="in_progress". Ko se konča, se zapis posodobi z end_reason, duration_seconds, billable_minutes in (sčasoma) z URL-jem posnetka ter oceno UI.

5. Preglejte rezultate

Pridobite seznam nedavnih klicev:

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

Pridobite prepis:

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

In URL posnetka (kratkotrajni, podpisan):

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

Če ste se naročili na telephony.complete webhook, boste iste podatke prejeli kot POST na svoj strežnik — glejte call.complete.

Naslednji koraki