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

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

## 开始前

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

## 1. 创建 SIP 端点

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

```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": "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`。添加此转接号码（请参阅
[添加转接号码](/zh/guides/contact-centers/overview)），并使用 Zoom 向您提供的 SBC 地址：

```json
{"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` 标头。请参阅
[查询已交接的通话](/api-reference/calls#look-up-a-handed-off-call)。

## 测试

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

## 限制

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