ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Developer cookbook

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. Pri agentu lahko nastavite tudi omejitve klica, kot sta max_call_duration_seconds in ring_duration_seconds. Za odhodne klice lahko nastavite tudi max_hold_seconds, da omejite, kako dolgo agent čaka na čakanju, preden konča klic. Agenti Bolt podpirajo tudi audio_tier, endpointing in intelligence za nadzor načina poslušanja in odgovarjanja: intelligence je core ali pro, audio_tier (Hearing) pa je lite, standard, plus ali max (Max na splošno ni na voljo). Starejše vrednosti (lite in standard za intelligence; lean, hearing in deep_hearing za poslušanje) so še vedno sprejete. Agenti s polnim dupleksom ohranijo isti glas v podprtih jezikih, zato preklapljanje glasu po posameznih jezikih pri teh klicih ne velja. Agenti podpirajo tudi intro_clip in intro_ring_count za predvajanje vnaprej posnetega uvoda in do dveh zvonjenj, preden agent spregovori. Novi agenti potrebujejo tudi časovni pas. Če je vaš agent večjezičen, lahko nastavite language_switching za nadzor, ali pred preklopom jezikov vpraša ali sledi jeziku klicatelja. Pri agentu lahko nastavite tudi words za nadzor načina izgovarjanja določenih izrazov in izrazov, ki jih posluša. 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": "bolt"
  }'

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 spletnega kljuka namesto prek fiksnega inbound_agent_id, lahko ta spletni kljuk zdaj za vsak klic vrne timezone skupaj z agent_id in variables. Za agente Bolt lahko pri zapisovanju prek API-ja na agentu nastavite tudi audio_tier, endpointing in intelligence. API še vedno sprejema starejše ime eagerness kot vzdevek za endpointing. Če vaš agent uporablja povezave API s trigger="call_start", lahko ThunderPhone ta orodja zažene enkrat ob začetku vsakega telefonskega klica, pred pozdravom, z njihovimi shranjenimi call_start_arguments.

Povratni klici na vaše odhodne klice

Ko nekdo pokliče nazaj številko, ki ga je poklicala v zadnjih 30 dneh, agent, ki sprejme klic, prejme kratko opombo o tem klicu: kdaj je bil opravljen, kateri agent ga je opravil in kaj se je zgodilo (brez odgovora, glasovna pošta ali pogovor). Številka brez agenta za dohodne klice pošlje iste podrobnosti v vaš konfiguracijski webhook kot returning_call. Če ta številka nima webhooka ali če webhook poteče ali ni dosegljiv, je klic namesto prekinitve usmerjen k agentu, ki je opravil prejšnji klic. Identiteto klicatelja je mogoče ponarediti, zato se povzetek in spremenljivke prejšnjega klica delijo le, če skrbnik v Organization → General → Callbacks vklopi Delite podrobnosti prejšnjega klica. Glejte Callbacks.

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š glasovni agent konfigurirana polja za ekstrakcijo, lahko koristni tovor dokončanega klica vključuje tudi strukturirane ekstrahirane podatke. Povzetki klicev so zapisani v jeziku, ki ga vaša organizacija uporablja v ThunderPhone, razen če glasovni agent preglasi to nastavitev.


Naslednji koraki