---
url: https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/zalo-integration.md
description: >-
  貼上 Zalo Bot token 就能讓 AI 在 Zalo 私訊裡回覆客人，適合越南市場。這篇說明怎麼取得 token、支援哪些訊息、跟
  Telegram 串接有什麼不同，以及 Zalo 沒有真人客服時轉真人會發生什麼事。
---

看完這篇，你可以把 Skill agent 或 SCRM AI 接上 Zalo bot，並知道哪些訊息 AI 看得懂、哪些不行。

## 開始前

* 需要**編輯 Agent** 權限。agent 要先存檔，才能設定串接（「先存檔建立 AI，才能設定串接。」）。
* 在 Zalo 官方帳號（OA）後台的「設定 → API → Bot API」，或用 Zalo Bot Creator 建立一個 bot，拿到 **Bot token**。

## 建立串接

1. 打開 agent 的**串接**分頁。SCRM AI 在**其他串接**區塊、Skill Agent 在**串接通路**區塊，按**新增串接**。
2. 在「選擇要串接的通路」選 **Zalo**，出現**串接 Zalo** 視窗。
3. 把 token 貼進 **Bot token**，按**連線**。

![串接 Zalo 視窗，Bot token 欄位與四條說明](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/images/zalo-integration-01-form.png)

系統會先用 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 設定的[主動追問](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/follow-up.md)一樣會在 Zalo 送出 |

客人用越南文問，AI 會用越南文回；可以在[對話紀錄](https://docs.oakxgen.ai/zh-Hant-TW/guide/logs/chat-logs-find-and-filter.md)用**來源**篩選 **Zalo** 的對話。

## 轉真人：已讀不回

Zalo 沒有真人客服收件匣。觸發[轉真人](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff.md)時，AI 不會送任何訊息，這位客人的對話暫停 30 分鐘，之後自動恢復由 AI 回覆。SCRM AI 開著轉真人又串了 Zalo 時，列表會提醒「此通路轉真人會已讀不回。」要讓真人接手，可以搭配[轉真人通知](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff-notify.md)，讓團隊收到通知後自己到 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 串接](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/telegram-integration.md)
* [轉真人通知](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff-notify.md)
* [說話方式](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/voice-tone.md)：AI 回覆客人的語言