Open in
NICE CXone سے کنیکٹ کریں
Studio اسکرپٹ سے ContactID کو SIP ہیڈر میں شامل کر کے NICE CXone کالز ThunderPhone ایجنٹ کو بھیجیں، اور اسکرپٹ جاری رہنے پر ایجنٹ کی ہینڈ آف تلاش کریں۔
آپ کا CXone Studio اسکرپٹ SIP ہیڈرز کے ساتھ ایجنٹ کو کال کرتا ہے جو رابطہ id اور کوئی بھی دوسرا سیاق رکھتے ہیں۔ ایجنٹ کے مکمل کرنے پر، وہ کال ختم کرتا ہے، اور اسکرپٹ میں موجود REST API ایکشن ہینڈ آف حاصل کرتا ہے۔
شروع کرنے سے پہلے
- ایک ThunderPhone ایجنٹ اور تنظیم کی API key۔
- ایک CXone SIP ٹرنک گروپ جو حسب ضرورت ہیڈرز قبول کرتا ہو۔ CXone کے انہیں بھیجنے سے پہلے آپ کے NICE اکاؤنٹ کے نمائندے کو یہ ترتیب فعال کرنی ہوگی۔
1. SIP اینڈ پوائنٹ بنائیں
Placecall کسی SIP ایڈریس کے بجائے CXone ٹرنک گروپ کے ذریعے فون نمبر ڈائل کرتا ہے۔
NICE اس کے لیے SIP اسناد کی دستاویزات فراہم نہیں کرتا، اور ایک دوسرے AI فراہم کنندہ کا CXone
انضمام IP الاؤ لسٹ کے ساتھ 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 سگنلنگ رینجز۔ ہر ایک/16یا اس سے زیادہ محدود عوامی IPv4 رینج ہونی چاہیے (IPv6 کے لیے/48یا اس سے زیادہ محدود)۔dial_in_numbers: وہ نمبر جسے Placecall ڈائل کرے گا، اسی انداز میں لکھا ہوا جس انداز میں CXone اسے بھیجتا ہے۔ اس کا حقیقی فون نمبر ہونا ضروری نہیں ہے۔ یہ پہلے سے ThunderPhone پر بطور فون نمبر یا کسی دوسرے اینڈ پوائنٹ پر استعمال نہیں ہو سکتا: ایسا ہونے پر409واپس آتا ہے۔
CXone کے ایڈریس اس کے تمام صارفین کے درمیان مشترک ہوتے ہیں، اس لیے کوئی بھی دوسرا CXone صارف جو یہ نمبر ڈائل کرے، آپ کے ایجنٹ تک پہنچ جاتا ہے۔ جہاں آپ نمبر منتخب کرتے ہیں، ایک طویل نمبر منتخب کریں جس کا کوئی اندازہ نہ لگا سکے (15 ہندسوں تک)، یقینی بنائیں کہ CXone اسے فون نیٹ ورک پر بھیجنے کے بجائے ThunderPhone کو بھیجتا ہے، اور اسے شائع نہ کریں۔
2. سیاق کے ساتھ کالز بھیجیں
اپنے Studio اسکرپٹ میں، Placecall سے پہلے:
- ہیڈر
X-Call-IDاورContactIDکی قدر کے ساتھ ایک Sipputheader ایکشن شامل کریں۔ CXone اپنا کوئی call-id ہیڈر نہیں بھیجتا؛ ThunderPhone اسے کال کےexternal_call_idکے طور پر محفوظ کرتا ہے۔ - ہر اس دوسری قدر کے لیے ایک Sipputheader ایکشن شامل کریں جو ایجنٹ کو معلوم ہونی چاہیے،
مثلاً
supportپر سیٹ کردہX-Skill۔ یہ prompt میں{{sip_x_skill}}کے طور پر پہنچتی ہے۔ SipputheaderUser-to-User، کوئی بھیX-ہیڈر، اور زیادہ ترP-ہیڈرز لیتا ہے؛ NICE 256 حروف یا اس سے کم قدریں تجویز کرتا ہے۔
پھر اس نمبر پر Placecall کریں، ایسے ٹرنک گروپ کے ذریعے جو اسے
sip.thunderphone.com کو درخواست URI اور To ہیڈر، دونوں میں نمبر کے ساتھ بھیجے۔
اینڈ پوائنٹ TLS (پورٹ 5061) یا TCP (پورٹ 5060) قبول کرتا ہے اور UDP مسترد کرتا ہے،
اور NICE ٹرنک کے ٹرانسپورٹ کی دستاویزات فراہم نہیں کرتا، اس لیے یقینی بنائیں کہ وہ
UDP نہ ہو۔
3. کال واپس حاصل کریں
CXone SIP ہیڈرز صرف INVITE اور اس کے حتمی جواب پر پڑھتا ہے، اس لیے ایجنٹ کال واپس کرتا ہے:
وہ الوداع کہتا ہے اور کال ختم کرتا ہے، پھر آپ کا اسکرپٹ کالر کو دوبارہ سنبھال لیتا ہے۔
یہ ٹرانسفر نمبر شامل کریں (دیکھیں
ٹرانسفر نمبر شامل کریں):
{"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پڑھیں۔
دیکھیں ہینڈ آف کی گئی کال تلاش کریں۔
اس کی جانچ کریں
ایسے نمبر پر کال کریں جو اسکرپٹ چلاتا ہو، ایجنٹ سے کسی شخص کے لیے کہیں، اور تصدیق کریں کہ
اسکرپٹ جاری رہتا ہے اور 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 تک کے جوابات پڑھتی ہے۔