Open in
Savienošana no NICE CXone
Nosūtiet NICE CXone zvanus uz ThunderPhone balss aģentu no Studio skripta, izmantojot ContactID SIP galvenē, un sameklējiet aģenta pāradresēšanu, kad skripts turpinās.
Jūsu CXone Studio skripts veic zvanu balss aģentam ar SIP galvenēm, kurās ir kontakta ID un jebkāds cits konteksts. Kad balss aģents ir pabeidzis darbu, tas noliek klausuli, un REST API darbība skriptā iegūst nodošanas datus.
Pirms darba sākšanas
- ThunderPhone aģents un organizācijas API atslēga.
- CXone SIP maģistrāļu grupa, kas pieņem pielāgotas galvenes. Jūsu NICE konta pārstāvim šis iestatījums ir jāiespējo, pirms CXone tās nosūta.
1. Izveidojiet SIP galapunktu
Placecall zvana uz tālruņa numuru, izmantojot CXone maģistrāļu grupu, nevis uz SIP adresi.
NICE tam nedokumentē SIP akreditācijas datus, un cita MI nodrošinātāja CXone
integrācija izmanto TLS ar IP atļauju sarakstu. Tāpēc izveidojiet ip_allowlist
galapunktu ar numuru, uz kuru skripts zvanīs, kā ienākošo zvanu numuru (skatiet
Platformas, kas zvana uz tālruņa numuru):
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ūsu CXone klastera SIP signalizācijas diapazoni, ko nodrošina NICE. Katram jābūt publiskam IPv4 diapazonam/16vai šaurākam (IPv6/48vai šaurākam).dial_in_numbers: numurs, uz kuru Placecall zvanīs, rakstīts tā, kā to nosūta CXone. Tam nav jābūt reālam tālruņa numuram. To nedrīkst jau izmantot ThunderPhone kā tālruņa numuru vai citā galapunktā: pretējā gadījumā tiek atgriezts409.
CXone adreses ir koplietotas visiem tā klientiem, tāpēc jebkurš cits CXone klients, kas zvana uz šo numuru, sasniedz jūsu balss aģentu. Vietā, kur izvēlaties numuru, izvēlieties garu numuru, ko neviens neuzminētu (līdz 15 cipariem), pārliecinieties, ka CXone to nosūta uz ThunderPhone, nevis uz tālruņu tīklu, un nepublicējiet to.
2. Sūtiet zvanus ar kontekstu
Savā Studio skriptā pirms Placecall:
- Pievienojiet Sipputheader darbību ar galveni
X-Call-IDun vērtībuContactID. CXone nesūta savu zvana ID galveni; ThunderPhone šo galveni saglabā kā zvanaexternal_call_id. - Pievienojiet Sipputheader darbību katrai citai vērtībai, kas balss aģentam jāzina,
piemēram,
X-Skillar vērtībusupport. Tā sasniedz uzvedni kā{{sip_x_skill}}. Sipputheader pieņemUser-to-User, jebkuruX-galveni un lielāko daļuP-galveņu; NICE iesaka vērtības ar 256 vai mazāk rakstzīmēm.
Pēc tam veiciet Placecall uz šo numuru, izmantojot maģistrāļu grupu, kas to nosūta uz
sip.thunderphone.com ar numuru gan pieprasījuma URI, gan To
galvenē. Galapunkts pieņem TLS (ports 5061) vai TCP (ports 5060) un noraida
UDP, bet NICE nedokumentē maģistrāles transportu, tāpēc pārliecinieties, ka tas nav
UDP.
3. Saņemiet zvanu atpakaļ
CXone nolasa SIP galvenes tikai INVITE un tā gala atbildē, tāpēc
balss aģents atgriež zvanu: tas atvadās un noliek klausuli, un jūsu skripts atkal
pārņem zvanītāju. Pievienojiet šo pārsūtīšanas numuru (skatiet
Pievienojiet pārsūtīšanas numuru):
{"name": "NICE CXone", "action": "return"}NICE nedokumentē, ka skripts turpinās pēc Placecall, kad veiktais
zvans beidzas. Citu MI nodrošinātāju CXone integrācijas tā vietā signalizē skriptam,
izmantojot CXone Signal API (POST /interactions/{contactId}/signal), pirms
tās noliek klausuli; ThunderPhone to neizsauc. Apstipriniet ar NICE, kā jūsu skripts
atkal pārņem zvanītāju, pēc tam iegūstiet nodošanas datus ar REST API darbību:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=kam sekoContactID.- Galvene
Authorization: Bearer sk_live_…. - Nolasiet atbildes
handoff.summaryunhandoff.intent, lai maršrutētu kontaktu.
Skatiet Nodota zvana uzmeklēšana.
Pārbaudiet
Piezvaniet uz numuru, kurā darbojas skripts, palūdziet aģentam savienot ar personu un pārbaudiet, vai
skripts turpinās un REST API darbība atgriež pāradresāciju. Ja zvans
nekad nenonāk līdz aģentam, pārbaudiet numuru, ko CXone nosūta, vai tā avota adrese
ir allowed_source_cidrs un vai zvans tika veikts, izmantojot TCP vai TLS. Pēc tam atveriet
zvanu ar GET /v1/calls/{call_id}: sip_headers jānorāda x-call-id, un
external_call_id jābūt vienādam ar ContactID.
Ierobežojumi
- CXone nosūta un nolasa galvenes tikai
INVITEun tā galīgajā2xx, tāpēc nekas no aģentaBYEnenonāk līdz skriptam. - NICE nedokumentē
REFERpieņemšanu no aģenta. - REST API darbībai pēc noklusējuma iestājas taimauts pēc 10 sekundēm (ne vairāk kā 90 sekundēs) un tā nolasa atbildes līdz 32 KB.