Open in
NICE CXone ನಿಂದ ಸಂಪರ್ಕಿಸಿ
Studio ಸ್ಕ್ರಿಪ್ಟ್ನಿಂದ SIP ಹೆಡರ್ನಲ್ಲಿರುವ ContactID ಜೊತೆಗೆ NICE CXone ಕರೆಗಳನ್ನು ThunderPhone ಏಜೆಂಟ್ಗೆ ಕಳುಹಿಸಿ, ಮತ್ತು ಸ್ಕ್ರಿಪ್ಟ್ ಮುಂದುವರಿದಾಗ ಏಜೆಂಟ್ನ ಹ್ಯಾಂಡ್-ಆಫ್ ಅನ್ನು ಹುಡುಕಿ.
ನಿಮ್ಮ CXone Studio ಸ್ಕ್ರಿಪ್ಟ್, ಸಂಪರ್ಕ ಐಡಿ ಮತ್ತು ಇತರ ಯಾವುದೇ ಸಂದರ್ಭವನ್ನು ಹೊಂದಿರುವ SIP ಹೆಡರ್ಗಳೊಂದಿಗೆ ಏಜೆಂಟ್ಗೆ ಕರೆ ಮಾಡುತ್ತದೆ. ಏಜೆಂಟ್ ಕಾರ್ಯ ಮುಗಿಸಿದಾಗ, ಅದು ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ ಮತ್ತು ಸ್ಕ್ರಿಪ್ಟ್ನಲ್ಲಿರುವ REST API ಕ್ರಿಯೆಯು ಹಸ್ತಾಂತರವನ್ನು ಪಡೆಯುತ್ತದೆ.
ಪ್ರಾರಂಭಿಸುವ ಮೊದಲು
- ThunderPhone ಏಜೆಂಟ್ ಮತ್ತು ಸಂಸ್ಥೆಯ API ಕೀ.
- ಕಸ್ಟಮ್ ಹೆಡರ್ಗಳನ್ನು ಸ್ವೀಕರಿಸುವ CXone SIP ಟ್ರಂಕ್ ಗುಂಪು. CXone ಅವುಗಳನ್ನು ಕಳುಹಿಸುವ ಮೊದಲು ನಿಮ್ಮ NICE ಖಾತೆ ಪ್ರತಿನಿಧಿಯು ಈ ಸೆಟ್ಟಿಂಗ್ ಅನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಬೇಕು.
1. SIP ಎಂಡ್ಪಾಯಿಂಟ್ ರಚಿಸಿ
Placecall, SIP ವಿಳಾಸಕ್ಕಲ್ಲದೆ CXone ಟ್ರಂಕ್ ಗುಂಪಿನ ಮೂಲಕ ಫೋನ್ ಸಂಖ್ಯೆಗೆ ಡಯಲ್ ಮಾಡುತ್ತದೆ.
NICE ಇದಕ್ಕಾಗಿ SIP ರುಜುವಾತುಗಳನ್ನು ದಾಖಲಿಸುವುದಿಲ್ಲ, ಮತ್ತು ಮತ್ತೊಂದು AI ಪೂರೈಕೆದಾರರ CXone
ಏಕೀಕರಣವು IP ಅನುಮತಿಪಟ್ಟಿಯೊಂದಿಗೆ TLS ಬಳಸುತ್ತದೆ. ಆದ್ದರಿಂದ ಸ್ಕ್ರಿಪ್ಟ್ ಡಯಲ್ ಮಾಡುವ ಸಂಖ್ಯೆಯನ್ನು ಡಯಲ್-ಇನ್ ಸಂಖ್ಯೆಯಾಗಿ ಬಳಸಿ ip_allowlist
ಎಂಡ್ಪಾಯಿಂಟ್ ರಚಿಸಿ (ಫೋನ್ ಸಂಖ್ಯೆಗೆ ಡಯಲ್ ಮಾಡುವ ಪ್ಲಾಟ್ಫಾರ್ಮ್ಗಳು ನೋಡಿ):
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: NICE ಯಿಂದ ಪಡೆದಿರುವ ನಿಮ್ಮ CXone ಕ್ಲಸ್ಟರ್ನ SIP ಸಿಗ್ನಲಿಂಗ್ ಶ್ರೇಣಿಗಳು. ಪ್ರತಿಯೊಂದೂ/16ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಿರಿದಾದ ಸಾರ್ವಜನಿಕ IPv4 ಶ್ರೇಣಿಯಾಗಿರಬೇಕು (IPv6 ಗೆ/48ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಿರಿದು).dial_in_numbers: Placecall ಡಯಲ್ ಮಾಡುವ ಸಂಖ್ಯೆ, CXone ಅದನ್ನು ಕಳುಹಿಸುವ ಸ್ವರೂಪದಲ್ಲಿರಬೇಕು. ಇದು ನೈಜ ಫೋನ್ ಸಂಖ್ಯೆಯಾಗಿರಬೇಕಿಲ್ಲ. ಇದು ThunderPhone ನಲ್ಲಿ ಫೋನ್ ಸಂಖ್ಯೆಯಾಗಿ ಅಥವಾ ಇನ್ನೊಂದು ಎಂಡ್ಪಾಯಿಂಟ್ನಲ್ಲಿ ಈಗಾಗಲೇ ಬಳಕೆಯಲ್ಲಿರಬಾರದು: ಹಾಗಿದ್ದರೆ409ಮರಳುತ್ತದೆ.
CXone ನ ವಿಳಾಸಗಳು ಅದರ ಎಲ್ಲ ಗ್ರಾಹಕರಿಂದ ಹಂಚಿಕೊಳ್ಳಲ್ಪಡುತ್ತವೆ, ಆದ್ದರಿಂದ ಸಂಖ್ಯೆಗೆ ಡಯಲ್ ಮಾಡುವ ಯಾವುದೇ ಇತರ CXone ಗ್ರಾಹಕರು ನಿಮ್ಮ ಏಜೆಂಟ್ ಅನ್ನು ತಲುಪುತ್ತಾರೆ. ನೀವು ಸಂಖ್ಯೆಯನ್ನು ಆಯ್ಕೆಮಾಡುವಲ್ಲಿ, ಯಾರೂ ಊಹಿಸದ ಉದ್ದದ ಸಂಖ್ಯೆಯನ್ನು ಆಯ್ಕೆಮಾಡಿ (ಗರಿಷ್ಠ 15 ಅಂಕಿಗಳು), CXone ಅದನ್ನು ಫೋನ್ ನೆಟ್ವರ್ಕ್ಗೆ ಹೊರಗೆ ಕಳುಹಿಸದೆ ThunderPhone ಗೆ ಕಳುಹಿಸುತ್ತಿದೆ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ, ಮತ್ತು ಅದನ್ನು ಪ್ರಕಟಿಸಬೇಡಿ.
2. ಸಂದರ್ಭದೊಂದಿಗೆ ಕರೆಗಳನ್ನು ಕಳುಹಿಸಿ
ನಿಮ್ಮ Studio ಸ್ಕ್ರಿಪ್ಟ್ನಲ್ಲಿ, Placecall ಗೆ ಮೊದಲು:
X-Call-IDಹೆಡರ್ ಮತ್ತುContactIDಮೌಲ್ಯದೊಂದಿಗೆ Sipputheader ಕ್ರಿಯೆಯನ್ನು ಸೇರಿಸಿ. CXone ತನ್ನದೇ ಆದ ಕಾಲ್-ಐಡಿ ಹೆಡರ್ ಕಳುಹಿಸುವುದಿಲ್ಲ; ThunderPhone ಇದನ್ನು ಕರೆಯexternal_call_idಆಗಿ ಸಂಗ್ರಹಿಸುತ್ತದೆ.- ಏಜೆಂಟ್ ತಿಳಿದುಕೊಳ್ಳಬೇಕಾದ ಪ್ರತಿಯೊಂದು ಇತರ ಮೌಲ್ಯಕ್ಕಾಗಿಯೂ Sipputheader ಕ್ರಿಯೆಯನ್ನು ಸೇರಿಸಿ, ಉದಾಹರಣೆಗೆ
supportಗೆ ಹೊಂದಿಸಲಾದX-Skill. ಇದು{{sip_x_skill}}ಆಗಿ prompt ಗೆ ತಲುಪುತ್ತದೆ. SipputheaderUser-to-User, ಯಾವುದೇX-ಹೆಡರ್ ಮತ್ತು ಬಹುತೇಕP-ಹೆಡರ್ಗಳನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ; NICE 256 ಅಕ್ಷರಗಳು ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಡಿಮೆ ಮೌಲ್ಯಗಳನ್ನು ಶಿಫಾರಸು ಮಾಡುತ್ತದೆ.
ನಂತರ, ಸಂಖ್ಯೆ ಮತ್ತು To
ಹೆಡರ್ ಎರಡರಲ್ಲಿಯೂ ಸಂಖ್ಯೆಯೊಂದಿಗೆ ಅದನ್ನು sip.thunderphone.com ಗೆ ಕಳುಹಿಸುವ ಟ್ರಂಕ್ ಗುಂಪಿನ ಮೂಲಕ ಆ ಸಂಖ್ಯೆಗೆ Placecall ಮಾಡಿ. ಎಂಡ್ಪಾಯಿಂಟ್ TLS (ಪೋರ್ಟ್ 5061) ಅಥವಾ TCP (ಪೋರ್ಟ್ 5060) ಸ್ವೀಕರಿಸುತ್ತದೆ ಮತ್ತು
UDP ನಿರಾಕರಿಸುತ್ತದೆ; NICE ಟ್ರಂಕ್ನ ಸಾರಿಗೆ ವಿಧಾನವನ್ನು ದಾಖಲಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಅದು
UDP ಅಲ್ಲ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ.
3. ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ
CXone SIP ಹೆಡರ್ಗಳನ್ನು INVITE ಮತ್ತು ಅದರ ಅಂತಿಮ ಪ್ರತಿಕ್ರಿಯೆಯಲ್ಲಿ ಮಾತ್ರ ಓದುತ್ತದೆ, ಆದ್ದರಿಂದ ಏಜೆಂಟ್ ಕರೆಯನ್ನು ಮರಳಿಸುತ್ತದೆ: ಅದು ವಿದಾಯ ಹೇಳಿ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ, ಮತ್ತು ನಿಮ್ಮ ಸ್ಕ್ರಿಪ್ಟ್ ಕರೆಗಾರನನ್ನು ಮತ್ತೆ ಸ್ವೀಕರಿಸುತ್ತದೆ. ಈ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ (ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ ನೋಡಿ):
{"name": "NICE CXone", "action": "return"}ಹೊಂದಿಸಲಾದ ಕರೆ ಮುಗಿದಾಗ Placecall ನಂತರ ಸ್ಕ್ರಿಪ್ಟ್ ಮುಂದುವರಿಯುತ್ತದೆ ಎಂದು NICE ದಾಖಲಿಸುವುದಿಲ್ಲ. ಇತರ AI ಪೂರೈಕೆದಾರರ CXone ಏಕೀಕರಣಗಳು, ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುವ ಮೊದಲು CXone ನ Signal API (POST /interactions/{contactId}/signal) ಮೂಲಕ ಸ್ಕ್ರಿಪ್ಟ್ಗೆ ಸಂಕೇತ ನೀಡುತ್ತವೆ; ThunderPhone ಅದನ್ನು ಕರೆಯುವುದಿಲ್ಲ. ನಿಮ್ಮ ಸ್ಕ್ರಿಪ್ಟ್ ಕರೆಗಾರನನ್ನು ಹೇಗೆ ಮರಳಿ ಪಡೆಯುತ್ತದೆ ಎಂಬುದನ್ನು NICE ಜೊತೆಗೆ ದೃಢೀಕರಿಸಿ, ನಂತರ REST API ಕ್ರಿಯೆಯೊಂದಿಗೆ ಹಸ್ತಾಂತರವನ್ನು ಪಡೆಯಿರಿ:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ನಂತರContactID.- ಹೆಡರ್
Authorization: Bearer sk_live_…. - ಸಂಪರ್ಕವನ್ನು ಮಾರ್ಗನಿರ್ದೇಶಿಸಲು ಪ್ರತಿಕ್ರಿಯೆಯಿಂದ
handoff.summaryಮತ್ತುhandoff.intentಓದಿ.
ಹಸ್ತಾಂತರಿಸಲಾದ ಕರೆಯನ್ನು ಹುಡುಕಿ ನೋಡಿ.
ಪರೀಕ್ಷಿಸಿ
ಸ್ಕ್ರಿಪ್ಟ್ ಅನ್ನು ಚಲಾಯಿಸುವ ಸಂಖ್ಯೆಗೆ ಕರೆ ಮಾಡಿ, ಏಜೆಂಟ್ಗೆ ಒಬ್ಬ ವ್ಯಕ್ತಿಯನ್ನು ಸಂಪರ್ಕಿಸಲು ಕೇಳಿ, ಮತ್ತು
ಸ್ಕ್ರಿಪ್ಟ್ ಮುಂದುವರಿಯುತ್ತದೆಯೇ ಹಾಗೂ REST API ಕ್ರಿಯೆಯು ಹ್ಯಾಂಡ್-ಆಫ್ ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆಯೇ ಎಂದು ಪರಿಶೀಲಿಸಿ. ಕರೆ
ಏಜೆಂಟ್ಗೆ ತಲುಪದಿದ್ದರೆ, CXone ಕಳುಹಿಸುವ ಸಂಖ್ಯೆಯನ್ನು, ಅದರ ಮೂಲ ವಿಳಾಸವು allowed_source_cidrs ನಲ್ಲಿ ಇದೆಯೇ ಎಂಬುದನ್ನು,
ಮತ್ತು ಕರೆ TCP ಅಥವಾ TLS ಮೂಲಕ ಬಂದಿದೆಯೇ ಎಂಬುದನ್ನು ಪರಿಶೀಲಿಸಿ. ನಂತರ
GET /v1/calls/{call_id} ಮೂಲಕ ಕರೆ ವಿವರಗಳನ್ನು ಪಡೆಯಿರಿ: sip_headers ನಲ್ಲಿ x-call-id ಪಟ್ಟಿ ಆಗಿರಬೇಕು, ಮತ್ತು
external_call_id ಎಂಬುದು ContactID ಗೆ ಸಮನಾಗಿರಬೇಕು.
ಮಿತಿಗಳು
- CXone ಹೆಡರ್ಗಳನ್ನು
INVITEಮತ್ತು ಅದರ ಅಂತಿಮ2xxನಲ್ಲಿ ಮಾತ್ರ ಕಳುಹಿಸುತ್ತದೆ ಮತ್ತು ಓದುತ್ತದೆ, ಆದ್ದರಿಂದ ಏಜೆಂಟ್ನBYEನಲ್ಲಿರುವ ಯಾವುದೂ ಸ್ಕ್ರಿಪ್ಟ್ಗೆ ತಲುಪುವುದಿಲ್ಲ. - ಏಜೆಂಟ್ನಿಂದ ಬರುವ
REFERಅನ್ನು ಸ್ವೀಕರಿಸುವ ಕುರಿತು NICE ದಾಖಲಾತಿ ನೀಡಿಲ್ಲ. - REST API ಕ್ರಿಯೆಯು ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ 10 ಸೆಕೆಂಡುಗಳ ನಂತರ ಟೈಮ್ಔಟ್ ಆಗುತ್ತದೆ (ಗರಿಷ್ಠ 90 ಸೆಕೆಂಡುಗಳಿಗಿಂತ ಕಡಿಮೆ) ಮತ್ತು 32 KB ವರೆಗಿನ ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ಓದುತ್ತದೆ.