Open in
Obrada dolaznih poziva (API)
Cjeloviti postupak: konfigurirajte agenta, dodijelite ga telefonskom broju, primite poziv i pregledajte transkript.
Standardni postupak „odgovaranja na telefon pomoću umjetne inteligencije” iz Vašeg terminala. Vi ćete:
- Izraditi agenta s upitom i glasom.
- Dodijeliti (ili prenijeti) telefonski broj i postaviti agenta kao njegov upravitelj dolaznih poziva.
- Nazvati broj. Pregledati zapis poziva, transkript i snimku.
Ukupno API poziva: četiri. Ukupno vrijeme: manje od pet minuta.
1. Izradite agenta
Glasovni agent objedinjuje uputu, glas i razinu proizvoda za vođenje
poziva. Za glasovnog agenta možete postaviti i ograničenja poziva, kao što su max_call_duration_seconds
i ring_duration_seconds. Za odlazne pozive možete postaviti i
max_hold_seconds kako biste ograničili koliko dugo glasovni agent čeka na čekanju prije prekida
poziva. Bolt glasovni agenti podržavaju i audio_tier, endpointing i intelligence
za upravljanje načinom na koji slušaju i odgovaraju: intelligence je core ili pro,
a audio_tier (Hearing) je lite, standard, plus ili max (Max općenito nije
dostupan). Starije vrijednosti (lite i standard za
intelligence; lean, hearing i deep_hearing za hearing) i dalje su
prihvaćene. Agenti s punim dupleksom zadržavaju isti glas u svim podržanim jezicima,
pa se promjena glasa po jeziku ne primjenjuje na te pozive. Agenti također
podržavaju intro_clip i intro_ring_count za reprodukciju unaprijed snimljene uvodne poruke i
do dva zvonjenja prije nego što agent progovori. Novi agenti trebaju i vremensku zonu. Ako je
Vaš agent višejezičan, možete postaviti language_switching kako biste odredili
hoće li pitati prije promjene jezika ili slijediti jezik pozivatelja.
Na agentu možete postaviti i words kako biste upravljali načinom na koji izgovara određene pojmove
i koje pojmove prepoznaje.
Pogledajte Agenti za svako konfiguracijsko polje;
najmanje je potrebno:
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"
}'Spremite vraćeni id — trebat će Vam u koraku 2.
2. Nabavite telefonski broj
Ako Vam je potreban samo broj koji možete nazvati, nabavite ThunderPhone broj iz ThunderPhoneova skupa brojeva:
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 uključuje id i number u formatu E.164. ThunderPhone
brojevi počinju sa status="provisioning" i postaju active unutar nekoliko
sekundi — po potrebi provjeravajte
GET /v1/phone-numbers/{id}
kako biste pratili prijelaz.
3. Dodijelite agenta
Povežite agenta iz koraka 1 s dolaznim smjerom broja:
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 sve — broj je aktivan. Nakon što se za Vašu
organizaciju odobre odlazni pozivi, u istom PATCH zahtjevu možete postaviti i outbound_agent_id. Do
tada API odbija tu dodjelu s 400.
Ako dolazne pozive usmjeravate putem konfiguracijskog webhooka umjesto fiksnog inbound_agent_id, taj webhook sada može vratiti timezone za svaki poziv zajedno s agent_id i variables. Za Bolt agente možete također postaviti audio_tier, endpointing i intelligence na agentu pri API zapisima. API i dalje prihvaća stariji naziv eagerness kao alias za endpointing. Ako vaš agent koristi API veze s trigger="call_start", ThunderPhone može pokrenuti te alate jednom na početku svakog telefonskog poziva, prije pozdrava, koristeći njihove spremljene call_start_arguments.
Povratni pozivi na vaše odlazne pozive
Kada netko uzvrati poziv na broj koji ga je nazvao u posljednjih 30
dana, agent koji odgovara dobiva kratku kontekstualnu bilješku o tom pozivu:
kada je upućen, koji ga je agent uputio i što se dogodilo (nema odgovora,
govorna pošta ili razgovor). Broj bez agenta za dolazne pozive šalje
iste pojedinosti vašem konfiguracijskom webhooku kao returning_call. Ako taj
broj nema webhook ili webhook istekne ili nije dostupan,
poziv se umjesto prekida preusmjerava agentu koji je uputio raniji poziv.
ID pozivatelja može se krivotvoriti, stoga se sažetak i varijable ranijeg
poziva dijele samo ako administrator uključi Dijelite pojedinosti ranijeg
poziva u odjeljku Organizacija → Općenito → Povratni pozivi. Pogledajte
Povratni pozivi.
4. Primite poziv
Nazovite broj sa svojeg telefona. Agent se javlja, predstavlja se u skladu s Vašim upitom i razgovor započinje.
Dok je poziv u tijeku, prikazuje se u
GET /v1/calls sa statusom
status="in_progress". Kada završi, zapis se ažurira s vrijednostima
end_reason, duration_seconds, billable_minutes i (naknadno)
URL-om snimke te ocjenom umjetne inteligencije.
Dolazni pozivi uračunavaju se u ograničenje vaše organizacije za
istodobne pozive (prema zadanim postavkama 20
poziva u tijeku, dijeljeno s odlaznim, web i testnim
pozivima). Poziv koji stigne nakon dosegnutog ograničenja odbija se prije nego što se agent
javi i prekida se, ne naplaćuje se te se bilježi kao neuspjeli poziv
s razlogom završetka concurrent_call_limit_reached. Pošaljite e-poruku na support@thunderphone.com ako vam je
potrebno veće ograničenje.
5. Pregledajte rezultate
Dohvatite popis nedavnih poziva:
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Dohvatite transkript:
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"I URL snimke (kratkotrajan, potpisan):
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Ako ste se pretplatili na
telephony.complete webhook,
primit ćete iste podatke kao POST zahtjev na svoj poslužitelj — pogledajte
call.complete.
Ako Vaš agent ima konfigurirana polja za ekstrakciju, podaci dovršenog poziva mogu sadržavati i strukturirane ekstrahirane podatke. Sažeci poziva pišu se na jeziku koji Vaša organizacija koristi u ThunderPhoneu, osim ako agent ne nadjača tu postavku.
Sljedeći koraci
Odaberite drugog agenta za svakog pozivatelja na temelju telefonskog broja ili prilagođene logike u webhooku.
Omogućite agentu da tijekom razgovora poziva vaše API-je.
Izravno usmjerite pozivatelje ili provjerite odredište prije nego što ih povežete.
Prenosite svaki dovršeni poziv u svoj CRM / analitički kanal.
Automatski ocijenite svaki poziv i označene usmjerite na pregled.