---
title: "聯絡中心"
description: "透過 SIP 將 Amazon Connect、Five9、Genesys Cloud、Talkdesk、Twilio、Microsoft Dynamics 365、NICE CXone 或 Zoom Contact Center 的來電轉接至 ThunderPhone 智能體，並在智能體轉接後接回通話。"
---

ThunderPhone 智能體可在你的聯絡中心通話流程中接聽來電。
你的平台會將通話連同 SIP 標頭傳送至智能體的 [SIP 位址](/yue/guides/sip-addresses)，
標頭會攜帶平台本身的通話 ID，以及所有已知的來電者資料。當來電者需要真人協助時，
智能體會透過交接將通話交回：包括來電者需求摘要、簡短的意圖標籤，以及可供你的流程查閱的 ID。

## 平台

| 平台 | 通話如何接入 | 通話 ID 標頭 | 如何交回 | 如何交回背景資料 |
|---|---|---|---|---|
| [Amazon Connect](/yue/guides/contact-centers/amazon-connect) | 外部語音轉接連接器；IP 允許清單 | `X-Amzn-ConnectContactId` | 交回：智能體掛線，流程繼續執行 | Lambda 呼叫交接查詢 |
| [Five9](/yue/guides/contact-centers/five9) | Five9 設定的 AI Agent Connect，連接至撥入號碼；IP 允許清單 | `X-CallID` | 交回：智能體在 `BYE` 中附上路由標頭後掛線 | 將 `X-Route*` 及 `X-CustomMetaData` 標頭傳入 IVR 通話變數 |
| [Genesys Cloud](/yue/guides/contact-centers/genesys-cloud) | BYOC Cloud 中繼；摘要驗證 | `x-inin-cnv` | `REFER`，由 Take Back and Transfer 接受 | 傳送地址內的十六進位 UUI，然後使用資料動作 |
| [Talkdesk](/yue/guides/contact-centers/talkdesk) | 連接至 Autopilot Voice；IP 允許清單 | `X-Talkdesk-Interaction-Id` | `REFER` 至 Talkdesk 的升級地址 | 傳送地址內的十六進位 UUI，然後執行動作 |
| [Twilio](/yue/guides/contact-centers/twilio) | `<Dial><Sip>`；摘要驗證 | `X-Call-ID`，由你加入 | `REFER` 至你的 `referUrl` 處理程式 | 傳送地址內的標頭（`ReferTransferTarget`） |
| [Microsoft Dynamics 365](/yue/guides/contact-centers/microsoft-dynamics-365) | 經由你的 SBC 轉接至電話號碼；摘要驗證 | `X-Call-ID`，由你加入 | 交回，然後由你的 SBC 將來電者路由回去 | HTTP Request 節點呼叫交接查詢 |
| [NICE CXone](/yue/guides/contact-centers/nice-cxone) | Studio `Placecall` 配合 `Sipputheader`，連接至撥入號碼；IP 允許清單 | `X-Call-ID`，由你加入 | 交回：智能體掛線（請向 NICE 確認指令碼如何將來電者帶回） | REST API 動作呼叫交接查詢 |
| [Zoom Contact Center](/yue/guides/contact-centers/zoom-contact-center) | Zoom 建立的中繼上的機械人小工具，連接至撥入號碼；支援 SRTP 的 IP 允許清單 | `X-ZOOM-Call-Sid` | `REFER` 至 Zoom 的真人智能體地址 | HTTP Call 小工具呼叫交接查詢 |

## 運作方式

1. **為智能體建立 SIP 端點**。能夠回應密碼驗證的平台會使用端點的使用者名稱及密碼。僅透過來源地址識別身分的平台，則使用將 `auth` 設為 `ip_allowlist` 的端點；請參閱[透過來源 IP 驗證身分的平台](/yue/guides/sip-addresses)。撥打電話號碼而非 SIP 地址的平台，會透過端點的[撥入號碼](/yue/guides/sip-addresses)連接端點。
2. **連同背景資料傳送通話。** 平台會撥打端點的 `sip_uri` 或撥入號碼。
   平台傳送的每個 `X-` 標頭及 `User-to-User` 都會成為提示可使用的 `{{sip_…}}` 通話變數，而其 call-id 標頭會儲存為通話的 `external_call_id`。請參閱[在 SIP 標頭中傳遞通話背景資料](/yue/guides/sip-addresses)。
