---
title: "从 Microsoft Dynamics 365 连接"
description: "通过您的 SBC 和 X 标头将 Dynamics 365 Contact Center 和 Copilot Studio 通话发送至 ThunderPhone 智能体，并通过 HTTP 查找智能体的转接信息。"
---

Dynamics 365 Contact Center 通过您的会话边界控制器（SBC）将来电者转接给智能体，并可附带最多五个 X-header，其中包括会话 ID。智能体完成后会挂断，您的 SBC 将来电者带回 Dynamics 365，随后 HTTP Request 节点会获取转接信息。

## 开始前

- 一个 ThunderPhone 智能体和一个组织 [API 密钥](/zh/guides/api-keys)。
- Dynamics 365 Contact Center 语音渠道，通过 Azure Communication Services 的 **直接路由** 连接到您运行的 SBC
  （[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 端点

通话会从您的 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 进行身份验证的平台](/zh/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` header 中。请原样传递 X-header。
3. 在 Copilot Studio 中，添加一个使用 **外部电话号码转接** 的 **转接对话** 节点，并添加以下 X-header：
   - `X-Call-ID`：Dynamics 365 会话 ID。Microsoft 没有任何 header 携带该值，因此请在此处添加；ThunderPhone 会将其存储为通话的
     `external_call_id`。请在 Copilot Studio 中确认哪个变量包含会话 ID。
   - 最多再添加四个，例如 `X-Customer-Tier`。

Microsoft 最多发送五个 X-header，名称最长为 64 个字符，值最长为 256 个字符，可使用字母、数字和 `= ; . ! % * _ + ~ -`。它会将前缀写为小写 `x-`；ThunderPhone 在匹配 header 名称时忽略大小写，因此 `x-customer-tier` 会以 `{{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. 让通话返回

智能体会返回通话：它会道别并挂断。添加此转接号码（请参阅
[添加转接号码](/zh/guides/contact-centers/overview)）：

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

将来电者带回 Dynamics 365 是您的 SBC 的职责。Microsoft
记录了一种携带上下文接入通话的方式：通过 SBC 向 Dynamics 365 中注册的号码发起新通话，并携带 UUI，其键与您在 **工作流 → 高级设置**
中设置的上下文变量相匹配
（[第三方 IVR 转接](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)）。
请与您的 SBC 供应商确定 ThunderPhone 挂断后，来电者如何到达该号码，并传递您在 `X-Call-ID`
中发送的会话 ID，以便流程能够找到该通话。

然后使用 Copilot Studio **HTTP 请求**节点获取交接信息：

- `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` 请求头未携带端点的用户部分。

## 限制

- 必须使用 SBC。Microsoft 无法拨打 SIP 地址，也无法响应摘要认证质询。
- Microsoft 最多发送五个 X-Header，并且仅保留传入通话中的前五个。Dynamics 365 最多接受 128 个字符的 UUI。
- Microsoft 未记录如何读取 `BYE` 上的请求头，因此交接信息只能通过查询返回。
