Obravnava dohodnih klicev (API)

Od začetka do konca: konfigurirajte agenta, ga dodelite telefonski številki, sprejmite klic in preglejte prepis.

Standardni potek »odgovorite na telefon z AI« iz terminala. Izvedli boste:

1. Ustvarili agenta s pozivom in glasom.
2. Zagotovili (ali dodali lastno) telefonsko številko ter agenta dodelili kot obravnavalca dohodnih klicev.
3. Poklicali številko. Pregledali dnevnik klicev, prepis in posnetek.

Skupno število klicev API: štirje. Skupni čas: manj kot pet minut.

1. Ustvarite agenta#

Agent združuje poziv, glas in raven izdelka, ki bodo vodili klic. Za vsa konfiguracijska polja glejte Agenti; najmanj potrebujete:

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, pridobite številko ThunderPhone iz nabora 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. Številke ThunderPhone 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 zahtevku PATCH lahko nastavite tudi outbound_agent_id, da bo številka pripravljena tudi za odhodne klice.

4. Sprejmite klic#

S telefona pokličite številko. Agent se oglasi, se predstavi skladno z vašim pozivom in pogovor se začne.

Med potekom klica je prikazan 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) URL-jem posnetka ter oceno AI.

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 (kratkotrajno veljaven, podpisan):

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

Če ste naročeni na spletni kavelj telephony.complete, boste iste podatke prejeli kot POST na svoj strežnik — glejte call.complete.

Naslednji koraki#