---
title: "Microsoft Dynamics 365 から接続"
description: "Dynamics 365 Contact Center と Copilot Studio の通話を、X ヘッダーを使用して SBC 経由で ThunderPhone エージェントに送信し、HTTP 経由でエージェントの引き継ぎ先を検索します。"
---

Dynamics 365 Contact Center は、会話 ID を含む最大 5 つの X ヘッダーとともに、
セッションボーダーコントローラー（SBC）を介して発信者をエージェントに送ります。
エージェントが完了すると通話を切断し、SBC が発信者を Dynamics 365 に戻した後、
HTTP リクエストノードが引き継ぎ情報を取得します。

## 開始前に

- ThunderPhone エージェントと組織の [API キー](/ja/guides/api-keys)。
- Azure Communication Services の **ダイレクト ルーティング** を通じて、運用中の SBC に接続された
  Dynamics 365 Contact Center の音声チャネル
  （[SBC の要件](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)）:
  パブリック証明書を備えた対応 SBC、ポート 5061 での TLS 1.2、および Microsoft 向けの SRTP。
- **会話を転送**ノードでの **SIP X ヘッダーのサポート**
  （[Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)）。
  環境で利用可能であることを確認してください。

Dynamics 365 は電話番号にのみ転送でき、Microsoft はパスワードではなく証明書で
ダイレクト ルーティングを認証します。SBC は Microsoft と ThunderPhone の間に配置され、
その番号をエージェントの SIP アドレスに変換します。

## 1. SIP エンドポイントを作成する

通話は SBC から ThunderPhone に到達するため、SBC で使用する標準エンドポイントを作成します。

```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 でダイジェスト認証を
使用できない場合は、代わりに `auth` を `ip_allowlist` に設定し、SBC のパブリックアドレスを
指定してエンドポイントを作成します。詳しくは
[送信元 IP で認証するプラットフォーム](/ja/guides/sip-addresses)を参照してください。

## 2. コンテキスト付きで通話を送信する

1. SBC 上で、エージェント用の電話番号を選択します。例: `+14155550188`。
2. SBC で、その番号への通話をエンドポイントの `sip_uri` にルーティングします。たとえば、
   ポート `5061` の TLS 経由で `sip:agent-12-jhxmginwjx@sip.thunderphone.com` に送信します。
   ThunderPhone はユーザー部（`agent-12-jhxmginwjx`）でエンドポイントを特定します。この値は
   リクエスト URI と `To` ヘッダーの両方に含まれている必要があります。X ヘッダーは変更せずに
   そのまま渡します。
3. Copilot Studio で、**外部電話番号への転送**を使用する **会話を転送**ノードを追加し、
   その番号と X ヘッダーを追加します。
   - `X-Call-ID`: Dynamics 365 の会話 ID。Microsoft のヘッダーには含まれないため、
     ここで追加します。ThunderPhone はこれを通話の `external_call_id` として保存します。
     会話 ID を保持する変数を Copilot Studio で確認してください。
   - `X-Customer-Tier` など、さらに最大 4 つ。

Microsoft は最大 5 つの X ヘッダーを送信します。名前は最大 64 文字、値は最大 256 文字で、
使用できる文字は英字、数字、および `= ; . ! % * _ + ~ -` です。プレフィックスは小文字の
`x-` で書き込まれます。ThunderPhone はヘッダー名を大文字と小文字を区別せずに照合するため、
`x-customer-tier` は `{{sip_x_customer_tier}}` としてプロンプトに渡されます。

代わりに Azure Communication Services Call Automation で通話を構築する場合、`AddSipX` は
デフォルトで `X-MS-Custom-` の名前を書き込みます。`X-Call-ID` の名前を維持するには
`SipHeaderPrefix.X` を渡します
（[カスタムコンテキスト](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)）。

## 3. 通話を戻す

エージェントが通話を戻します。別れの挨拶をして通話を終了します。次の転送番号を追加します（[転送番号を追加する](/ja/guides/contact-centers/overview)を参照）。

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

発信者をDynamics 365に戻す処理は、SBCが担当します。Microsoftでは、コンテキスト付き通話を受信する方法の1つとして、Dynamics 365に登録された番号へのSBC経由の新しい通話と、**ワークストリーム → 詳細設定**で設定したコンテキスト変数と一致するキーを持つUUIを説明しています（[サードパーティ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 要求**ノードで引き継ぎ情報を取得します。

- 会話IDを末尾に追加した`GET https://api.thunderphone.com/v1/calls/handoff?external_call_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`ヘッダーにエンドポイントのユーザー部分が含まれていません。

## 制限

- SBCが必要です。MicrosoftはSIPアドレスへの発信やダイジェストチャレンジへの応答を行えません。
- Microsoftが送信するXヘッダーは最大5個で、着信通話では最初の5個だけが保持されます。Dynamics 365で使用できるUUIは最大128文字です。
- Microsoftでは`BYE`のヘッダーを読み取る方法が文書化されていないため、引き継ぎ情報は検索によってのみ取得できます。
