---
url: https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff-notify.md
description: >-
  AI
  把對話轉給真人時，可以同時通知你的客服團隊，不用一直盯著後台。這篇說明怎麼新增通知目的地、五種類型各要準備什麼、通知內容有哪些，以及怎麼先發測試確認收得到。
---

看完這篇，你可以在客人要求真人客服時，讓 Slack、Microsoft Teams、Google Chat、Telegram 或信箱馬上收到通知。

## 開始前

* 要是工作區的**管理員**，左下角**設定 › 工作區**裡才看得到**轉真人通知**。
* 這份設定**所有 AI 代理共用**：任何一個 Channel agent [轉真人](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff.md)時都會通知。
* 依你要用的類型先準備好 webhook 網址、Telegram bot 或收件信箱（見下表）。

## 五種通知目的地要準備什麼

| 類型 | 要填 | 去哪裡拿 |
|---|---|---|
| **Slack** | **Webhook 網址**（`hooks.slack.com` 開頭） | 在 Slack 建立 Incoming Webhook |
| **Microsoft Teams** | **Webhook 網址** | 在 Teams 頻道用 Workflows 建立「收到 webhook 要求時張貼到頻道」，貼上它產生的網址 |
| **Google Chat** | **Webhook 網址**（`chat.googleapis.com` 開頭） | 在 Google Chat 空間的「應用程式與整合」→「Webhook」新增一個 webhook |
| **Telegram** | **Bot token** 與 **Chat ID** | 找 @BotFather 建立 bot 拿到 token，把 bot 拉進要收通知的群組或頻道；群組的 chat ID 可以請 @userinfobot 或 @RawDataBot 查 |
| **Email** | **收件信箱** | 客服團隊的共用信箱，例如 support@example.com |

下圖是**新增通知目的地**視窗打開**類型**選單的樣子，由上到下是 Slack、Microsoft Teams、Google Chat、Telegram、Email。

![新增通知目的地視窗，類型選單列出 Slack、Microsoft Teams、Google Chat、Telegram、Email](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/images/handoff-notify-01-kinds.png)

## 新增通知目的地

1. 點左下角**設定**，在**工作區**分組點**轉真人通知**。
2. 按右上角**新增通知目的地**。
3. 選**類型**，填**名稱**（例如「客服群組」），再依類型填 webhook 網址、Bot token 與 Chat ID，或收件信箱。
4. 按**儲存**。
5. 在清單那一列按紙飛機圖示（**發送測試**），確認團隊真的收到。

清單上每一列有**名稱**、**通知到**、**最近狀態**、**啟用**開關與操作按鈕。下圖是新增一個 Email 目的地「示範：客服信箱」並發過測試後的樣子：**最近狀態**顯示綠色的「2026/10/11 20:10:06 送出成功」。

![轉真人通知清單，示範：客服信箱，最近狀態送出成功，啟用開關打開](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/images/handoff-notify-02-list.png)

下面的動畫示範把滑鼠移到紙飛機圖示上，提示寫著「沒啟用也會發，可以先測再打開」；按下去後右上角出現「已送出測試通知」，**最近狀態**變成送出成功的時間。

[動畫（MP4）](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/images/handoff-notify-03-test.mp4)

測試通知的內容是「「Oakxgen」有客人需要真人客服（這是一則測試通知）」。**沒啟用的目的地也能發測試**，可以先確認收得到再把**啟用**打開。

| 項目 | 規則 |
|---|---|
| 數量 | 每個工作區最多 5 個通知目的地 |
| 啟用 | 關掉的目的地轉真人時不會通知，但仍可以發測試 |
| 最近狀態 | 「還沒送過」、「時間 送出成功」或「失敗（原因）」 |
| 修改 webhook 網址 | 編輯時網址欄留空＝沿用目前的網址，欄位下方顯示「目前：」加遮罩過的網址 |

## 通知裡有什麼

客人觸發轉真人時，每個啟用中的目的地會收到一則通知：

| 內容 | 範例 |
|---|---|
| 第一行 | 「示範：診所預約客服」有客人需要真人客服（關鍵字） |
| 渠道 | 渠道：LINE（OakMega SCRM） |
| 客人最後說的話 | 客人最後說：我要找真人（超過 200 字會截斷） |
| 連結 | **查看對話紀錄**，點了直接打開後台這段對話 |

括號裡是觸發原因，對應[轉真人](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff.md)分頁的關鍵字、情緒偵測或連續答不出來。通知在背景送出，送失敗不會影響轉真人本身。

在後台**對話**頁跟 agent 試聊時就算觸發轉真人，也不會發通知；要確認通知能不能收，用**發送測試**。

## 常見問題

### 儲存時出現「這不是這個類型支援的 webhook 網址（Slack、Microsoft Teams 或 Google Chat）」

貼的網址跟選的類型對不上，例如選 Slack 卻貼了 Teams 的網址。Slack 要 `hooks.slack.com`、Google Chat 要 `chat.googleapis.com`；Teams 用 Workflows 產生的網址（舊的 Incoming Webhook 網址也可以）。

### 儲存時出現「請貼上完整的 https 網址」

webhook 網址要從 `https://` 開始整串貼上，不能只貼一部分。

### Telegram 出現「Bot token 格式不對」或「Chat ID 格式不對（數字或 @頻道名稱）」

Bot token 是 BotFather 給的「一串數字:一串英數字」；Chat ID 是數字（群組與頻道是負數，例如 `-1001234567890`），或 `@頻道名稱`。

### 出現「通知目的地最多 5 個」

已經有 5 個目的地。刪掉不用的再新增。

### 最近狀態顯示「失敗（…）」

括號裡是失敗原因。常見是 webhook 被刪掉、bot 被移出群組，或信箱打錯。修好後按**發送測試**確認。

## 下一步

* [轉真人怎麼觸發](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff.md)
* [對話紀錄：怎麼找到某個 Agent 的某段對話](https://docs.oakxgen.ai/zh-Hant-TW/guide/logs/chat-logs-find-and-filter)