3. **新增一個將通話轉交回去的轉駁號碼**，可以是你平台上的 SIP 地址（智能體會傳送 `REFER`），或是[返回](/yue/guides/call-transfers)（智能體會掛線，然後你的流程會繼續）。其標頭可傳遞 `{{handoff_summary}}`、`{{handoff_intent}}` 及 `{{handoff_id}}`；請參閱[將背景資料傳遞至你的聯絡中心](/yue/guides/call-transfers)。
4. **讀取轉交資料**，位置視乎你的平台儲存位置而定，或透過你平台的通話 ID 查詢。

### 新增轉駁號碼

SIP 地址、返回設定及其標頭均透過 [Agents API](/api-reference/agents#transfer-numbers) 設定。每次寫入均會取代整個清單，因此請一併包含智能體的其他轉駁號碼，然後部署：

```bash
curl -X PATCH https://api.thunderphone.com/v1/agents/12 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transfer_destinations": [{"name": "Contact center", "action": "return"}]}'

curl -X POST https://api.thunderphone.com/v1/agents/12/deploy \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

然後在提示中按名稱告訴智能體何時使用：「當來電者要求與真人聯絡，或你無法處理其要求時，轉駁至 Contact center。」

### 查詢轉交資料

你的流程可使用所屬機構的 API 金鑰及平台的通話 ID 擷取轉交資料：

```bash
curl "https://api.thunderphone.com/v1/calls/handoff?external_call_id=YOUR_PLATFORM_CALL_ID" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

回應包含 `handoff.summary`、`handoff.intent` 及 `handoff.handoff_id`、通話開始時的 SIP 標頭及變數，以及通話結束後的摘要及擷取資料。你亦可透過 `handoff_id` 查詢通話。請參閱[查詢已轉交通話](/api-reference/calls#look-up-a-handed-off-call)。

請將 API 金鑰儲存在你平台的憑證儲存庫，而非流程本身。

<Warning>
  標頭值來自傳送通話的一方。請僅將其作為提示中的背景資料，勿用於判斷來電者身分或其可執行的操作。
</Warning>

## 指南

<CardGroup cols={2}>
  <Card title="Amazon Connect" icon="phone" href="/yue/guides/contact-centers/amazon-connect">
    接入外部語音轉接，並回傳 Lambda 查詢。
  </Card>
  <Card title="Five9" icon="phone" href="/yue/guides/contact-centers/five9">
    透過 AI Agent Connect 接入，並在掛線時回傳路由標頭。
  </Card>
  <Card title="Genesys Cloud" icon="phone" href="/yue/guides/contact-centers/genesys-cloud">
    透過 BYOC Cloud 中繼線接入，並以 UUI 回傳 Take Back 及 Transfer。
  </Card>
  <Card title="Talkdesk" icon="phone" href="/yue/guides/contact-centers/talkdesk">
    接入 Autopilot Voice，並以 UUI 回傳升級轉介。
  </Card>
  <Card title="Twilio" icon="phone" href="/yue/guides/contact-centers/twilio">
    透過 TwiML Dial 接入，並以 REFER 回傳至你的 referUrl 處理程式。
  </Card>
  <Card title="Microsoft Dynamics 365" icon="phone" href="/yue/guides/contact-centers/microsoft-dynamics-365">
    透過你的 SBC 接入轉接，並回傳 HTTP 查詢。
  </Card>
  <Card title="NICE CXone" icon="phone" href="/yue/guides/contact-centers/nice-cxone">
    透過 Studio Placecall 接入，並回傳 REST 查詢。
  </Card>
  <Card title="Zoom Contact Center" icon="phone" href="/yue/guides/contact-centers/zoom-contact-center">
    透過 Bot widget 接入，並以 REFER 回傳至人工智能體。
  </Card>
</CardGroup>
