---
title: "NICE CXone سے کنیکٹ کریں"
description: "Studio اسکرپٹ سے ContactID کو SIP ہیڈر میں شامل کر کے NICE CXone کالز ThunderPhone ایجنٹ کو بھیجیں، اور اسکرپٹ جاری رہنے پر ایجنٹ کی ہینڈ آف تلاش کریں۔"
---

آپ کا CXone Studio اسکرپٹ SIP ہیڈرز کے ساتھ ایجنٹ کو کال کرتا ہے جو رابطہ id اور کوئی بھی دوسرا سیاق رکھتے ہیں۔ ایجنٹ کے مکمل کرنے پر، وہ کال ختم کرتا ہے، اور اسکرپٹ میں موجود REST API ایکشن ہینڈ آف حاصل کرتا ہے۔

## شروع کرنے سے پہلے

- ایک ThunderPhone ایجنٹ اور تنظیم کی [API key](/ur/guides/api-keys)۔
- ایک CXone SIP ٹرنک گروپ جو حسب ضرورت ہیڈرز قبول کرتا ہو۔ CXone کے انہیں بھیجنے سے پہلے آپ کے NICE اکاؤنٹ کے نمائندے کو یہ ترتیب فعال کرنی ہوگی۔

## 1. SIP اینڈ پوائنٹ بنائیں

Placecall کسی SIP ایڈریس کے بجائے CXone ٹرنک گروپ کے ذریعے فون نمبر ڈائل کرتا ہے۔
NICE اس کے لیے SIP اسناد کی دستاویزات فراہم نہیں کرتا، اور ایک دوسرے AI فراہم کنندہ کا CXone
انضمام IP الاؤ لسٹ کے ساتھ TLS استعمال کرتا ہے۔ اس لیے اس نمبر کے ساتھ ایک `ip_allowlist`
اینڈ پوائنٹ بنائیں جسے اسکرپٹ ڈائل کرے گا اور اسے ڈائل اِن نمبر کے طور پر شامل کریں (دیکھیں
[وہ پلیٹ فارمز جو فون نمبر ڈائل کرتے ہیں](/ur/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 اپنا کوئی call-id ہیڈر نہیں بھیجتا؛ ThunderPhone اسے کال کے `external_call_id`
   کے طور پر محفوظ کرتا ہے۔
2. ہر اس دوسری قدر کے لیے ایک **Sipputheader** ایکشن شامل کریں جو ایجنٹ کو معلوم ہونی چاہیے،
   مثلاً `support` پر سیٹ کردہ `X-Skill`۔ یہ prompt میں
   `{{sip_x_skill}}` کے طور پر پہنچتی ہے۔ Sipputheader `User-to-User`، کوئی بھی `X-` ہیڈر،
   اور زیادہ تر `P-` ہیڈرز لیتا ہے؛ NICE 256 حروف یا اس سے کم قدریں تجویز کرتا ہے۔

پھر اس نمبر پر **Placecall** کریں، ایسے ٹرنک گروپ کے ذریعے جو اسے
`sip.thunderphone.com` کو درخواست URI اور `To` ہیڈر، دونوں میں نمبر کے ساتھ بھیجے۔
اینڈ پوائنٹ TLS (پورٹ 5061) یا TCP (پورٹ 5060) قبول کرتا ہے اور UDP مسترد کرتا ہے،
اور NICE ٹرنک کے ٹرانسپورٹ کی دستاویزات فراہم نہیں کرتا، اس لیے یقینی بنائیں کہ وہ
UDP نہ ہو۔

## 3. کال واپس حاصل کریں

CXone SIP ہیڈرز صرف `INVITE` اور اس کے حتمی جواب پر پڑھتا ہے، اس لیے ایجنٹ کال واپس کرتا ہے:
وہ الوداع کہتا ہے اور کال ختم کرتا ہے، پھر آپ کا اسکرپٹ کالر کو دوبارہ سنبھال لیتا ہے۔
یہ ٹرانسفر نمبر شامل کریں (دیکھیں
[ٹرانسفر نمبر شامل کریں](/ur/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 تک کے جوابات پڑھتی ہے۔
