外觀
看完這篇，你可以把 Skill agent 或 SCRM AI 接上 Zalo bot，並知道哪些訊息 AI 看得懂、哪些不行。
開始前
- 需要編輯 Agent 權限。agent 要先存檔，才能設定串接（「先存檔建立 AI，才能設定串接。」）。
- 在 Zalo 官方帳號（OA）後台的「設定 → API → Bot API」，或用 Zalo Bot Creator 建立一個 bot，拿到 Bot token。
建立串接
- 打開 agent 的串接分頁。SCRM AI 在其他串接區塊、Skill Agent 在串接通路區塊，按新增串接。
- 在「選擇要串接的通路」選 Zalo，出現串接 Zalo 視窗。
- 把 token 貼進 Bot token，按連線。
系統會先用 token 向 Zalo 確認 bot 存在，再自動設好 webhook，看到「已連線 bot 名稱」就完成了。列表上會寫「還沒收到訊息。傳一句話給它，這裡出現時間就代表串好了。」——用自己的 Zalo 傳一句話給這個 bot，列表出現最後收到時間就代表串好了。
| 錯誤訊息 | 原因 |
|---|---|
| 請填 Zalo Bot token | 欄位空白 |
| Zalo Bot token 無效：… | token 打錯，或 bot 已被刪除 |
| 設定 Zalo webhook 失敗：… | Zalo 端暫時無法設定，稍後再按一次連線 |
| 連線失敗，請確認 token 是否正確 | 其他連線問題 |
支援範圍
| 項目 | 行為 |
|---|---|
| 對話對象 | 只回一對一私訊，群組裡的訊息會忽略 |
| 客人傳文字 | 正常回覆 |
| 客人傳圖片、貼圖、語音 | AI 只會看到「傳了一張圖片」這類文字，看不到內容；圖片附的說明文字會當成一句話 |
| 客人傳影片、檔案 | 忽略 |
| AI 回覆 | 純文字，每則最多 2,000 字，太長會自動拆成幾則；可以送圖片 |
| 卡片 | 轉成文字（標題、描述、按鈕名稱與網址） |
| 快速回覆 | Zalo 沒有按鈕，會變成「• 選項」清單接在回覆最後 |
| 輸入中 | AI 準備回覆時會顯示輸入中 |
| 主動追問 | SCRM AI 設定的主動追問一樣會在 Zalo 送出 |
客人用越南文問，AI 會用越南文回；可以在對話紀錄用來源篩選 Zalo 的對話。
轉真人：已讀不回
Zalo 沒有真人客服收件匣。觸發轉真人時，AI 不會送任何訊息，這位客人的對話暫停 30 分鐘，之後自動恢復由 AI 回覆。SCRM AI 開著轉真人又串了 Zalo 時，列表會提醒「此通路轉真人會已讀不回。」要讓真人接手，可以搭配轉真人通知，讓團隊收到通知後自己到 Zalo 回覆。
跟 Telegram 串接的差別
| Telegram | Zalo | |
|---|---|---|
| token 從哪來 | @BotFather | Zalo OA 後台「設定 → API → Bot API」或 Zalo Bot Creator |
| 每則上限 | 4,096 字 | 2,000 字 |
| 快速回覆 | 訊息下方的按鈕 | 文字清單 |
| 客人想重新開始 | 傳 /start 會重新開始，也會解除轉真人的暫停 | 沒有，只能等 30 分鐘 |
| 串接後的錯誤提示 | 列表會顯示 Telegram 回報的投遞失敗 | 不會顯示 |
解除與更換 token
- 按解除串接，確認「解除後 bot 名稱 將不再回覆訊息，確定要解除嗎？」後，系統會一併取消 Zalo 的 webhook。
- 沒有「修改 token」的功能，要換 token 就先解除，再用新 token 重新連線。
- 一個 Zalo bot 同時只能接一個 AI：把同一個 bot 接到另一個 AI，原本那邊的串接會自動停用。一個 AI 可以接多個 bot。
延伸閱讀
- Telegram 串接
- 轉真人通知
- 說話方式：AI 回覆客人的語言