---
title: "從 Genesys Cloud 連線"
description: "透過 BYOC Cloud 中繼將 Genesys Cloud 通話連接至 ThunderPhone 智慧體，並傳送對話 ID 和 UUI，再透過 UUI 中的交接將通話接回。"
---

你的 Architect 流程會透過 BYOC Cloud 中繼線，將來電者連同對話 ID 和你設定的任何 UUI 傳送給智慧體。當來電者需要真人服務時，智慧體會傳送 SIP `REFER`，Genesys 會接回通話，而交接 ID 會出現在通話的 UUI 中。

## 開始前準備

- 一個 ThunderPhone 智慧體和組織的 [API 金鑰](/zh-Hant/guides/api-keys)。
- 已啟用 BYOC Cloud 的 Genesys Cloud，以及已啟用下列設定的外部中繼線（類型為 BYOC Carrier 或 PBX）
  （[外部中繼線設定](https://help.genesys.cloud/articles/external-trunk-settings/)）：
  - **對話標頭**，讓 Genesys 在 `x-inin-cnv` 中傳送其對話 ID。此設定預設為關閉。
  - **UUI 直通**，標頭類型為 `User-To-User`，編碼為 Hex。
  - **接回與轉接**，讓 Genesys 接受智慧體的 `REFER`。

## 1. 建立 SIP 端點

Genesys 會回應摘要驗證挑戰，因此請使用標準端點：

```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": "Genesys Cloud"}'
```

請立即儲存回應中的 `password`；它只會顯示一次。在中繼線上：

| 設定 | 值 |
|---|---|
| SIP 伺服器 | `sip.thunderphone.com`，連接埠 `5061` |
| 通訊協定 | TLS |
| 摘要驗證 | 端點的 `username` 和 `password` |
| 編解碼器 | PCMU、PCMA 或 G.722 |

將中繼線加入你站點的外撥路由，其號碼方案必須涵蓋流程撥打的位址。

## 2. 傳送附帶情境資訊的通話

在你的 Architect 流程中：

1. 你可以選擇新增 **設定 UUI 資料** 動作，為智慧體提供情境資訊，例如 `account=12345`。Genesys 建議不超過 128 個字元。
2. 新增 **轉接至號碼** 動作，並填入端點的 `sip_uri`，例如 `sip:agent-12-jhxmginwjx@sip.thunderphone.com`。

Genesys 會在 `x-inin-cnv` 中傳送對話 ID。ThunderPhone 會將其儲存為通話的 `external_call_id`。UUI 會以解碼後的形式傳入提示詞，作為 `{{sip_uui}}`。

Genesys 中繼線自訂標頭是靜態的，因此請將每通通話的值放入 UUI。Genesys 保留 `x-inin`、`x-genesys`、`x-pcv` 和 `x-gcv` 標頭前綴供自身使用。

## 3. 接回通話

智慧體會使用 `REFER` 轉接至 Genesys 上的位址，且交接 ID 會以十六進位 UUI 的形式包含在該位址中。新增此轉接號碼（請參閱
[新增轉接號碼](/zh-Hant/guides/contact-centers/overview)
和[轉接位址中的標頭](/zh-Hant/guides/call-transfers)）：

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

請將該位址替換為可路由回應接聽來電者的佇列或流程的位址，並向 Genesys 確認其格式。`REFER` 如下所示：

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

啟用 **接回與轉接** 後，Genesys 會從中繼線接回通話，並將其路由至該位址。Genesys 文件指出傳入的 UUI 會存入 `Call.UUIData`；文件未說明接回通話是否同樣如此，因此請向 Genesys 確認，或透過測試通話確認接聽來電者的流程能在該處找到交接 ID。若要取得摘要和意圖，請在 Web Services Data Actions 整合上使用 **通話資料動作** 呼叫交接查詢：

- 請求：`GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  後接 `Call.UUIData` 中的 ID。
- 憑證：你的 API 金鑰，以 `Authorization: Bearer sk_live_…` 傳送。
- 輸出：將 `handoff.summary` 和 `handoff.intent` 對應至流程變數。

請參閱[查詢已交接的通話](/api-reference/calls#look-up-a-handed-off-call)。

## 測試

撥打可進入此流程的號碼，向智慧體要求轉接給某人，並確認
Genesys 將通話轉至你設定的位址。在該流程中，確認
`Call.UUIData` 以文字形式保存交接 ID（若顯示十六進位數字，請確認 trunk 的 UUI 編碼為 Hex）。接著使用 `GET /v1/calls/{call_id}` 開啟通話：
`external_call_id` 應為對話 ID。

## 限制

- **取得 SIP 標頭** 動作僅讀取初始的 `INVITE`，因此無法
  讀取智慧體 `REFER` 中的任何內容。交接僅會透過 UUI 傳送至 Genesys。
- 當通話包含多個 UUI 標頭時，Genesys 會捨棄所有 UUI。
- 轉接位址最長保留 254 個字元，因此過長的 UUI 會遭截斷以符合限制。
  交接 ID 一律可完整容納。
