---
title: "NICE CXone ನಿಂದ ಸಂಪರ್ಕಿಸಿ"
description: "Studio ಸ್ಕ್ರಿಪ್ಟ್‌ನಿಂದ SIP ಹೆಡರ್‌ನಲ್ಲಿರುವ ContactID ಜೊತೆಗೆ NICE CXone ಕರೆಗಳನ್ನು ThunderPhone ಏಜೆಂಟ್‌ಗೆ ಕಳುಹಿಸಿ, ಮತ್ತು ಸ್ಕ್ರಿಪ್ಟ್ ಮುಂದುವರಿದಾಗ ಏಜೆಂಟ್‌ನ ಹ್ಯಾಂಡ್-ಆಫ್ ಅನ್ನು ಹುಡುಕಿ."
---

ನಿಮ್ಮ CXone Studio ಸ್ಕ್ರಿಪ್ಟ್, ಸಂಪರ್ಕ ಐಡಿ ಮತ್ತು ಇತರ ಯಾವುದೇ ಸಂದರ್ಭವನ್ನು ಹೊಂದಿರುವ SIP ಹೆಡರ್‌ಗಳೊಂದಿಗೆ ಏಜೆಂಟ್‌ಗೆ ಕರೆ ಮಾಡುತ್ತದೆ. ಏಜೆಂಟ್ ಕಾರ್ಯ ಮುಗಿಸಿದಾಗ, ಅದು ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ ಮತ್ತು ಸ್ಕ್ರಿಪ್ಟ್‌ನಲ್ಲಿರುವ REST API ಕ್ರಿಯೆಯು ಹಸ್ತಾಂತರವನ್ನು ಪಡೆಯುತ್ತದೆ.

## ಪ್ರಾರಂಭಿಸುವ ಮೊದಲು

- ThunderPhone ಏಜೆಂಟ್ ಮತ್ತು ಸಂಸ್ಥೆಯ [API ಕೀ](/kn/guides/api-keys).
- ಕಸ್ಟಮ್ ಹೆಡರ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸುವ CXone SIP ಟ್ರಂಕ್ ಗುಂಪು. CXone ಅವುಗಳನ್ನು ಕಳುಹಿಸುವ ಮೊದಲು ನಿಮ್ಮ NICE ಖಾತೆ ಪ್ರತಿನಿಧಿಯು ಈ ಸೆಟ್ಟಿಂಗ್ ಅನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಬೇಕು.

## 1. SIP ಎಂಡ್‌ಪಾಯಿಂಟ್ ರಚಿಸಿ

