Open in
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:
- Ustvarili glasovnega agenta s pozivom in glasom.
- Zagotovili (ali prenesli) telefonsko številko in agenta dodelili kot obravnavalca dohodnih klicev.
- 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
Izberite drugega agenta za vsakega klicatelja glede na telefonsko številko ali logiko po meri v webhooku.
Agentu omogočite klicanje svojih API-jev med pogovorom.
Klicatelje usmerite neposredno ali pred povezavo preverite cilj.
Vsak zaključen klic pretakajte v svoj CRM / analitični proces.
Samodejno ocenite vsak klic in označene pošljite v pregled.