---
title: "從 Zoom Contact Center 連線"
description: "使用第三方語音機器人連接器，將 Zoom Contact Center 通話轉接至 ThunderPhone 智慧體，並透過 SIP REFER 將通話轉回真人智慧體。"
---

Zoom Contact Center 流程中的 Bot 小工具會使用 Zoom 的通話 sid，將來電者傳送至語音智慧體。當來電者需要真人服務人員時，智慧體會向 Zoom 的真人服務人員位址傳送 SIP `REFER`，而你的流程會依通話 sid 擷取轉接資訊。

## 開始前準備

- 一個 ThunderPhone 智慧體和組織的 [API 金鑰](/zh-Hant/guides/api-keys)。
- 一個 Zoom Marketplace **一般應用程式**，由你的管理員管理並提供給 Contact Center 使用，且具有 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-Hant/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`。使用 Zoom
提供給你的 SBC 位址新增此轉接號碼（請參閱
[新增轉接號碼](/zh-Hant/guides/contact-centers/overview)）：

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

Zoom 的指南說明機器人傳遞情境資訊的兩種方式：在 `REFER` 之前向連接器的
Static URL 傳送 `POST`（`voicebot_metadata` 和類似事件），以及對應至
**從 Bot 傳入**之下的 SIP 標頭。ThunderPhone 不會向 Static URL 傳送資料。
Zoom 的指南未說明它是否會讀取來自 `REFER` 的對應標頭；如果你想嘗試，請在
項目中新增 `headers`，例如 `"X-Handoff-Id": "{{handoff_id}}"`，並透過測試
通話檢查。此外，請向 Zoom 確認它是否接受在此前沒有中繼資料 `POST` 的
`REFER`。

若要在不依賴任一方式的情況下取得交接資訊，請讓你的流程在機器人小工具之後，
使用 **HTTP 呼叫** 或 **指令碼** 小工具查詢：

- `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)。

## 測試

撥打可連至機器人小工具的號碼，要求智慧體轉接真人，並確認來電者能接通真人接聽
人員，且小工具會傳回交接資訊。接著使用 `GET /v1/calls/{call_id}` 開啟通話：
`sip_headers` 應列出 `x-zoom-call-sid`，且 `external_call_id` 應與你的流程
使用的通話 sid 相符。

## 限制

- ThunderPhone 不會向連接器的 Static URL 傳送資料，因此 Zoom 會透過查詢取得
  交接資訊，或是在你的測試顯示 Zoom 會從 `REFER` 讀取對應標頭時，透過對應標頭取得。
- 此中繼線路由 Zoom 的 ISV 團隊建立，因此你無法自行設定或測試。
