ThunderPhone v3 已正式上线。全程自助,低至2美分/分钟。查看发布公告

Contact centers

从 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. 发送包含上下文的通话

  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 保持其名称 (自定义上下文)。

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 上的请求头,因此交接信息只能通过查询返回。