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

Zoom Contact Center 流程中的 Bot 小工具會使用 Zoom 的通話 SID，將來電者轉接至智能體。當來電者需要真人協助時，智能體會向 Zoom 的人工客服地址發送 SIP `REFER`，而你的流程會透過通話 SID 擷取轉接資料。

## 開始之前

- 一個 ThunderPhone 智能體及機構的 [API 金鑰](/yue/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（請參閱
[撥打電話號碼的平台](/yue/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
地址新增此轉接號碼（請參閱
[新增轉接號碼](/yue/guides/contact-centers/overview)）：

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

Zoom 的指南說明機械人可透過兩種方式傳遞內容：在 `REFER` 之前向連接器的靜態 URL
發送 `POST`（`voicebot_metadata` 及類似事件），以及映射至 **由 Bot 傳入** 的 SIP
標頭。ThunderPhone 不會向靜態 URL 發送資料。Zoom 的指南沒有說明它是否會從
`REFER` 讀取已映射的標頭；如想嘗試，請在項目中加入例如
`"X-Handoff-Id": "{{handoff_id}}"` 的 `headers`，並在測試通話中檢查。同時向 Zoom
確認，它是否接受在沒有事前中繼資料 `POST` 的情況下發送 `REFER`。

如要在不依賴上述任何一種方式下取得轉交資料，請在 Bot 小工具之後使用 **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)。

## 測試

致電可到達 Bot 小工具的號碼，要求語音智能體轉接至真人，並確認來電者可接通真人客服，
而小工具會傳回轉交資料。然後使用 `GET /v1/calls/{call_id}` 開啟該通話：
`sip_headers` 應列出 `x-zoom-call-sid`，而 `external_call_id` 應與你的流程使用的
通話 SID 相符。

## 限制

- ThunderPhone 不會向連接器的靜態 URL 發送資料，因此 Zoom 會透過查詢取得轉交資料，
  或在測試確認 Zoom 可從 `REFER` 讀取標頭時，透過已映射的標頭取得資料。
- SIP 中繼線由 Zoom 的 ISV 團隊建立，因此你無法自行設定或測試。
