---
title: "NICE CXone ਤੋਂ ਕਨੈਕਟ ਕਰੋ"
description: "Studio ਸਕ੍ਰਿਪਟ ਤੋਂ SIP ਹੈਡਰ ਵਿੱਚ ContactID ਦੇ ਨਾਲ NICE CXone ਕਾਲਾਂ ਨੂੰ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ ਸਕ੍ਰਿਪਟ ਜਾਰੀ ਰਹਿਣ 'ਤੇ ਏਜੰਟ ਦੇ ਹੈਂਡ-ਆਫ਼ ਨੂੰ ਲੱਭੋ।"
---

ਤੁਹਾਡੀ CXone Studio ਸਕ੍ਰਿਪਟ SIP ਹੈਡਰਾਂ ਨਾਲ ਏਜੰਟ ਨੂੰ ਕਾਲ ਕਰਦੀ ਹੈ, ਜਿਨ੍ਹਾਂ ਵਿੱਚ
ਕਾਂਟੈਕਟ ID ਅਤੇ ਹੋਰ ਸੰਦਰਭ ਹੁੰਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਕੰਮ ਪੂਰਾ ਹੋ ਜਾਂਦਾ ਹੈ, ਉਹ ਕਾਲ
ਖਤਮ ਕਰਦਾ ਹੈ ਅਤੇ ਸਕ੍ਰਿਪਟ ਵਿੱਚ ਇੱਕ REST API ਐਕਸ਼ਨ ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

## ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ ਦੀ [API ਕੁੰਜੀ](/pa/guides/api-keys)।
- ਇੱਕ CXone SIP ਟਰੰਕ ਗਰੁੱਪ ਜੋ ਕਸਟਮ ਹੈਡਰ ਸਵੀਕਾਰ ਕਰਦਾ ਹੋਵੇ। CXone ਵੱਲੋਂ ਇਹ ਭੇਜਣ
  ਤੋਂ ਪਹਿਲਾਂ ਤੁਹਾਡੇ NICE ਖਾਤਾ ਪ੍ਰਤੀਨਿਧੀ ਨੂੰ ਇਹ ਸੈਟਿੰਗ ਚਾਲੂ ਕਰਨੀ ਪਵੇਗੀ।

## 1. SIP ਐਂਡਪੌਇੰਟ ਬਣਾਓ

Placecall SIP ਪਤੇ ਦੀ ਬਜਾਏ CXone ਟਰੰਕ ਗਰੁੱਪ ਰਾਹੀਂ ਇੱਕ ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਦਾ ਹੈ।
NICE ਇਸ ਲਈ SIP ਪ੍ਰਮਾਣ-ਪੱਤਰਾਂ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਨਹੀਂ ਕਰਦਾ ਅਤੇ ਇੱਕ ਹੋਰ AI ਪ੍ਰਦਾਤਾ ਦਾ
CXone ਇੰਟੀਗ੍ਰੇਸ਼ਨ IP ਅਲਾਊਲਿਸਟ ਨਾਲ TLS ਵਰਤਦਾ ਹੈ। ਇਸ ਲਈ ਸਕ੍ਰਿਪਟ ਜਿਸ ਨੰਬਰ ਨੂੰ ਡਾਇਲ
ਕਰੇਗੀ ਉਸਨੂੰ ਡਾਇਲ-ਇਨ ਨੰਬਰ ਵਜੋਂ ਵਰਤ ਕੇ ਇੱਕ `ip_allowlist` ਐਂਡਪੌਇੰਟ ਬਣਾਓ (ਵੇਖੋ
[ਉਹ ਪਲੇਟਫਾਰਮ ਜੋ ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਦੇ ਹਨ](/pa/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 ਆਪਣਾ ਕੋਈ ਕਾਲ-ID ਹੈਡਰ ਨਹੀਂ ਭੇਜਦਾ; ThunderPhone ਇਸਨੂੰ ਕਾਲ ਦੀ
   `external_call_id` ਵਜੋਂ ਸਟੋਰ ਕਰਦਾ ਹੈ।
2. ਏਜੰਟ ਨੂੰ ਪਤਾ ਹੋਣੇ ਚਾਹੀਦੇ ਹਰ ਹੋਰ ਮੁੱਲ ਲਈ ਇੱਕ **Sipputheader** ਐਕਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ,
   ਜਿਵੇਂ `support` 'ਤੇ ਸੈੱਟ ਕੀਤਾ `X-Skill`। ਇਹ prompt ਵਿੱਚ `{{sip_x_skill}}`
   ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ। Sipputheader `User-to-User`, ਕੋਈ ਵੀ `X-` ਹੈਡਰ ਅਤੇ ਜ਼ਿਆਦਾਤਰ
   `P-` ਹੈਡਰ ਲੈਂਦਾ ਹੈ; NICE 256 ਅੱਖਰਾਂ ਜਾਂ ਇਸ ਤੋਂ ਘੱਟ ਦੇ ਮੁੱਲਾਂ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕਰਦਾ ਹੈ।

ਫਿਰ ਉਸ ਨੰਬਰ ਉੱਤੇ **Placecall** ਕਰੋ, ਅਜਿਹੇ ਟਰੰਕ ਗਰੁੱਪ ਰਾਹੀਂ ਜੋ ਇਸਨੂੰ ਬੇਨਤੀ URI ਅਤੇ
`To` ਹੈਡਰ ਦੋਵਾਂ ਵਿੱਚ ਨੰਬਰ ਸਮੇਤ `sip.thunderphone.com` ਨੂੰ ਭੇਜਦਾ ਹੈ। ਐਂਡਪੌਇੰਟ TLS
(ਪੋਰਟ 5061) ਜਾਂ TCP (ਪੋਰਟ 5060) ਲੈਂਦਾ ਹੈ ਅਤੇ UDP ਨੂੰ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ, ਅਤੇ NICE
ਟਰੰਕ ਦੇ ਟਰਾਂਸਪੋਰਟ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਨਹੀਂ ਕਰਦਾ, ਇਸ ਲਈ ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਇਹ UDP ਨਹੀਂ ਹੈ।

## 3. ਕਾਲ ਵਾਪਸ ਲਵੋ

CXone SIP ਹੈਡਰ ਸਿਰਫ਼ `INVITE` ਅਤੇ ਇਸਦੇ ਅੰਤਿਮ ਜਵਾਬ ਵਿੱਚ ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ ਏਜੰਟ ਕਾਲ
ਵਾਪਸ ਕਰਦਾ ਹੈ: ਇਹ ਅਲਵਿਦਾ ਕਹਿੰਦਾ ਹੈ ਅਤੇ ਕਾਲ ਖਤਮ ਕਰਦਾ ਹੈ, ਅਤੇ ਤੁਹਾਡੀ ਸਕ੍ਰਿਪਟ ਕਾਲਰ ਨੂੰ
ਦੁਬਾਰਾ ਲੈ ਲੈਂਦੀ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ (ਵੇਖੋ
[ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ](/pa/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

NICE ਇਸ ਗੱਲ ਦਾ ਦਸਤਾਵੇਜ਼ੀਕਰਨ ਨਹੀਂ ਕਰਦਾ ਕਿ ਕੀ ਸਕ੍ਰਿਪਟ Placecall ਤੋਂ ਬਾਅਦ, ਕੀਤੀ ਹੋਈ
ਕਾਲ ਖਤਮ ਹੋਣ 'ਤੇ, ਜਾਰੀ ਰਹਿੰਦੀ ਹੈ। ਹੋਰ 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 ਤੱਕ ਦੇ ਜਵਾਬ ਪੜ੍ਹਦੀ ਹੈ।
