Open in
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قبول کرے۔
- گفتگو ہیڈرز، تاکہ Genesys اپنی گفتگو ID
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 فلو میں:
- اختیاری طور پر، ایجنٹ کے لیے سیاق کے ساتھ ایک UUI ڈیٹا مقرر کریں ایکشن شامل کریں، مثلاً
account=12345۔ Genesys 128 یا اس سے کم حروف کی تجویز دیتا ہے۔ - اینڈ پوائنٹ کے
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 ہمیشہ سما جاتا ہے۔