Placecall, SIP ವಿಳಾಸಕ್ಕಲ್ಲದೆ CXone ಟ್ರಂಕ್ ಗುಂಪಿನ ಮೂಲಕ ಫೋನ್ ಸಂಖ್ಯೆಗೆ ಡಯಲ್ ಮಾಡುತ್ತದೆ.
NICE ಇದಕ್ಕಾಗಿ SIP ರುಜುವಾತುಗಳನ್ನು ದಾಖಲಿಸುವುದಿಲ್ಲ, ಮತ್ತು ಮತ್ತೊಂದು AI ಪೂರೈಕೆದಾರರ CXone
ಏಕೀಕರಣವು IP ಅನುಮತಿಪಟ್ಟಿಯೊಂದಿಗೆ TLS ಬಳಸುತ್ತದೆ. ಆದ್ದರಿಂದ ಸ್ಕ್ರಿಪ್ಟ್ ಡಯಲ್ ಮಾಡುವ ಸಂಖ್ಯೆಯನ್ನು ಡಯಲ್-ಇನ್ ಸಂಖ್ಯೆಯಾಗಿ ಬಳಸಿ `ip_allowlist`
ಎಂಡ್‌ಪಾಯಿಂಟ್ ರಚಿಸಿ ([ಫೋನ್ ಸಂಖ್ಯೆಗೆ ಡಯಲ್ ಮಾಡುವ ಪ್ಲಾಟ್‌ಫಾರ್ಮ್‌ಗಳು](/kn/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 ಸಿಗ್ನಲಿಂಗ್ ಶ್ರೇಣಿಗಳು. ಪ್ರತಿಯೊಂದೂ `/16` ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಿರಿದಾದ ಸಾರ್ವಜನಿಕ IPv4 ಶ್ರೇಣಿಯಾಗಿರಬೇಕು (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** ಕ್ರಿಯೆಯನ್ನು ಸೇರಿಸಿ, ಉದಾಹರಣೆಗೆ `support` ಗೆ ಹೊಂದಿಸಲಾದ `X-Skill`. ಇದು `{{sip_x_skill}}` ಆಗಿ prompt ಗೆ ತಲುಪುತ್ತದೆ. Sipputheader `User-to-User`, ಯಾವುದೇ `X-` ಹೆಡರ್ ಮತ್ತು ಬಹುತೇಕ `P-` ಹೆಡರ್‌ಗಳನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ; NICE 256 ಅಕ್ಷರಗಳು ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಡಿಮೆ ಮೌಲ್ಯಗಳನ್ನು ಶಿಫಾರಸು ಮಾಡುತ್ತದೆ.

ನಂತರ, ಸಂಖ್ಯೆ ಮತ್ತು `To`
ಹೆಡರ್ ಎರಡರಲ್ಲಿಯೂ ಸಂಖ್ಯೆಯೊಂದಿಗೆ ಅದನ್ನು `sip.thunderphone.com` ಗೆ ಕಳುಹಿಸುವ ಟ್ರಂಕ್ ಗುಂಪಿನ ಮೂಲಕ ಆ ಸಂಖ್ಯೆಗೆ **Placecall** ಮಾಡಿ. ಎಂಡ್‌ಪಾಯಿಂಟ್ TLS (ಪೋರ್ಟ್ 5061) ಅಥವಾ TCP (ಪೋರ್ಟ್ 5060) ಸ್ವೀಕರಿಸುತ್ತದೆ ಮತ್ತು
UDP ನಿರಾಕರಿಸುತ್ತದೆ; NICE ಟ್ರಂಕ್‌ನ ಸಾರಿಗೆ ವಿಧಾನವನ್ನು ದಾಖಲಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಅದು
UDP ಅಲ್ಲ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ.

## 3. ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ

CXone SIP ಹೆಡರ್‌ಗಳನ್ನು `INVITE` ಮತ್ತು ಅದರ ಅಂತಿಮ ಪ್ರತಿಕ್ರಿಯೆಯಲ್ಲಿ ಮಾತ್ರ ಓದುತ್ತದೆ, ಆದ್ದರಿಂದ ಏಜೆಂಟ್ ಕರೆಯನ್ನು ಮರಳಿಸುತ್ತದೆ: ಅದು ವಿದಾಯ ಹೇಳಿ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ, ಮತ್ತು ನಿಮ್ಮ ಸ್ಕ್ರಿಪ್ಟ್ ಕರೆಗಾರನನ್ನು ಮತ್ತೆ ಸ್ವೀಕರಿಸುತ್ತದೆ. ಈ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ ([ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ](/kn/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` ನಲ್ಲಿರುವ ಯಾವುದೂ ಸ್ಕ್ರಿಪ್ಟ್‌ಗೆ ತಲುಪುವುದಿಲ್ಲ.
- ಏಜೆಂಟ್‌ನಿಂದ ಬರುವ `REFER` ಅನ್ನು ಸ್ವೀಕರಿಸುವ ಕುರಿತು NICE ದಾಖಲಾತಿ ನೀಡಿಲ್ಲ.
- REST API ಕ್ರಿಯೆಯು ಪೂರ್ವನಿಯೋಜಿತವಾಗಿ 10 ಸೆಕೆಂಡುಗಳ ನಂತರ ಟೈಮ್‌ಔಟ್ ಆಗುತ್ತದೆ (ಗರಿಷ್ಠ 90 ಸೆಕೆಂಡುಗಳಿಗಿಂತ ಕಡಿಮೆ)
  ಮತ್ತು 32 KB ವರೆಗಿನ ಪ್ರತಿಕ್ರಿಯೆಗಳನ್ನು ಓದುತ್ತದೆ.
