ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Contact centers

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 /16 arba siauresnis IPv4 diapazonas (IPv6 /48 arba 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ąžinamas 409.

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:

  1. Pridėkite Sipputheader veiksmą su antrašte X-Call-ID ir reikšme ContactID. CXone nesiunčia savo skambučio ID antraštės; ThunderPhone saugo šią reikšmę kaip skambučio external_call_id.
  2. Pridėkite Sipputheader veiksmą kiekvienai kitai reikšmei, kurią agentas turi žinoti, pavyzdžiui, X-Skill, kurios reikšmė yra support. Ji pasiekia raginimą kaip {{sip_x_skill}}. Sipputheader priima User-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 jo ContactID.
  • Antraštė Authorization: Bearer sk_live_….
  • Perskaitykite atsako handoff.summary ir handoff.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 INVITE ir jo galutiniame 2xx, todėl niekas iš agento BYE nepasiekia 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.