ServiceChat 社群通路機器人申請教學
本文件說明商戶如何申請並設定 Telegram Bot、LINE Messaging API Channel、WhatsApp Cloud API 與 Facebook Messenger Page，並對應到 ServiceChat 後台需要填寫的欄位。
共通前置條件
WhatsApp 與 Facebook Messenger 在官方文件中通常不稱為 Bot，而是使用 Meta App、Business Account、Phone Number 或 Page 來串接。ServiceChat 後台仍以「通訊軟體客服」統一管理。
- ServiceChat 必須使用正式 HTTPS 網域，第三方平台才會接受 webhook。
- 登入 ServiceChat 後台，進入
/console -> 設定 -> 通訊軟體客服。 - 先在 ServiceChat 新增對應通路並保存，系統會產生 Webhook URL。WhatsApp 與 Messenger 也會產生 Verify Token。
- 到第三方平台貼上 Webhook URL，必要時貼上 Verify Token。
- 回到 ServiceChat 按「測試」或等待平台 webhook 驗證。
- Token、Secret、App Secret 都是敏感資料，不要貼在公開文件、截圖或客服對話。外洩時請到原平台重新產生並回到 ServiceChat 更新。
預設收件匣分類
新增或編輯 Telegram、LINE、WhatsApp、Messenger 通路時，可選填「預設收件匣分類」。這個欄位用來決定從該機器人或通路新建立的私聊、群聊聊天室要自動放入哪個收件匣分類；留空時會進入「未分類」。
分類代碼不需要事先建立，可直接在欄位中輸入商戶想使用的代碼。此設定只影響設定後新建立的聊天室，既有聊天室若要變更分類，請由聊天室管理者在收件匣內調整聊天室分類。
ServiceChat 欄位對照
| 通路 | ServiceChat 必填欄位 | 從哪裡取得 |
|---|---|---|
| Telegram | Bot Token | Telegram @BotFather |
| LINE | Channel Access Token、Channel Secret | LINE Developers 的 Messaging API channel |
| Access Token、Phone Number ID、Business Account ID、App Secret | Meta Developers / WhatsApp Cloud API | |
| Messenger | Page Access Token、Facebook Page ID、App Secret | Meta Developers / Facebook Page |
Telegram Bot
申請步驟
- 在 Telegram 搜尋並開啟
@BotFather。 - 輸入
/newbot，依提示設定 Bot 顯示名稱與 username。 - BotFather 會回傳 Bot Token。把這組 Token 貼到 ServiceChat 的「新增 Telegram Bot」。
- 如果要讓 Bot 在群組中理解完整上下文，請在 BotFather 輸入
/setprivacy，選擇你的 Bot，設定為Disable。 - 在 ServiceChat 保存後按「測試」。
- 測試成功後按「設定 Webhook」。Telegram 的 webhook 由 ServiceChat 直接呼叫 Telegram Bot API 設定。
- 將 Bot 加入 Telegram 群組，或直接與 Bot 私聊。
ServiceChat 行為
- Telegram 私聊會建立
messenger_direct聊天室。 - Telegram group / supergroup 會建立
messenger_group聊天室。 - 群聊 AI 回覆必須在 ServiceChat 啟用「AI 群回覆」，且通常需要使用者明確
@BotUsername才會觸發。
常見問題
| 測試 Bot 失敗 | Bot Token 是否複製完整，前後是否有空白。 |
|---|---|
| 群組只收到少數訊息 | BotFather /setprivacy 是否為 Disable。 |
| Webhook 設定失敗 | ServiceChat 網域是否為 HTTPS，正式站是否可由外網連入。 |
| AI 沒有在群組回覆 | ServiceChat 的「AI 群回覆」是否啟用，訊息是否提及 Bot。 |
LINE Messaging API Channel
申請步驟
- 登入 LINE Developers。
- 建立 Provider，或選擇既有 Provider。
- 建立 Messaging API channel。若你已經有 LINE Official Account，可將該官方帳號啟用 Messaging API。
- 在 channel 的 Basic settings 取得 Channel Secret。
- 在 Messaging API 設定頁產生 Channel Access Token。正式使用建議使用長期有效的 access token，並做好保管與輪替流程。
- 到 ServiceChat 新增 LINE Channel，填入名稱、Channel Access Token、Channel Secret 後保存。
- ServiceChat 會顯示 Webhook URL。複製後貼回 LINE Developers 的 Webhook URL。
- 在 LINE Developers 啟用 Use webhook。
- 建議關閉 LINE 官方帳號後台的自動回覆或預設回覆，避免 LINE 自動回覆與 ServiceChat 客服同時回覆客人。
- 回到 ServiceChat 按「測試」。
ServiceChat 行為
- LINE 一對一聊天會建立
messenger_direct聊天室。 - LINE group / room 會建立
messenger_group聊天室。 - LINE 使用者回覆某則訊息時，ServiceChat 會盡量同步原生 reply 的引用預覽。
常見問題
| LINE webhook 驗證失敗 | Webhook URL 是否貼到正確 channel，Use webhook 是否啟用。 |
|---|---|
| 測試失敗 | Channel Access Token 是否仍有效，Channel Secret 是否填錯。 |
| 客人收到兩種回覆 | LINE 官方帳號自動回覆是否仍啟用。 |
| 群組沒有建立聊天室 | Bot 是否已被加入群組，群組是否允許官方帳號接收訊息。 |
WhatsApp Cloud API
申請步驟
- 登入 Meta for Developers。
- 建立或選擇 Meta App，App 類型需可加入 WhatsApp 產品。
- 在 App 中加入 WhatsApp 產品。
- 建立或選擇 WhatsApp Business Account。
- 取得 Phone Number ID 與 Business Account ID。
- 取得 App Secret。App Secret 位於 App settings 的 Basic 區域。
- 建立可用於 WhatsApp Cloud API 的 Access Token。正式環境建議使用 Business Manager 的 System User 產生長期 token。
- 到 ServiceChat 新增 WhatsApp 帳號，填入名稱、Access Token、Phone Number ID、Business Account ID、App Secret 後保存。
- ServiceChat 會顯示 Webhook URL 與 Verify Token。複製兩者。
- 回到 Meta Developers 的 WhatsApp Webhooks 設定，貼上 Callback URL 與 Verify Token。
- 訂閱 messages 事件欄位。
- 回到 ServiceChat 按「測試」。
- 正式對外使用前，請確認 App 已切換 Live mode，Business verification、電話號碼狀態與訊息模板審核符合 Meta 要求。
ServiceChat 行為
- WhatsApp Cloud API 目前以一對一訊息為主，ServiceChat 會建立
messenger_direct聊天室。 - ServiceChat 會驗證 Meta 傳入的簽章。App Secret 填錯時 webhook 會被拒絕。
- 圖片、影片、語音、文件等媒體會依 WhatsApp API 可取得內容下載並存入聊天室。
常見問題
| Webhook 驗證失敗 | Callback URL 與 Verify Token 是否和 ServiceChat 顯示完全相同。 |
|---|---|
| 收不到訊息 | messages 事件是否已訂閱，App 是否 Live，電話號碼是否可用。 |
| 測試 API 失敗 | Access Token 權限是否不足或過期，Phone Number ID 是否填成電話號碼本身。 |
| Webhook 被拒絕 | App Secret 是否正確，Meta X-Hub-Signature-256 驗證是否通過。 |
Facebook Messenger Page
申請步驟
- 先準備一個 Facebook Page。
- 登入 Meta for Developers。
- 建立或選擇 Meta App，並加入 Messenger 產品。
- 在 Messenger 設定中選擇要串接的 Facebook Page，產生 Page Access Token。
- 取得 Facebook Page ID。
- 取得 App Secret。App Secret 位於 App settings 的 Basic 區域。
- 到 ServiceChat 新增 Messenger Page，填入名稱、Page Access Token、Facebook Page ID、App Secret 後保存。
- ServiceChat 會顯示 Webhook URL 與 Verify Token。複製兩者。
- 回到 Meta Developers 的 Webhooks 設定，新增 callback URL 與 verify token。
- 對 Page 訂閱 messages、messaging_postbacks、message_deliveries、message_reads 等必要事件。
- 確認 Page 已訂閱到該 App。
- 回到 ServiceChat 按「測試」。
- 正式提供給一般 Facebook 使用者前，請確認 App 已通過需要的 Messenger 權限審查，例如 pages_messaging。
ServiceChat 行為
- Messenger Page 私訊會建立
messenger_direct聊天室。 - ServiceChat 會驗證 Meta 傳入的簽章。App Secret 填錯時 webhook 會被拒絕。
- 客服從 ServiceChat 回覆時，會透過該 Page 的 Messenger 身分送出。
- Messenger 平台有回覆時效與政策限制，若超過官方允許的客服回覆窗口，可能需要使用符合政策的訊息類型。
常見問題
| Webhook 驗證失敗 | Verify Token 是否貼錯，Callback URL 是否使用正式 HTTPS。 |
|---|---|
| 私訊沒有進入 ServiceChat | Page 是否已訂閱 App，Webhooks 事件是否已訂閱。 |
| 測試失敗 | Page Access Token 是否屬於正確 Page，權限是否不足或過期。 |
| 客服回覆送不出去 | Messenger 回覆窗口與 Meta 平台政策是否允許。 |
上線前檢查清單
- ServiceChat 網域是正式 HTTPS，且第三方平台能從外網連入。
- 每個通路已在 ServiceChat 保存，且啟用狀態為開啟。
- Webhook URL 已貼回對應平台。
- WhatsApp / Messenger 的 Verify Token 已貼回 Meta。
- WhatsApp / Messenger 的 App Secret 已正確填入，避免簽章驗證失敗。
- Telegram 已按「設定 Webhook」。
- LINE 已啟用 Use webhook。
- 已測試文字訊息進入 ServiceChat。
- 已測試圖片或檔案訊息進入 ServiceChat。
- 已測試客服從 ServiceChat 回覆到原平台。
- 若要使用群聊 AI，已在 ServiceChat 啟用實驗 AI 群回覆，並用提及 Bot 的方式測試。