---
title: "從 Five9 連線"
description: "透過 AI Agent Connect 將 Five9 通話經由 SIP 傳送至 ThunderPhone 智慧體，並透過 IVR 指令碼可讀取的路由標頭將通話傳回。"
---

你的 Five9 IVR 指令碼會連同 Five9 的通話詳細資料，將來電者轉接至智慧體。智慧體完成後，會在 SIP `BYE` 上附帶路由標頭掛斷；指令碼會將其讀入通話變數，以路由來電者。

## 開始前

- 一個 ThunderPhone 智慧體和一個組織的 [API 金鑰](/zh-Hant/guides/api-keys)。
- Five9 的 **AI 智慧體連線**附加元件。Five9 將此功能限制於其已認可的 AI 供應商，並由 Five9 的導入團隊進行設定：他們會匯入供應商的 IVR 指令碼範本、建立通話變數，並將指令碼的 **第三方轉接**模組指向該供應商。ThunderPhone 尚未列於 Five9 的認可清單中：請先洽詢你的 Five9 客戶團隊或 ThunderPhone 支援團隊，再據此規劃。

## 1. 建立 SIP 端點

Five9 的第三方轉接模組會撥打電話號碼，而非 SIP 位址；其他供應商的 Five9 整合則是依來源位址而非密碼驗證 Five9。因此，請建立一個 `ip_allowlist` 端點，並將 Five9 要撥打的號碼設為撥入號碼（請參閱
[撥打電話號碼的平台](/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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`：Five9 提供的 Five9 資料中心 SIP 訊號範圍。每個範圍都必須是 `/16` 或更小的公用 IPv4 範圍（IPv6 則為 `/48` 或更小）。
- `dial_in_numbers`：Five9 指令碼將撥打的號碼，請依 Five9 傳送該號碼的格式填寫。它不必是真實電話號碼。它不得已在 ThunderPhone 上使用，無論是作為電話號碼或其他端點上的號碼：否則會傳回 `409`。

Five9 的位址由所有客戶共用，因此任何撥打該號碼的其他 Five9 客戶都會連線至你的智慧體。你可自行選擇該號碼時，請選擇一個不易被猜到的長號碼（最多 15 位數），確認 Five9 會將它傳送至 ThunderPhone，而非撥出至電話網路，並且不要公開它。

## 2. 傳送含有情境資訊的通話

請 Five9 的導入團隊執行以下操作：

- 從 **第三方轉接**模組將通話傳送至
  `sip:+14155550188@sip.thunderphone.com`，並在請求 URI 與 `To` 標頭中都使用該號碼。此模組會在標頭中使用該號碼及供應商的 SIP 網域。
- 透過 TLS（連接埠 5061）或 TCP（連接埠 5060）傳送。此端點拒絕 UDP，而 Five9 未公開其使用的傳輸方式，因此請確認不是 UDP。
- 啟用 **第三方通話後返回**，讓智慧體掛斷後指令碼能繼續執行（Five9 允許第三方通話最長 3,600 秒）。

Five9 的指南列出其傳送的值（`call.ANI`、`call.DNIS`、
`call.call_id`、`call.session_id`、`call.campaign_name` 等），但未列出其
標頭名稱。其他 AI 供應商的 Five9 整合在傳輸層將它們記錄為
`X-CallANI`、`X-CallDNIS`、`X-CallID`、`X-CallSessionID`、`X-CallCampaign`
和 `X-AgentID`；請在首次測試通話時確認。每個值都會以變數形式傳入提示詞，例如
`{{sip_x_callcampaign}}`。`X-CallID` 會儲存為該通話的
`external_call_id`。

## 3. 將通話交回

智慧體會將通話交回：它會道別並掛斷，而 `BYE` 會帶有 Five9 指令碼讀取的四個標頭。新增此轉接號碼（請參閱
[新增轉接號碼](/zh-Hant/guides/contact-centers/overview)）：

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` 和 `X-RouteValue` 會告訴指令碼要將來電者轉送至何處，此處為 Support 技能。其他供應商針對 `X-RouteType` 文件化的值包括
  `SkillTransfer`、`PhoneTransfer`、`Hangup` 和 `DispositionOnly`；請與維護指令碼的人員確認使用的值。若有多個目的地，請為每個目的地新增一個 return，並設定不同的名稱和 `X-RouteValue`。
- `X-RouteReason` 會帶有智慧體的意圖標籤，例如 `billing_dispute`。
- `X-CustomMetaData` 會帶有交接 ID。`BYE` 也會以
  `X-TP-Handoff-Id` 帶有此 ID，但 Five9 不會讀取它。

Five9 的指令碼會將這四個標頭對應至通話變數。若要取得智慧體的摘要，請讓指令碼透過 IVR **查詢**模組呼叫交接查詢：
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` 後接
`call.call_id`，並使用會傳送
`Authorization: Bearer` 和你的 API 金鑰的授權設定檔。請參閱
[查詢已交接的通話](/api-reference/calls#look-up-a-handed-off-call)。

## 測試

撥打 IVR 指令碼，要求智慧體轉接真人，並確認指令碼會在通話變數已填入的情況下轉送來電者。若通話從未到達智慧體，請確認請求 URI 和 `To` 標頭中的號碼是否與撥入號碼相符、Five9 的來源位址是否位於 `allowed_source_cidrs` 中，以及通話是否透過 TCP 或 TLS 傳入。接著使用
`GET /v1/calls/{call_id}` 開啟通話：`sip_headers` 應列出 `x-callid`，且
`external_call_id` 應與 Five9 中的 `call.call_id` 相符。

## 限制

- Five9 的指南記載在 `BYE` 上傳送路由資料，且未提及接受 `REFER`，因此交回作業是由指令碼執行的冷轉接。
- Five9 讀取 `X-RouteType`、`X-RouteValue`、`X-RouteReason` 和
  `X-CustomMetaData`，而非 `User-to-User`。ThunderPhone 傳送的每個標頭值最長為 256 位元組。
- Five9 建議將自訂標頭維持在約十個，以避免封包碎裂。
