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

Contact centers

Genesys Cloud سے کنیکٹ کریں

Genesys Cloud کالز کو گفتگو کی id اور UUI کے ساتھ BYOC Cloud trunk کے ذریعے ThunderPhone ایجنٹ کو بھیجیں، اور hand-off کو UUI میں رکھ کر انہیں واپس لیں۔

آپ کا Architect فلو کالر کو BYOC Cloud ٹرنک کے ذریعے ایجنٹ کے پاس بھیجتا ہے، گفتگو ID اور آپ کی مقرر کردہ کسی بھی UUI کے ساتھ۔ جب کالر کو کسی شخص کی ضرورت ہو، تو ایجنٹ ایک SIP REFER بھیجتا ہے، Genesys کال واپس لے لیتا ہے، اور منتقلی ID کال کی UUI میں پہنچتی ہے۔

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

  • ایک ThunderPhone ایجنٹ اور تنظیم کی API کلید۔
  • Genesys Cloud جس میں BYOC Cloud ہو، اور ایک بیرونی ٹرنک (قسم BYOC Carrier یا PBX) جس میں یہ ترتیبات فعال ہوں (بیرونی ٹرنک کی ترتیبات):
    • گفتگو ہیڈرز، تاکہ Genesys اپنی گفتگو ID x-inin-cnv میں بھیجے۔ یہ بطور ڈیفالٹ بند ہوتا ہے۔
    • UUI پاس تھرو، جس کا ہیڈر ٹائپ User-To-User اور انکوڈنگ ہیکس ہو۔
    • واپس لینا اور منتقل کرنا، تاکہ Genesys ایجنٹ کا REFER قبول کرے۔

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

Genesys ڈائجسٹ چیلنج کا جواب دیتا ہے، اس لیے ایک معیاری اینڈ پوائنٹ استعمال کریں:

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": "Genesys Cloud"}'

جواب سے password فوراً محفوظ کر لیں؛ یہ صرف ایک بار دکھایا جاتا ہے۔ ٹرنک پر:

ترتیبقدر
SIP سرورsip.thunderphone.com، پورٹ 5061
پروٹوکولTLS
ڈائجسٹ توثیقاینڈ پوائنٹ کا username اور password
کوڈیکسPCMU، PCMA یا G.722

ٹرنک کو اپنی سائٹ کے ایک آؤٹ باؤنڈ روٹ پر رکھیں جس کا نمبر پلان اس پتے کا احاطہ کرتا ہو جسے فلو ڈائل کرتا ہے۔

2. سیاق کے ساتھ کالز بھیجیں

اپنے Architect فلو میں:

  1. اختیاری طور پر، ایجنٹ کے لیے سیاق کے ساتھ ایک UUI ڈیٹا مقرر کریں ایکشن شامل کریں، مثلاً account=12345۔ Genesys 128 یا اس سے کم حروف کی تجویز دیتا ہے۔
  2. اینڈ پوائنٹ کے sip_uri کے ساتھ ایک نمبر پر منتقل کریں ایکشن شامل کریں، مثلاً sip:agent-12-jhxmginwjx@sip.thunderphone.com۔

Genesys گفتگو ID کو x-inin-cnv میں بھیجتا ہے۔ ThunderPhone اسے کال کی external_call_id کے طور پر محفوظ کرتا ہے۔ UUI ڈی کوڈ ہو کر prompt میں {{sip_uui}} کے طور پر پہنچتی ہے۔

Genesys میں ٹرنک کے کسٹم ہیڈرز جامد ہوتے ہیں، اس لیے فی کال اقدار UUI میں رکھیں۔ Genesys x-inin، x-genesys، x-pcv اور x-gcv ہیڈر سابقے اپنے لیے محفوظ رکھتا ہے۔

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

ایجنٹ Genesys پر موجود ایک پتے کو REFER کے ذریعے منتقل کرتا ہے، جس میں اس پتے کے اندر منتقلی ID بطور ہیکس UUI ہوتی ہے۔ یہ منتقلی نمبر شامل کریں (منتقلی نمبر شامل کریں اور منتقلی پتے کے اندر ہیڈرز دیکھیں):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

پتے کو ایسے پتے سے تبدیل کریں جو واپس اس قطار یا فلو تک روٹ کرے جسے کالر وصول کرنا چاہیے؛ اس کی صورت Genesys سے تصدیق کریں۔ REFER اس طرح دکھائی دیتا ہے:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

واپس لینا اور منتقل کرنا فعال ہونے پر، Genesys ٹرنک سے کال واپس لے کر اسے اس پتے تک روٹ کرتا ہے۔ Genesys دستاویز کرتا ہے کہ آنے والی UUI Call.UUIData میں پہنچتی ہے؛ یہ واپس لینے کی صورت میں دستاویز نہیں کیا گیا، اس لیے Genesys سے، یا ایک آزمائشی کال پر، تصدیق کریں کہ کالر وصول کرنے والا فلو وہاں منتقلی ID تلاش کر لیتا ہے۔ خلاصہ اور ارادہ حاصل کرنے کے لیے، ویب سروسز ڈیٹا ایکشنز انضمام پر ایک کال ڈیٹا ایکشن کے ساتھ منتقلی تلاش اپ کو کال کریں:

  • درخواست: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= جس کے بعد Call.UUIData سے ID ہو۔
  • اسناد: آپ کی API کلید، جو Authorization: Bearer sk_live_… کے طور پر بھیجی جائے۔
  • آؤٹ پٹ: handoff.summary اور handoff.intent کو فلو ویری ایبلز پر میپ کریں۔

منتقل کی گئی کال تلاش کریں دیکھیں۔

اسے آزمائیں

ایسے نمبر پر کال کریں جو فلو تک پہنچتا ہو، ایجنٹ سے کسی شخص کے لیے کہیں، اور تصدیق کریں کہ Genesys کال کو آپ کے مقرر کردہ پتے پر لے جاتا ہے۔ اس فلو میں، تصدیق کریں کہ Call.UUIData میں ہینڈ آف id بطور متن موجود ہے (اگر اس میں hex ہندسے نظر آئیں تو چیک کریں کہ trunk کی UUI encoding Hex ہے)۔ پھر GET /v1/calls/{call_id} کے ذریعے کال کھولیں: external_call_id conversation id ہونا چاہیے۔

حدود

  • SIP Headers حاصل کریں ایکشن صرف ابتدائی INVITE پڑھتا ہے، اس لیے یہ ایجنٹ کے REFER سے کچھ نہیں پڑھ سکتا۔ ہینڈ آف صرف UUI کے ذریعے Genesys تک پہنچتا ہے۔
  • جب کسی کال میں ایک سے زیادہ UUI header ہوں تو Genesys تمام UUI حذف کر دیتا ہے۔
  • transfer address کو 254 حروف تک محدود رکھا جاتا ہے، اس لیے طویل UUI کو موزوں بنانے کے لیے کاٹ دیا جاتا ہے۔ ہینڈ آف id ہمیشہ سما جاتا ہے۔