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 allowlist सह 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 सिग्नलिंग श्रेणी. प्रत्येक सार्वजनिक IPv4 श्रेणी/16किंवा त्यापेक्षा अरुंद असणे आवश्यक आहे (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 कृती जोडा, उदाहरणार्थ
X-Skillचे मूल्यsupportठेवा. ते prompt मध्ये{{sip_x_skill}}म्हणून पोहोचते. SipputheaderUser-to-User, कोणताहीX-हेडर आणि बहुतेकP-हेडर स्वीकारते; NICE 256 किंवा त्यापेक्षा कमी वर्णांची मूल्ये सुचवते.
त्यानंतर त्या नंबरवर Placecall करा, अशा ट्रंक गटाद्वारे जो नंबर request URI आणि To
हेडर या दोन्हीमध्ये ठेवून sip.thunderphone.com कडे पाठवतो. एंडपॉइंट TLS (पोर्ट 5061) किंवा
TCP (पोर्ट 5060) स्वीकारते आणि UDP नाकारते; NICE ट्रंकच्या ट्रान्सपोर्टचे दस्तऐवजीकरण करत नाही,
म्हणून ते UDP नाही याची खात्री करा.
3. कॉल परत मिळवा
CXone फक्त INVITE आणि त्याच्या अंतिम प्रतिसादावरील SIP हेडर वाचते, त्यामुळे एजंट कॉल परत
करतो: तो निरोप देतो आणि कॉल समाप्त करतो, आणि तुमची स्क्रिप्ट कॉलरला पुन्हा स्वीकारते. हा
हस्तांतरण नंबर जोडा (पहा
हस्तांतरण नंबर जोडा):
{"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मधील काहीही स्क्रिप्टपर्यंत पोहोचत नाही. - NICE एजंटकडून
REFERस्वीकारण्याचे दस्तऐवजीकरण करत नाही. - REST API क्रिया डीफॉल्टनुसार 10 सेकंदांनंतर टाइम आउट होते (कमाल 90 पेक्षा कमी) आणि 32 KB पर्यंतचे प्रतिसाद वाचते.