ThunderPhone v3 اب لائیو ہے۔سیلف سرو، قیمت 2¢ فی منٹ سے شروع۔اعلان پڑھیں

Contact centers

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 سے پہلے:

  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 اور اس کے حتمی جواب پر پڑھتا ہے، اس لیے ایجنٹ کال واپس کرتا ہے: وہ الوداع کہتا ہے اور کال ختم کرتا ہے، پھر آپ کا اسکرپٹ کالر کو دوبارہ سنبھال لیتا ہے۔ یہ ٹرانسفر نمبر شامل کریں (دیکھیں ٹرانسفر نمبر شامل کریں):

{"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 تک کے جوابات پڑھتی ہے۔