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 সিগন্যালিং রেঞ্জ। প্রতিটিই/16বা তার চেয়ে সংকীর্ণ একটি পাবলিক IPv4 রেঞ্জ হতে হবে (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 ইন্টিগ্রেশন এগুলো নেটওয়ার্কে
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স্ক্রিপ্টকে কলারকে কোথায় পাঠাতে হবে তা জানায়, এখানে Support স্কিলে। অন্যান্য প্রোভাইডারX-RouteType-এর জন্য যে মানগুলো নথিভুক্ত করে, সেগুলোর মধ্যে রয়েছেSkillTransfer,PhoneTransfer,HangupএবংDispositionOnly; স্ক্রিপ্ট রক্ষণাবেক্ষণকারী ব্যক্তির সঙ্গে মানগুলো ঠিক করে নিন। একাধিক গন্তব্যের জন্য, ভিন্ন নাম এবংX-RouteValueসহ প্রতিটি গন্তব্যের জন্য একটি করে return যোগ করুন।X-RouteReasonএজেন্টের intent লেবেল বহন করে, যেমনbilling_dispute।X-CustomMetaDatahand-off id বহন করে।BYEএটিX-TP-Handoff-Idহিসেবেও বহন করে, যা Five9 পড়ে না।
Five9-এর স্ক্রিপ্ট চারটি হেডারকে কল ভেরিয়েবলে ম্যাপ করে। এজেন্টের সারাংশের জন্য, স্ক্রিপ্টকে একটি IVR কোয়েরি মডিউল দিয়ে hand-off lookup কল করান:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=-এর পরে
call.call_id, এবং এমন একটি Authorization Profile ব্যবহার করুন যা
Authorization: Bearer ও আপনার API key পাঠায়। দেখুন
হ্যান্ড-অফ করা কল খুঁজুন।
এটি পরীক্ষা করুন
IVR স্ক্রিপ্টে কল করুন, এজেন্টকে একজন ব্যক্তির জন্য অনুরোধ করুন, এবং কল ভেরিয়েবল পূরণ করে স্ক্রিপ্ট কলারকে রাউট করছে কি না পরীক্ষা করুন। কলটি কখনও এজেন্টের কাছে না পৌঁছালে, request URI এবং To হেডারের নম্বরটি dial-in নম্বরের সঙ্গে মেলে কি না, Five9-এর source address allowed_source_cidrs-এ আছে কি না, এবং কলটি TCP বা TLS-এর মাধ্যমে এসেছে কি না পরীক্ষা করুন। এরপর GET /v1/calls/{call_id} দিয়ে কলটি খুলুন: sip_headers-এ x-callid তালিকাভুক্ত থাকা উচিত, এবং external_call_id Five9-এর call.call_id-এর সঙ্গে মিলতে হবে।
সীমাবদ্ধতা
- Five9-এর গাইডে
BYE-তে routing data নথিভুক্ত আছে এবংREFERগ্রহণের উল্লেখ নেই, তাই hand-back হলো স্ক্রিপ্টের মাধ্যমে একটি cold transfer। - Five9
User-to-Userনয়,X-RouteType,X-RouteValue,X-RouteReasonএবংX-CustomMetaDataপড়ে। ThunderPhone প্রতিটি হেডার মান সর্বোচ্চ 256 bytes দীর্ঘ পাঠায়। - Packet fragmentation এড়াতে Five9 কাস্টম হেডার প্রায় দশটির মধ্যে সীমিত রাখার পরামর্শ দেয়।