---
title: "從 Genesys Cloud 連接"
description: "透過 BYOC Cloud 中繼線，將 Genesys Cloud 通話連同對話 ID 及 UUI 傳送至 ThunderPhone 智能體，並透過 UUI 中的轉交資訊將通話轉回。"
---

你的 Architect 流程會透過 BYOC Cloud 中繼線，將來電者連同對話 ID 及你設定的任何 UUI 傳送至智能體。當來電者需要真人協助時，智能體會發送 SIP `REFER`，Genesys 會取回通話，而交接 ID 會在通話的 UUI 中送達。

## 開始前

- ThunderPhone 智能體及組織的 [API 金鑰](/yue/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`，編碼為十六進位。
  - **取回及轉接**，讓 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。加入此轉接號碼（請參閱
[加入轉接號碼](/yue/guides/contact-centers/overview)
及[轉接地址內的標頭](/yue/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（如顯示十六進位數字，請確認中繼的 UUI 編碼設為 Hex）。然後使用 `GET /v1/calls/{call_id}` 開啟通話：`external_call_id` 應為對話 ID。

## 限制

- **取得 SIP 標頭**動作只會讀取初始 `INVITE`，因此無法讀取智能體 `REFER` 中的任何內容。交接只會透過 UUI 傳送至 Genesys。
- 當通話包含多於一個 UUI 標頭時，Genesys 會捨棄所有 UUI。
- 轉接位址限制為 254 個字元，因此較長的 UUI 會被截斷以符合限制。交接 ID 必定能夠容納。
