Oakxgen 使用手冊

外觀

轉真人通知：客人要找真人時，通知 Slack、Teams、Google Chat、Telegram 或信箱

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

開始前 ​

  • 要是工作區的管理員，左下角設定 › 工作區裡才看得到轉真人通知。
  • 這份設定所有 AI 代理共用：任何一個 Channel agent 轉真人時都會通知。
  • 依你要用的類型先準備好 webhook 網址、Telegram bot 或收件信箱（見下表）。

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

類型要填去哪裡拿
SlackWebhook 網址（hooks.slack.com 開頭）在 Slack 建立 Incoming Webhook
Microsoft TeamsWebhook 網址在 Teams 頻道用 Workflows 建立「收到 webhook 要求時張貼到頻道」，貼上它產生的網址
Google ChatWebhook 網址（chat.googleapis.com 開頭）在 Google Chat 空間的「應用程式與整合」→「Webhook」新增一個 webhook
TelegramBot 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

新增通知目的地 ​

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

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

轉真人通知清單，示範：客服信箱，最近狀態送出成功，啟用開關打開

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

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

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

通知裡有什麼 ​

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

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

括號裡是觸發原因，對應轉真人分頁的關鍵字、情緒偵測或連續答不出來。通知在背景送出，送失敗不會影響轉真人本身。

在後台對話頁跟 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 被移出群組，或信箱打錯。修好後按發送測試確認。

下一步 ​