串接對話平台：Viber

把 Agent 串接到 Viber（Beta）：取得 Viber Bot Token、在 MaiAgent 建立 Viber 對話平台、設定歡迎訊息，以及一對一對話等使用限制。

Viber 是許多國家常用的通訊軟體。串接後，使用者在 Viber 與您的 Bot 對話，就由 MaiAgent 的 Agent 回覆，對話紀錄也會出現在 MaiAgent 的「所有對話」中。

Viber 串接目前為 Beta 版，在選擇對話平台的畫面上會標示 Beta。

Viber Bot 只能進行一對一對話，無法加入群組。若需要群組對話，請改用其他對話平台。

串接前確認

• 已在 MaiAgent 平台建立好一個「AI 助理」

• 具備 對話平台權限（權限說明見角色權限管理）

• 已取得 Viber Bot 的 Bot Token（見下一步）

步驟一：取得 Viber Bot Token

Viber 的 Bot 申請採商業合作制，需要向 Viber 官方或其合作夥伴申請，申請管道可參考 Viber 的 Viber Partners 頁面。Bot 開通後，您會取得一組 Bot Token，下一步會用到。

Bot Token 在建立對話平台後無法修改。 請確認取得的是正確 Bot 的 Token 再進行步驟二。

步驟二：在 MaiAgent 建立 Viber 對話平台

1. 進入串接對話平台

在左側選單點選 客服對話 → 對話平台，點擊右上角 串接對話平台，選擇 Viber。

2. 填寫基本設定

欄位	說明
名稱	為此串接取一個名稱（必填）。這只是 MaiAgent 這側的標籤
AI 助理	選擇要回覆 Viber 訊息的 Agent
Bot Token	步驟一取得的 Token（必填）
歡迎訊息	使用者首次開啟對話時自動回覆的內容，上限 7,000 字；留空表示不回覆
啟用重置命令	開啟後可新增 重置命令 關鍵字。使用者傳送完全相同的關鍵字，就會開始一段新對話

使用者在 Viber 看到的 Bot 名稱與頭像，會在建立時從 Viber Bot 帳號帶入，不需要在 MaiAgent 另外填寫；名稱超過 28 個字元時，回覆訊息上只會顯示前 28 個字元。

3. 功能設定

切換到 功能設定 分頁，可調整 啟用 OCR、使用系統時間回答、使用傳送者名稱回答。各開關的說明與時區規則請見功能設定。

4. 分配權限並建立

切換到 權限設定 分頁，選擇可以查看與管理這個對話平台的角色，再點擊 串接對話平台。

MaiAgent 會先向 Viber 驗證 Bot Token，驗證成功後自動為您設定 Webhook，不需要回到 Viber 另外填寫網址。建立完成後即可在 Viber 與 Bot 對話測試。

建立後可以調整的設定

從 對話平台 列表點擊這個平台的 編輯，可以：

• 修改 歡迎訊息、重置命令，或用 重置所有對話 一次重置這個平台下的所有對話（無法復原）。Bot Token 欄位會顯示「已設定；僅在建立時可輸入」，不能修改。

• 在 功能設定 開啟 啟用等待提示訊息：使用者傳訊息後、AI 還在處理時，先送出一則提示（例如「AI 處理中，請稍候...」）。Viber 無法修改或刪除已送出的訊息，所以每則提問只會送出一次提示，提示重複間隔秒數 在 Viber 不會生效。

• 設定 客服轉真人設定、Webhook 設定、AI Copilot 等進階分頁，說明見對話平台設定總覽、客服轉真人設定與客服 Copilot。

支援的訊息類型

使用者傳送	Agent 的處理方式
文字	直接回答
圖片	存為附件，交給 Agent 處理
影片	存為附件，記錄在對話中
網址	以網址文字處理
聯絡人	以聯絡人的姓名與電話文字處理
位置	轉成「位置分享」與經緯度文字後處理
貼圖	只記錄在對話中，沒有可回答的文字內容

Agent 回覆時：

• 文字：粗體、斜體、刪除線會轉成 Viber 的文字樣式，連結會以「文字 (網址)」呈現。單則超過 7,000 字時自動分段送出，不會被截斷。

• 附件：圖片以圖片訊息送出；其他檔案（含影音）以檔案訊息送出，單檔上限 50 MB，且檔名需有副檔名。

常見問題

可以把 Bot 加進 Viber 群組嗎？

不行。Viber Bot 本身無法加入群組，所有對話都是使用者與 Bot 的一對一對話。

建立時出現「Bot 已在其他 Inbox 中註冊」？

同一個 Viber Bot 只能串接一個對話平台。若 Bot 已經串接在您組織的另一個對話平台，訊息會帶出該平台名稱；請先刪除舊的對話平台，或改用另一個 Bot。

建立時出現「無效的令牌」？

代表 Viber 不接受這組 Bot Token。請確認 Token 完整複製、沒有多餘空白，且 Bot 仍為有效狀態。

使用者傳的檔案，Agent 讀不到？

目前只處理上表列出的訊息類型。使用者在 Viber 傳送的文件檔不會被讀取，請引導使用者改貼文字或傳圖片。

更換 Bot Token 或改接別的 Bot？

Bot Token 建立後不能修改。請刪除此對話平台，再以新的 Token 重新建立；刪除時 MaiAgent 會一併移除原本設定在 Viber 的 Webhook。

有些使用者收不到回覆？

使用者在 Viber 取消訂閱 Bot 後，Agent 不會再回覆該使用者；使用者重新訂閱後即恢復。