Open in
Tvarkykite įeinančius skambučius (API)
Nuo pradžios iki pabaigos: sukonfigūruokite agentą, priskirkite jį telefono numeriui, priimkite skambutį ir peržiūrėkite transkriptą.
Standartinė „atsiliepti telefonu su DI“ eiga iš jūsų terminalo. Jūs:
- Sukursite agentą su raginimu ir balsu.
- Užsakysite (arba prijungsite turimą) telefono numerį ir priskirsite agentą kaip jo įeinančių skambučių tvarkytuvą.
- Paskambinsite numeriu. Peržiūrėsite skambučių žurnalą, nuorašą ir įrašą.
Iš viso API iškvietimų: keturi. Bendra trukmė: mažiau nei penkios minutės.
1. Sukurkite agentą
Agentas apjungia raginimą, balsą ir produkto pakopą, kuri valdys
skambutį. Agente taip pat galite nustatyti skambučio apribojimus, pvz., max_call_duration_seconds
ir ring_duration_seconds. Skambučiams į išorę taip pat galite nustatyti
max_hold_seconds, kad apribotumėte, kiek laiko agentas laukia sulaikytas prieš baigdamas
skambutį. Bolt agentai taip pat palaiko audio_tier, endpointing ir intelligence,
kad galėtumėte valdyti, kaip jie klausosi ir atsako: intelligence gali būti core arba pro,
o audio_tier (klausymui) gali būti lite, standard, plus arba max (Max nėra
plačiai prieinamas). Senesnės reikšmės (lite ir standard, skirtos
intelektui; lean, hearing ir deep_hearing, skirtos klausymui) vis dar
priimamos. Viso duplekso agentai išlaiko tą patį balsą visose palaikomose kalbose,
todėl tokiems skambučiams balso perjungimas pagal kalbą netaikomas. Agentai taip pat
palaiko intro_clip ir intro_ring_count, kad prieš agentui pradedant kalbėti būtų paleista
iš anksto įrašyta įžanga ir iki dviejų skambučių signalų. Naujiems agentams taip pat reikia
laiko juostos. Jei jūsų agentas yra daugiakalbis, galite nustatyti language_switching, kad valdytumėte,
ar jis prieš keisdamas kalbą paklausia, ar vadovaujasi skambinančiojo kalba.
Taip pat galite nustatyti agento words, kad valdytumėte, kaip jis taria konkrečius terminus
ir kurių terminų klausosi.
Visus konfigūracijos laukus rasite Agentai; mažiausia konfigūracija yra:
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"
}'Išsaugokite grąžintą id — jo reikės 2 veiksme.
2. Gaukite telefono numerį
Jei jums tiesiog reikia numerio, kuriuo galėtumėte skambinti, gaukite ThunderPhone numerį iš ThunderPhone numerių fondo:
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"}'Atsakyme pateikiami id ir number E.164 formatu. ThunderPhone
numeriai iš pradžių būna status="provisioning" būsenos ir per kelias
sekundes tampa active — jei tai jums svarbu, stebėkite būsenos pasikeitimą
apklausdami
GET /v1/phone-numbers/{id}.
3. Priskirkite agentą
Susiekite 1 veiksme sukurtą agentą su numerio įeinančių skambučių kryptimi:
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}'Viskas — numeris aktyvus. Kai jūsų organizacijai bus patvirtinti išeinantys skambučiai,
tame pačiame PATCH taip pat galėsite nustatyti outbound_agent_id. Iki tol
API atmes šį priskyrimą su 400.
Jei įeinančius skambučius nukreipiate per konfigūracijos žiniatinklio kablį, o ne per fiksuotą inbound_agent_id, šis žiniatinklio kablys dabar gali kiekvienam skambučiui grąžinti timezone kartu su agent_id ir variables. Naudojant Bolt agentus, atliekant API įrašymo užklausas agentui taip pat galite nustatyti audio_tier, endpointing ir intelligence. API vis dar priima senesnį pavadinimą eagerness kaip endpointing sinonimą. Jei jūsų agentas naudoja API jungtis su trigger="call_start", ThunderPhone gali paleisti šiuos įrankius vieną kartą kiekvieno telefono skambučio pradžioje, prieš pasisveikinimą, naudodama jų išsaugotus call_start_arguments.
Perskambinimai į jūsų išeinančius skambučius
Kai kas nors perskambina numeriu, kuris jiems skambino per pastarąsias 30
dienų, atsiliepiantis agentas gauna trumpą kontekstinę pastabą apie tą skambutį:
kada jis buvo atliktas, kurio agento ir kas įvyko (neatsiliepė,
balso paštas arba pokalbis). Numeris be įeinančių skambučių agento
siunčia tą pačią informaciją į jūsų konfigūracijos žiniatinklio kablį kaip returning_call. Jei tas
numeris neturi žiniatinklio kablio, žiniatinklio kablio laikas baigiasi arba jis nepasiekiamas,
skambutis nukreipiamas agentui, kuris atliko ankstesnį skambutį, užuot
buvo nutrauktas. Skambintojo ID gali būti suklastotas, todėl ankstesnio
skambučio suvestinė ir kintamieji bendrinami tik tada, jei administratorius įjungia Bendrinti ankstesnio skambučio informaciją skiltyje Organizacija → Bendrieji → Perskambinimai. Žr.
Perskambinimai.
4. Priimkite skambutį
Paskambinkite numeriu iš savo telefono. Agentas atsiliepia, prisistato pagal jūsų raginimą ir prasideda pokalbis.
Kol skambutis vyksta, jis rodomas
GET /v1/calls su
status="in_progress". Jam pasibaigus, įrašas atnaujinamas laukais
end_reason, duration_seconds, billable_minutes ir (vėliau)
įrašo URL bei DI įvertinimu.
Įeinantys skambučiai įskaičiuojami į jūsų organizacijos
vienu metu vykstančių skambučių limitą (pagal numatytuosius nustatymus – 20
vykstančių skambučių, bendras su išeinančiais, žiniatinklio ir bandomaisiais
skambučiais). Skambutis, pasiekęs limitą, atmetamas prieš agentui
atsiliepiant ir nutraukiamas, už jį neskaičiuojamas mokestis, o jis užregistruojamas kaip nepavykęs skambutis
su pabaigos priežastimi concurrent_call_limit_reached. Rašykite support@thunderphone.com, jei jums
reikia didesnio limito.
5. Peržiūrėkite rezultatus
Gaukite naujausių skambučių sąrašą:
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Gaukite transkripciją:
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Ir įrašo URL (trumpalaikis, pasirašytas):
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Jei užsiprenumeravote
telephony.complete žiniatinklio kablį,
tuos pačius duomenis gausite kaip POST užklausą į savo serverį — žr.
call.complete.
Jei jūsų agentui sukonfigūruoti duomenų išgavimo laukai, užbaigto skambučio duomenų pakete taip pat gali būti struktūrizuotų išgautų duomenų. Skambučių suvestinės rašomos jūsų organizacijos ThunderPhone naudojama kalba, nebent agentas nepaiso šio nustatymo.
Tolesni veiksmai
Parinkite skirtingą agentą kiekvienam skambinančiajam pagal telefono numerį arba pasirinktinę logiką žiniatinklio kablyje.
Leiskite agentui pokalbio metu kviesti jūsų API.
Nukreipkite skambinančiuosius tiesiogiai arba prieš sujungdami patikrinkite gavėją.
Siųskite kiekvieno užbaigto skambučio duomenis srautu į savo CRM / analizės procesą.
Automatiškai įvertinkite kiekvieną skambutį ir pažymėtus nukreipkite peržiūrai.