---
title: "Microsoft Dynamics 365 থেকে সংযোগ করুন"
description: "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](/bn/guides/api-keys)।
- Dynamics 365 Contact Center ভয়েস চ্যানেল, যা আপনার পরিচালিত একটি SBC-তে Azure Communication Services **ডাইরেক্ট রাউটিং**-এর মাধ্যমে সংযুক্ত
  ([SBC-এর প্রয়োজনীয়তা](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  একটি সমর্থিত SBC যাতে একটি পাবলিক সার্টিফিকেট, পোর্ট 5061-এ TLS 1.2 এবং Microsoft-এর দিকে SRTP রয়েছে।
- **SIP X-header সমর্থন** **কথোপকথন স্থানান্তর** নোডে
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header))।
  নিশ্চিত করুন যে এটি আপনার পরিবেশে উপলভ্য।

Dynamics 365 শুধুমাত্র একটি ফোন নম্বরে ট্রান্সফার করে, এবং Microsoft পাসওয়ার্ড দিয়ে নয়, সার্টিফিকেট দিয়ে ডাইরেক্ট রাউটিং প্রমাণীকরণ করে। আপনার SBC Microsoft ও ThunderPhone-এর মাঝখানে থাকে এবং সেই নম্বরটিকে এজেন্টের SIP ঠিকানায় রূপান্তর করে।

## 1. SIP endpoint তৈরি করুন

কলটি আপনার SBC থেকে ThunderPhone-এ পৌঁছায়, তাই SBC ব্যবহারের জন্য একটি সাধারণ endpoint তৈরি করুন:

```bash
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 দিয়ে প্রমাণীকরণ করা প্ল্যাটফর্ম](/bn/guides/sip-addresses)।

## 2. প্রসঙ্গসহ কল পাঠান

1. আপনার SBC-তে এজেন্টের জন্য একটি ফোন নম্বর বেছে নিন, যেমন `+14155550188`।
2. SBC-তে, সেই নম্বরে আসা কলগুলো endpoint-এর `sip_uri`-এ রাউট করুন, উদাহরণস্বরূপ `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, পোর্ট `5061`-এ TLS-এর মাধ্যমে। ThunderPhone user part
   (`agent-12-jhxmginwjx`) দিয়ে endpoint খুঁজে পায়, যা request URI এবং
   `To` header—উভয়টিতেই থাকতে হবে। X-headerগুলো অপরিবর্তিতভাবে পাঠান।
3. 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` তার নাম বজায় রাখে
([কাস্টম প্রসঙ্গ](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context))।

## 3. কলটি ফেরত পান

এজেন্ট কলটি ফেরত দেয়: এটি বিদায় জানায় এবং কল কেটে দেয়। এই ট্রান্সফার
নম্বরটি যোগ করুন (দেখুন
[ট্রান্সফার নম্বর যোগ করুন](/bn/guides/contact-centers/overview)):

```json
{"name": "Dynamics 365", "action": "return"}
```

কলারকে আবার Dynamics 365-এ ফিরিয়ে আনা আপনার SBC-এর কাজ। Microsoft
প্রসঙ্গসহ কলে প্রবেশের একটি পদ্ধতি নথিভুক্ত করেছে: SBC-এর মাধ্যমে Dynamics 365-এ
নিবন্ধিত একটি নম্বরে নতুন কল, যেখানে UUI-এর কীগুলো আপনার
**Workstreams → Advanced settings**-এ সেট আপ করা প্রসঙ্গ ভেরিয়েবলের সঙ্গে মেলে
([তৃতীয় পক্ষের IVR ট্রান্সফার](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-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` ব্যবহার করুন।

দেখুন [হ্যান্ড-অফ করা কল খুঁজুন](/api-reference/calls#look-up-a-handed-off-call)।

## এটি পরীক্ষা করুন

ট্রান্সফার নোডে পৌঁছায় এমন একটি 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`-এ হেডার পড়ার বিষয়টি নথিভুক্ত করেনি, তাই হ্যান্ড-অফটি শুধু
  লুকআপের মাধ্যমেই ফিরে আসে।
