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

Contact centers

从 Zoom Contact Center 连接

通过第三方语音机器人连接器将 Zoom Contact Center 通话转接至 ThunderPhone 智能体,并通过 SIP REFER 将其转回人工坐席。

Zoom Contact Center 流程中的 Bot 小组件会使用 Zoom 的通话 sid 将来电者转接给智能体。当来电者需要人工服务时,智能体会向 Zoom 的人工坐席地址发送 SIP REFER,然后您的流程会通过通话 sid 获取转接信息。

开始前

  • 一个 ThunderPhone 智能体和一个组织API 密钥。
  • 一个由您的管理员管理并向 Contact Center 提供的 Zoom Marketplace 通用应用,其中包含用于 Bot 小组件的连接器 (Zoom 的第三方语音机器人指南)。
  • 从 Zoom 到机器人提供商的 SIP 中继。Zoom 的 ISV 团队会分阶段构建它(需求确认、预发布中继,然后是生产环境),并且应用的公司名称必须与中继记录完全一致。此设置需要由 ThunderPhone 支持团队和 Zoom 开始配置,而不能仅在您的 Zoom 账户中完成。

1. 创建 SIP 端点

Zoom 的连接器会拨打一个以 999 开头的 15 位号码,而不是 SIP 地址。保存连接器会生成该号码。Zoom 的中继在端口 5061 上使用 TLS 1.2,并使用 SRTP 传输音频;它通过 Zoom 的子网而非密码进行允许列表验证。因此,请创建一个 ip_allowlist 端点,将连接器的号码设为拨入号码,并要求使用 SRTP(请参阅 拨打电话号码的平台):

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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs:由 Zoom 提供的 Zoom SIP 信令子网。每个子网都必须是 /16 或更窄的公共 IPv4 范围(IPv6 为 /48 或更窄)。
  • dial_in_numbers:连接器号码,必须与 Zoom 发送的格式完全一致,不带 +。
  • srtp:required,因为 Zoom 的中继始终使用 SRTP。

Zoom 的地址由其所有客户共享,因此任何拨打该号码的其他 Zoom 客户都会接入您的智能体。该号码由 Zoom 分配;请勿公开发布。

2. 发送带上下文的通话

在您的流程中添加一个 Bot 小组件,并将其绑定到连接器。请让 Zoom 的 ISV 团队将中继指向 sip.thunderphone.com,在端口 5061 上使用 TLS,并在请求 URI 和 To 标头中都使用连接器的号码。该端点拒绝 UDP,因此请确保中继不会回退到 UDP。

Zoom 会发送:

  • X-ZOOM-Call-Sid,存储为通话的 external_call_id。Zoom 自己的数据映射页面未列出它;另一家 AI 提供商的 Zoom 集成文档中提到了它,因此请在首次测试通话时检查。
  • X-ZOOM-DNIS,即来电者拨打的号码,存储为 {{sip_x_zoom_dnis}}。
  • X-ZOOM-WEBHOOK,即连接器的静态 URL。

3. 获取通话交接

智能体会向 Zoom 的 SBC 上的人工坐席地址发送 REFER。添加此转接号码(请参阅 添加转接号码),并使用 Zoom 向您提供的 SBC 地址:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Zoom 的指南介绍了机器人传递上下文的两种方式:在 REFER 之前向连接器的静态 URL 发送 POST(voicebot_metadata 和类似事件),以及映射到 来自 Bot 的入站 下的 SIP 标头。ThunderPhone 不会向静态 URL 发送 POST。Zoom 的指南未说明它是否会读取 REFER 中映射的标头;如果您想尝试,请在条目中添加 headers,例如 "X-Handoff-Id": "{{handoff_id}}",并通过测试通话进行检查。还请向 Zoom 确认,它是否接受此前没有元数据 POST 的 REFER。

如需在不依赖上述任一方式的情况下获取交接信息,请让您的流程在 Bot 小组件之后使用 HTTP Call 或 Script 小组件进行查询:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= 后接通话 SID。
  • 标头 Authorization: Bearer sk_live_…。
  • 使用 handoff.summary 和 handoff.intent 对来电者进行路由,并向接听通话的人员说明情况。

Zoom 未发布这些小组件的字段级文档,因此请在您的账户中确认该小组件可以发送 Authorization 标头。请参阅 查询已交接的通话。

测试

呼叫可到达 Bot 小组件的号码,请智能体转接人工坐席,并确认来电者可到达人工坐席且小组件会返回交接信息。然后使用 GET /v1/calls/{call_id} 打开通话:sip_headers 应列出 x-zoom-call-sid,且 external_call_id 应与您的流程使用的通话 SID 一致。

限制

  • ThunderPhone 不会向连接器的静态 URL 发送 POST,因此 Zoom 通过查询获取交接信息,或者在您的测试表明 Zoom 会从 REFER 读取映射标头时通过映射标头获取。
  • 中继线路由 Zoom 的 ISV 团队构建,因此您无法自行设置或测试。