Obravnava dohodnih klicev (API)

Celoten postopek: konfigurirajte agenta, ga dodelite telefonski številki, sprejmite klic in preglejte prepis.

Kanonični potek »odgovorite na telefon z umetno inteligenco« iz terminala. Storili boste naslednje:

1. Ustvarili glasovnega agenta s pozivom in glasom.
2. Zagotovili (ali prenesli) telefonsko številko in agenta dodelili kot obravnavalca dohodnih klicev.
3. Poklicali številko. Preglejte dnevnik klicev, prepis in posnetek.

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

1. Ustvarite agenta#

Agent združuje poziv, glas in produktni nivo, ki bodo vodili klic. Za agenta lahko nastavite tudi omejitve klicev, kot sta max_call_duration_seconds in ring_duration_seconds. Novi agenti potrebujejo tudi časovni pas. 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, 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. Ko so za vašo organizacijo odobreni odhodni klici, lahko v istem PATCH nastavite tudi outbound_agent_id. Do takrat API to dodelitev zavrne s kodo 400.

Če dohodne klice usmerjate prek konfiguracijskega webhooka namesto fiksnega inbound_agent_id, lahko ta webhook zdaj za vsak klic vrne timezone skupaj z agent_id in variables.

4. Sprejmite klic#

Pokličite številko s svojega telefona. Agent se oglasi, se predstavi v skladu 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 s polji end_reason, duration_seconds, billable_minutes in (sčasoma) URL-jem posnetka ter oceno AI.

Dohodni klici se vštevajo v omejitev vaše organizacije za hkratne klice (privzeto 20 klicev v teku, skupno z odhodnimi, spletnimi in preskusnimi klici). Klic, ki prispe ob doseženi omejitvi, je zavrnjen, preden glasovni agent odgovori, in prekinjen, ni zaračunan ter je zabeležen kot neuspešen klic z razlogom konca concurrent_call_limit_reached. Če potrebujete višjo omejitev, pišite na support@thunderphone.com.

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

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

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

Če ima vaš agent konfigurirana polja za ekstrakcijo, lahko koristni tovor zaključenega klica vključuje tudi strukturirane ekstrahirane podatke.

Naslednji koraki#