Open in
Microsoft Dynamics 365 থেকে সংযোগ করুন
X-headers ব্যবহার করে আপনার SBC-এর মাধ্যমে Dynamics 365 Contact Center এবং Copilot Studio-এর কল ThunderPhone এজেন্টে পাঠান এবং HTTP-এর মাধ্যমে এজেন্টের হ্যান্ড-অফ খুঁজে নিন।
Dynamics 365 Contact Center আপনার সেশন বর্ডার কন্ট্রোলার (SBC)-এর মাধ্যমে কলারকে এজেন্টের কাছে পাঠায়, যেখানে কথোপকথন আইডিসহ সর্বোচ্চ পাঁচটি X-header থাকতে পারে। এজেন্টের কাজ শেষ হলে এটি কলটি শেষ করে, আপনার SBC কলারকে Dynamics 365-এ ফিরিয়ে আনে এবং একটি HTTP Request নোড হ্যান্ড-অফটি নিয়ে আসে।
শুরু করার আগে
- একটি ThunderPhone এজেন্ট এবং একটি সংগঠনের API key।
- Dynamics 365 Contact Center ভয়েস চ্যানেল, যা আপনার পরিচালিত একটি SBC-তে Azure Communication Services ডাইরেক্ট রাউটিং-এর মাধ্যমে সংযুক্ত (SBC-এর প্রয়োজনীয়তা): একটি সমর্থিত SBC যাতে একটি পাবলিক সার্টিফিকেট, পোর্ট 5061-এ TLS 1.2 এবং Microsoft-এর দিকে SRTP রয়েছে।
- SIP X-header সমর্থন কথোপকথন স্থানান্তর নোডে (Copilot Studio)। নিশ্চিত করুন যে এটি আপনার পরিবেশে উপলভ্য।
Dynamics 365 শুধুমাত্র একটি ফোন নম্বরে ট্রান্সফার করে, এবং Microsoft পাসওয়ার্ড দিয়ে নয়, সার্টিফিকেট দিয়ে ডাইরেক্ট রাউটিং প্রমাণীকরণ করে। আপনার SBC Microsoft ও ThunderPhone-এর মাঝখানে থাকে এবং সেই নম্বরটিকে এজেন্টের SIP ঠিকানায় রূপান্তর করে।
1. SIP endpoint তৈরি করুন
কলটি আপনার SBC থেকে ThunderPhone-এ পৌঁছায়, তাই SBC ব্যবহারের জন্য একটি সাধারণ endpoint তৈরি করুন:
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": "Dynamics 365 SBC"}'উত্তর থেকে password সঙ্গে সঙ্গে সংরক্ষণ করুন; এটি একবার দেখানো হয় এবং আপনার SBC এটি ব্যবহার করে ThunderPhone-এর চ্যালেঞ্জের উত্তর দেয়। আপনার SBC যদি digest authentication করতে না পারে, তাহলে auth-কে ip_allowlist সেট করে এবং তার পরিবর্তে আপনার SBC-এর পাবলিক ঠিকানা দিয়ে endpoint তৈরি করুন; দেখুন
উৎস IP দিয়ে প্রমাণীকরণ করা প্ল্যাটফর্ম।
2. প্রসঙ্গসহ কল পাঠান
- আপনার SBC-তে এজেন্টের জন্য একটি ফোন নম্বর বেছে নিন, যেমন
+14155550188। - SBC-তে, সেই নম্বরে আসা কলগুলো endpoint-এর
sip_uri-এ রাউট করুন, উদাহরণস্বরূপsip:agent-12-jhxmginwjx@sip.thunderphone.com, পোর্ট5061-এ TLS-এর মাধ্যমে। ThunderPhone user part (agent-12-jhxmginwjx) দিয়ে endpoint খুঁজে পায়, যা request URI এবংToheader—উভয়টিতেই থাকতে হবে। X-headerগুলো অপরিবর্তিতভাবে পাঠান। - Copilot Studio-তে, সেই নম্বরে বাহ্যিক ফোন নম্বর ট্রান্সফার সহ একটি কথোপকথন স্থানান্তর নোড যোগ করুন এবং X-headerগুলো যোগ করুন:
X-Call-ID: Dynamics 365 কথোপকথন আইডি। কোনো Microsoft header এটি বহন করে না, তাই এখানে এটি যোগ করুন; ThunderPhone এটিকে কলেরexternal_call_idহিসেবে সংরক্ষণ করে। কথোপকথন আইডি কোন ভেরিয়েবলে থাকে তা Copilot Studio-তে নিশ্চিত করুন।- আরও সর্বোচ্চ চারটি, যেমন
X-Customer-Tier।
Microsoft সর্বোচ্চ পাঁচটি X-header পাঠায়, যেখানে নামের দৈর্ঘ্য সর্বোচ্চ 64 অক্ষর এবং মানের দৈর্ঘ্য সর্বোচ্চ 256, এবং এতে অক্ষর, সংখ্যা ও = ; . ! % * _ + ~ - ব্যবহার করা যায়। এটি prefix-টি ছোট হাতের x- হিসেবে লেখে; ThunderPhone case উপেক্ষা করে header নাম মিলিয়ে দেখে, তাই x-customer-tier prompt-এ {{sip_x_customer_tier}} হিসেবে পৌঁছায়।
আপনি যদি পরিবর্তে Azure Communication Services Call Automation দিয়ে কল তৈরি করেন, AddSipX ডিফল্টভাবে X-MS-Custom- নাম লেখে। SipHeaderPrefix.X পাঠান যাতে X-Call-ID তার নাম বজায় রাখে
(কাস্টম প্রসঙ্গ)।
3. কলটি ফেরত পান
এজেন্ট কলটি ফেরত দেয়: এটি বিদায় জানায় এবং কল কেটে দেয়। এই ট্রান্সফার নম্বরটি যোগ করুন (দেখুন ট্রান্সফার নম্বর যোগ করুন):
{"name": "Dynamics 365", "action": "return"}কলারকে আবার Dynamics 365-এ ফিরিয়ে আনা আপনার SBC-এর কাজ। Microsoft
প্রসঙ্গসহ কলে প্রবেশের একটি পদ্ধতি নথিভুক্ত করেছে: SBC-এর মাধ্যমে Dynamics 365-এ
নিবন্ধিত একটি নম্বরে নতুন কল, যেখানে UUI-এর কীগুলো আপনার
Workstreams → Advanced settings-এ সেট আপ করা প্রসঙ্গ ভেরিয়েবলের সঙ্গে মেলে
(তৃতীয় পক্ষের IVR ট্রান্সফার)।
ThunderPhone কল কেটে দিলে কলার কীভাবে সেই নম্বরে পৌঁছাবে, তা আপনার SBC
বিক্রেতার সঙ্গে নির্ধারণ করুন এবং X-Call-ID-এ পাঠানো কথোপকথনের id বহন করুন,
যাতে ফ্লো কলটি খুঁজে পায়।
তারপর Copilot Studio-এর একটি HTTP Request নোড দিয়ে হ্যান্ড-অফটি আনুন:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=এর পরে কথোপকথনের id দিন।- হেডার
Authorization: Bearer sk_live_…। - প্রতিক্রিয়াটি একটি ভেরিয়েবলে পার্স করুন এবং
handoff.summaryওhandoff.intentব্যবহার করুন।
দেখুন হ্যান্ড-অফ করা কল খুঁজুন।
এটি পরীক্ষা করুন
ট্রান্সফার নোডে পৌঁছায় এমন একটি Dynamics 365 নম্বরে কল করুন, এজেন্টকে একজন
মানুষের জন্য বলুন, এবং কলার আবার Dynamics 365-এ ফিরে আসে কি না যাচাই করুন।
তারপর GET /v1/calls/{call_id} দিয়ে কলটি খুলুন: sip_headers-এ x-call-id
থাকা উচিত এবং external_call_id কথোপকথনের id হওয়া উচিত। কলটি কখনও এজেন্টের
কাছে না পৌঁছালে এবং আপনার SBC লগে SIP 404 দেখা গেলে, এর অনুরোধ URI বা To
হেডারে এন্ডপয়েন্টের user অংশ নেই।
সীমাবদ্ধতা
- একটি SBC প্রয়োজন। Microsoft SIP ঠিকানায় ডায়াল করতে বা digest challenge-এর উত্তর দিতে পারে না।
- Microsoft সর্বোচ্চ পাঁচটি X-header পাঠায় এবং ইনকামিং কলে শুধু প্রথম পাঁচটি রাখে। Dynamics 365 সর্বোচ্চ 128 অক্ষরের UUI গ্রহণ করে।
- Microsoft
BYE-এ হেডার পড়ার বিষয়টি নথিভুক্ত করেনি, তাই হ্যান্ড-অফটি শুধু লুকআপের মাধ্যমেই ফিরে আসে।