Open in
从 Microsoft Dynamics 365 连接
通过您的 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 密钥。
- Dynamics 365 Contact Center 语音渠道,通过 Azure Communication Services 的 直接路由 连接到您运行的 SBC (SBC 要求): 支持的、具有公有证书的 SBC,在端口 5061 上使用 TLS 1.2,并面向 Microsoft 使用 SRTP。
- SIP X-header 支持,位于 转接对话 节点中 (Copilot Studio)。 请确认您的环境中提供此功能。
Dynamics 365 仅能转接到电话号码,而 Microsoft 通过证书而非密码对直接路由进行身份验证。您的 SBC 位于 Microsoft 和 ThunderPhone 之间,并将该号码转换为智能体的 SIP 地址。
1. 创建 SIP 端点
通话会从您的 SBC 到达 ThunderPhone,因此请创建一个供 SBC 使用的标准端点:
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 进行身份验证的平台。
2. 发送包含上下文的通话
- 在您的 SBC 上为智能体选择一个电话号码,例如
+14155550188。 - 在 SBC 上,将发往该号码的通话路由到端点的
sip_uri,例如通过端口5061上的 TLS 路由到sip:agent-12-jhxmginwjx@sip.thunderphone.com。ThunderPhone 通过用户部分 (agent-12-jhxmginwjx)查找端点,该部分必须同时出现在请求 URI 和Toheader 中。请原样传递 X-header。 - 在 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 保持其名称
(自定义上下文)。
3. 让通话返回
智能体会返回通话:它会道别并挂断。添加此转接号码(请参阅 添加转接号码):
{"name": "Dynamics 365", "action": "return"}将来电者带回 Dynamics 365 是您的 SBC 的职责。Microsoft
记录了一种携带上下文接入通话的方式:通过 SBC 向 Dynamics 365 中注册的号码发起新通话,并携带 UUI,其键与您在 工作流 → 高级设置
中设置的上下文变量相匹配
(第三方 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。
请参阅查询已交接的通话。
测试
呼叫可到达转接节点的 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上的请求头,因此交接信息只能通过查询返回。