---
title: "NICE CXone मधून कनेक्ट करा"
description: "Studio स्क्रिप्टमधून SIP हेडरमध्ये ContactID सह NICE CXone कॉल ThunderPhone एजंटकडे पाठवा आणि स्क्रिप्ट पुढे सुरू राहिल्यावर एजंटचे हँड-ऑफ शोधा."
---

तुमची CXone Studio स्क्रिप्ट SIP हेडरसह एजंटला कॉल करते, ज्यामध्ये संपर्क आयडी आणि इतर कोणताही संदर्भ असतो. एजंटचे काम पूर्ण झाल्यावर तो कॉल समाप्त करतो आणि स्क्रिप्टमधील REST API कृती हस्तांतरण मिळवते.

## सुरू करण्यापूर्वी

- ThunderPhone एजंट आणि संस्थेची [API की](/mr/guides/api-keys).
- सानुकूल हेडर स्वीकारणारा CXone SIP ट्रंक गट. CXone ने ते पाठवण्यापूर्वी तुमच्या NICE खाते प्रतिनिधीला हे सेटिंग सक्षम करावे लागेल.

## 1. SIP एंडपॉइंट तयार करा

Placecall SIP पत्त्यावर नाही, तर CXone ट्रंक गटाद्वारे फोन नंबरवर कॉल करते.
NICE यासाठी SIP क्रेडेन्शियल्सचे दस्तऐवजीकरण करत नाही आणि दुसऱ्या AI प्रदात्याच्या CXone
इंटिग्रेशनमध्ये IP allowlist सह TLS वापरले जाते. म्हणून स्क्रिप्ट ज्या नंबरवर कॉल करेल तो
डायल-इन नंबर म्हणून वापरून `ip_allowlist` एंडपॉइंट तयार करा (पहा
[फोन नंबरवर कॉल करणारे प्लॅटफॉर्म](/mr/guides/sip-addresses)):

```bash
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** पूर्वी:

1. हेडर `X-Call-ID` आणि मूल्य `ContactID` असलेली **Sipputheader** कृती जोडा. CXone स्वतःचा
   कॉल-आयडी हेडर पाठवत नाही; ThunderPhone हा हेडर कॉलचा `external_call_id` म्हणून संग्रहित करते.
2. एजंटला माहिती असावी अशा प्रत्येक इतर मूल्यासाठी **Sipputheader** कृती जोडा, उदाहरणार्थ
   `X-Skill` चे मूल्य `support` ठेवा. ते prompt मध्ये `{{sip_x_skill}}` म्हणून पोहोचते.
   Sipputheader `User-to-User`, कोणताही `X-` हेडर आणि बहुतेक `P-` हेडर स्वीकारते; NICE
   256 किंवा त्यापेक्षा कमी वर्णांची मूल्ये सुचवते.

त्यानंतर त्या नंबरवर **Placecall** करा, अशा ट्रंक गटाद्वारे जो नंबर request URI आणि `To`
हेडर या दोन्हीमध्ये ठेवून `sip.thunderphone.com` कडे पाठवतो. एंडपॉइंट TLS (पोर्ट 5061) किंवा
TCP (पोर्ट 5060) स्वीकारते आणि UDP नाकारते; NICE ट्रंकच्या ट्रान्सपोर्टचे दस्तऐवजीकरण करत नाही,
म्हणून ते UDP नाही याची खात्री करा.

## 3. कॉल परत मिळवा

CXone फक्त `INVITE` आणि त्याच्या अंतिम प्रतिसादावरील SIP हेडर वाचते, त्यामुळे एजंट कॉल परत
करतो: तो निरोप देतो आणि कॉल समाप्त करतो, आणि तुमची स्क्रिप्ट कॉलरला पुन्हा स्वीकारते. हा
हस्तांतरण नंबर जोडा (पहा
[हस्तांतरण नंबर जोडा](/mr/guides/contact-centers/overview)):

```json
{"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`
  वाचा.

पहा [हस्तांतरित केलेला कॉल शोधा](/api-reference/calls#look-up-a-handed-off-call).

## चाचणी करा

स्क्रिप्ट चालवणाऱ्या क्रमांकावर कॉल करा, एजंटला एखाद्या व्यक्तीसाठी विचारा आणि
स्क्रिप्ट पुढे सुरू राहते व 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 पर्यंतचे प्रतिसाद वाचते.
