Open in
Prisijungimas iš NICE CXone
Nukreipkite NICE CXone skambučius į ThunderPhone agentą iš Studio scenarijaus, perduodami ContactID SIP antraštėje, ir suraskite agento perduotą skambutį, kai scenarijus tęsiamas.
Jūsų CXone Studio scenarijus skambina agentui su SIP antraštėmis, kuriose perduodamas kontakto ID ir kitas kontekstas. Kai agentas baigia, jis padeda ragelį, o scenarijuje esantis REST API veiksmas gauna perdavimą.
Prieš pradėdami
- ThunderPhone agentas ir organizacijos API raktas.
- CXone SIP magistralės grupė, priimanti pasirinktines antraštes. Jūsų NICE paskyros atstovas turi įjungti šį nustatymą, kad CXone jas siųstų.
1. Sukurkite SIP galinį tašką
Placecall skambina telefono numeriu per CXone magistralės grupę, o ne SIP adresu.
NICE nepateikia jo SIP prisijungimo duomenų dokumentacijos, o kito DI tiekėjo CXone
integracija naudoja TLS su IP leidžiamųjų sąrašu. Todėl sukurkite ip_allowlist
galinį tašką, nurodydami numerį, kuriuo scenarijus skambins, kaip įeinančio skambučio numerį (žr.
Platformos, kurios skambina telefono numeriu):
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 12,
"name": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: jūsų CXone sankaupos SIP signalizavimo diapazonai, pateikti NICE. Kiekvienas turi būti viešasis/16arba siauresnis IPv4 diapazonas (IPv6/48arba siauresnis).dial_in_numbers: numeris, kuriuo skambins Placecall, užrašytas taip, kaip jį siunčia CXone. Jis nebūtinai turi būti tikras telefono numeris. Jis negali būti jau naudojamas ThunderPhone kaip telefono numeris arba kitame galiniame taške: tokiu atveju grąžinamas409.
CXone adresais dalijasi visi jo klientai, todėl bet kuris kitas CXone klientas, paskambinęs šiuo numeriu, pasieks jūsų agentą. Rinkdamiesi numerį, pasirinkite ilgą numerį, kurio niekas neatspėtų (iki 15 skaitmenų), įsitikinkite, kad CXone siunčia jį į ThunderPhone, o ne į telefono tinklą, ir jo neskelbkite.
2. Siųskite skambučius su kontekstu
Savo Studio scenarijuje prieš Placecall:
- Pridėkite Sipputheader veiksmą su antrašte
X-Call-IDir reikšmeContactID. CXone nesiunčia savo skambučio ID antraštės; ThunderPhone saugo šią reikšmę kaip skambučioexternal_call_id. - Pridėkite Sipputheader veiksmą kiekvienai kitai reikšmei, kurią agentas turi
žinoti, pavyzdžiui,
X-Skill, kurios reikšmė yrasupport. Ji pasiekia raginimą kaip{{sip_x_skill}}. Sipputheader priimaUser-to-User, bet kuriąX-antraštę ir daugumąP-antraščių; NICE rekomenduoja ne ilgesnes nei 256 simbolių reikšmes.
Tada atlikite Placecall į šį numerį per magistralės grupę, kuri jį siunčia į
sip.thunderphone.com, nurodydama numerį ir užklausos URI, ir To
antraštėje. Galinis taškas priima TLS (5061 prievadas) arba TCP (5060 prievadas) ir atmeta
UDP, o NICE nepateikia magistralės perdavimo protokolo dokumentacijos, todėl įsitikinkite,
kad tai nėra UDP.
3. Perimkite skambutį atgal
CXone nuskaito SIP antraštes tik iš INVITE ir jo galutinio atsako, todėl
agentas grąžina skambutį: jis atsisveikina ir padeda ragelį, o jūsų scenarijus vėl
perima skambintoją. Pridėkite šį perdavimo numerį (žr.
Pridėkite perdavimo numerį):
{"name": "NICE CXone", "action": "return"}NICE nepateikia dokumentacijos, kad scenarijus tęsiamas po Placecall, kai inicijuotas
skambutis baigiasi. Kitų DI tiekėjų CXone integracijos prieš padėdamos ragelį
vietoje to signalizuoja scenarijui per CXone Signal API (POST /interactions/{contactId}/signal);
ThunderPhone jo nekviečia. Su NICE patvirtinkite, kaip jūsų scenarijus vėl perima
skambintoją, tada gaukite perdavimą naudodami REST API veiksmą:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ir po joContactID.- Antraštė
Authorization: Bearer sk_live_…. - Perskaitykite atsako
handoff.summaryirhandoff.intent, kad nukreiptumėte kontaktą.
Žr. Perduoto skambučio paieška.
Išbandykite
Paskambinkite numeriu, kuriame vykdomas scenarijus, paprašykite agento sujungti su asmeniu ir patikrinkite, ar
scenarijus tęsiamas ir REST API veiksmas grąžina perdavimą. Jei skambutis
niekada nepasiekia agento, patikrinkite CXone siunčiamą numerį, ar jo šaltinio adresas
yra allowed_source_cidrs, ir ar skambutis atėjo per TCP arba TLS. Tada atidarykite
skambutį naudodami GET /v1/calls/{call_id}: sip_headers turėtų nurodyti x-call-id, o
external_call_id turėtų sutapti su ContactID.
Ribojimai
- CXone siunčia ir nuskaito antraštes tik
INVITEir jo galutiniame2xx, todėl niekas iš agentoBYEnepasiekia scenarijaus. - NICE nedokumentuoja, kad priima agento siunčiamą
REFER. - REST API veiksmo numatytasis laiko limitas yra 10 sekundžių (daugiausia iki 90) ir jis nuskaito atsakymus iki 32 KB.