Open in
Five9 سے کنیکٹ کریں
AI Agent Connect کے ذریعے SIP پر Five9 کالز کو ThunderPhone ایجنٹ تک بھیجیں، اور انہیں ان روٹنگ ہیڈرز کے ساتھ واپس حاصل کریں جنہیں آپ کی IVR اسکرپٹ پڑھتی ہے۔
آپ کی Five9 IVR اسکرپٹ کالر کو Five9 کی کال کی تفصیلات کے ساتھ ایجنٹ کے پاس بھیجتی ہے۔ جب ایجنٹ کا کام مکمل ہو جاتا ہے، تو وہ SIP BYE پر روٹنگ ہیڈرز کے ساتھ کال منقطع کرتا ہے، جنہیں اسکرپٹ کالر کو روٹ کرنے کے لیے کال ویری ایبلز میں پڑھتی ہے۔
شروع کرنے سے پہلے
- ایک ThunderPhone ایجنٹ اور تنظیم کی API کلید۔
- Five9 کا AI ایجنٹ کنیکٹ ایڈ آن۔ Five9 اسے ان AI فراہم کنندگان تک محدود رکھتا ہے جنہیں اس نے منظوری دی ہو، اور Five9 کی عمل درآمد ٹیم اسے ترتیب دیتی ہے: یہ فراہم کنندہ کا IVR اسکرپٹ ٹیمپلیٹ درآمد کرتی ہے، کال ویری ایبلز بناتی ہے اور اسکرپٹ کے فریقِ ثالث منتقلی ماڈیول کو فراہم کنندہ کی طرف متوجہ کرتی ہے۔ ThunderPhone ابھی Five9 کی منظور شدہ فہرست میں شامل نہیں ہے: اس پر منصوبہ بنانے سے پہلے اپنی Five9 اکاؤنٹ ٹیم یا ThunderPhone سپورٹ سے پوچھیں۔
1. SIP اینڈپوائنٹ بنائیں
Five9 کا فریقِ ثالث منتقلی ماڈیول SIP ایڈریس کے بجائے فون نمبر ڈائل کرتا ہے، اور دوسرے فراہم کنندگان کے Five9 انضمامات Five9 کی توثیق پاس ورڈ کے بجائے سورس ایڈریس سے کرتے ہیں۔ اس لیے Five9 کے ڈائل کیے جانے والے نمبر کو ڈائل اِن نمبر کے طور پر شامل کرتے ہوئے ایک 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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: Five9 سے حاصل کردہ آپ کے Five9 ڈیٹا سینٹرز کی SIP سگنلنگ رینجز۔ ہر ایک عوامی IPv4 رینج/16یا اس سے زیادہ محدود ہونی چاہیے (IPv6/48یا اس سے زیادہ محدود)۔dial_in_numbers: وہ نمبر جو Five9 کی اسکرپٹ ڈائل کرے گی، اسی انداز میں لکھا ہوا جس میں Five9 اسے بھیجتا ہے۔ اس کا حقیقی فون نمبر ہونا ضروری نہیں ہے۔ یہ ThunderPhone پر پہلے سے بطور فون نمبر یا کسی دوسرے اینڈپوائنٹ پر استعمال میں نہیں ہو سکتا: ایسی صورت میں409واپس آتا ہے۔
Five9 کے ایڈریس اس کے تمام صارفین میں مشترک ہوتے ہیں، اس لیے کوئی بھی دوسرا Five9 صارف جو یہ نمبر ڈائل کرے گا آپ کے ایجنٹ تک پہنچ جائے گا۔ نمبر منتخب کرتے وقت، ایک لمبا نمبر منتخب کریں جس کا کوئی اندازہ نہ لگا سکے (15 ہندسوں تک)، یقینی بنائیں کہ Five9 اسے فون نیٹ ورک پر باہر بھیجنے کے بجائے ThunderPhone کو بھیجتا ہے، اور اسے شائع نہ کریں۔
2. سیاق کے ساتھ کالز بھیجیں
Five9 کی عمل درآمد ٹیم سے کہیں کہ:
- کال کو فریقِ ثالث منتقلی ماڈیول سے
sip:+14155550188@sip.thunderphone.comپر بھیجیں، جس میں نمبر ریکویسٹ URI اورToہیڈر، دونوں میں ہو۔ ماڈیول فراہم کنندہ کے SIP ڈومین کے ساتھ ہیڈر میں نمبر لیتا ہے۔ - اسے TLS (پورٹ 5061) یا TCP (پورٹ 5060) پر بھیجیں۔ اینڈپوائنٹ UDP کو مسترد کرتا ہے، اور Five9 یہ شائع نہیں کرتا کہ وہ کون سی ٹرانسپورٹ استعمال کرتا ہے، اس لیے یقینی بنائیں کہ وہ UDP نہ ہو۔
- تیسرے فریق کی کال کے بعد واپس جائیں کو فعال کریں، تاکہ ایجنٹ کے کال منقطع کرنے پر اسکرپٹ جاری رہے (Five9 تیسرے فریق کی کال پر 3,600 سیکنڈ تک کی اجازت دیتا ہے)۔
Five9 کی گائیڈ ان اقدار کی فہرست دیتی ہے جو وہ بھیجتا ہے (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name اور دیگر)، ان کے
ہیڈر نام نہیں۔ دوسرے AI فراہم کنندگان کے Five9 انضمامات انہیں SIP پیغامات میں
X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
اور X-AgentID کے طور پر دستاویز کرتے ہیں؛ اپنی پہلی آزمائشی کال پر انہیں چیک کریں۔ ہر ایک prompt تک ویری ایبل کے طور پر پہنچتا ہے، مثلاً
{{sip_x_callcampaign}}۔ X-CallID کال کے
external_call_id کے طور پر محفوظ ہوتا ہے۔
3. کال واپس کریں
ایجنٹ کال واپس کرتا ہے: یہ الوداع کہتا ہے اور کال ختم کرتا ہے، اور BYE میں وہ
چار ہیڈرز شامل ہوتے ہیں جو Five9 کا اسکرپٹ پڑھتا ہے۔ یہ ٹرانسفر نمبر شامل کریں (دیکھیں
ٹرانسفر نمبر شامل کریں):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeاورX-RouteValueاسکرپٹ کو بتاتے ہیں کہ کالر کو کہاں بھیجنا ہے، یہاں سپورٹ اسکل میں۔ دوسرے فراہم کنندگانX-RouteTypeکے لیے جن ویلیوز کی دستاویز کرتے ہیں ان میںSkillTransfer،PhoneTransfer،HangupاورDispositionOnlyشامل ہیں؛ ویلیوز پر اسکرپٹ برقرار رکھنے والے شخص سے اتفاق کریں۔ متعدد منزلوں کے لیے، ہر منزل کے لیے مختلف نام اورX-RouteValueکے ساتھ ایک الگ واپسی شامل کریں۔X-RouteReasonایجنٹ کا انٹینٹ لیبل لے جاتا ہے، جیسےbilling_dispute۔X-CustomMetaDataہینڈ آف آئی ڈی لے جاتا ہے۔BYEاسےX-TP-Handoff-Idکے طور پر بھی لے جاتا ہے، جسے Five9 نہیں پڑھتا۔
Five9 کا اسکرپٹ ان چار ہیڈرز کو کال ویری ایبلز میں میپ کرتا ہے۔ ایجنٹ کے
خلاصے کے لیے، اسکرپٹ سے IVR کے استعلام ماڈیول کے ذریعے ہینڈ آف تلاش کو کال کروائیں:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= کے بعد
call.call_id، ایک آتھنٹیکیشن پروفائل کے ساتھ جو
Authorization: Bearer اور آپ کی API کلید بھیجتا ہو۔ دیکھیں
ہینڈ آف کی گئی کال تلاش کریں۔
اس کی جانچ کریں
IVR اسکرپٹ پر کال کریں، ایجنٹ سے کسی شخص سے بات کرانے کو کہیں، اور تصدیق کریں کہ اسکرپٹ
کال ویری ایبلز بھرے ہوئے ہونے کے ساتھ کالر کو روٹ کرتا ہے۔ اگر کال کبھی ایجنٹ تک نہ پہنچے،
تو تصدیق کریں کہ ریکویسٹ URI اور To ہیڈر میں موجود نمبر ڈائل اِن نمبر سے مطابقت رکھتا ہے،
کہ Five9 کا سورس ایڈریس allowed_source_cidrs میں ہے، اور
کہ کال TCP یا TLS کے ذریعے آئی تھی۔ پھر کال کو
GET /v1/calls/{call_id} کے ذریعے کھولیں: sip_headers میں x-callid درج ہونا چاہیے، اور
external_call_id کو Five9 میں call.call_id سے مطابقت رکھنی چاہیے۔
حدود
- Five9 کی گائیڈ
BYEپر روٹنگ ڈیٹا کی دستاویز کرتی ہے اورREFERقبول کرنے کا ذکر نہیں کرتی، اس لیے واپس منتقلی اسکرپٹ کے ذریعے کولڈ ٹرانسفر ہے۔ - Five9
X-RouteType،X-RouteValue،X-RouteReasonاورX-CustomMetaDataپڑھتا ہے،User-to-Userنہیں۔ ThunderPhone ہر ہیڈر ویلیو زیادہ سے زیادہ 256 بائٹس طویل بھیجتا ہے۔ - Five9 پیکٹ فریگمینٹیشن سے بچنے کے لیے کسٹم ہیڈرز کو تقریباً دس تک رکھنے کی سفارش کرتا ہے۔