跳到內容

連接 LINE 官方帳號

貼上一組 Channel Access Token,就能讓 Chatbotta 接手回覆 LINE 官方帳號的訊息。Webhook 網址與圖文選單由系統自動設定。

  • 一個 LINE 官方帳號。還沒有的話,先在 LINE Official Account Manager 建立;好友名單、加好友連結與 QR Code 都屬於官方帳號,之後更換平台也不會受影響
  • 在 Chatbotta 專案中具有管理者以上的權限(其他成員只能查看連線狀態)

每個專案可以連接一個 LINE 官方帳號。要服務多個官方帳號,請分別建立專案。

  1. 在官方帳號啟用 Messaging API

    在 LINE Official Account Manager 進入官方帳號,前往「設定 → Messaging API」,點「啟用 Messaging API」,依畫面選擇或建立一個 Provider(提供者)。已經啟用過的帳號可以跳過這一步。

  2. 發行 Channel Access Token

    • 前往 LINE Developers Console,選擇剛才的 Provider 與官方帳號的 Channel
    • 進入「Messaging API」分頁,捲到最下方的「Channel access token (long-lived)」
    • 點「Issue」產生 token 並複製(一長串英數字)

    已經發行過的 token 可以直接沿用,不必重新產生。

  3. 貼進 Chatbotta

    • 在 Chatbotta 進入專案「設定 → 頻道串接」,點「新增連線」,選擇「LINE」
    • 貼上 Channel Access Token,點「儲存並驗證」

    專案已經連接 LINE 時,「新增連線」裡的 LINE 會停用,請改點既有的帳號卡進入「編輯連線」。

    系統會向 LINE 驗證 token,成功後自動設定 Webhook 網址並同步你在 Chatbotta 設計的圖文選單,不需要手動複製 Webhook URL。

  4. 確認連線狀態

    連線畫面會顯示官方帳號名稱與「OA 資訊」,並分別列出 Channel Access Token 與 Webhook 兩項狀態。先確認 Token 那一列是「已啟用」,再看 Webhook 那一列;兩者是各自獨立的檢查。

  5. 在 LINE 端開啟 Webhook、關閉內建自動回應

    回到 LINE Official Account Manager:

    • 在「設定 → Messaging API」確認 Webhook 網址已經由 Chatbotta 填好。這個網址不需要、也不要手動修改
    • 在「回應設定」開啟 Webhook
    • 在「回應設定」關閉「自動回應訊息」;有開啟 AI 聊天機器人(β)的話也一併關閉,否則同一則訊息會被 LINE 和 Chatbotta 各回一次

    加入好友的歡迎訊息與聊天(真人回覆)的設定維持原狀即可。回到 Chatbotta 點「重新驗證」,Webhook 狀態應該變成「已啟用」。

  6. 傳訊息測試

    連線畫面的「OA 資訊」提供加入好友連結與 QR Code。用手機加入官方帳號,傳一則訊息,確認機器人有回覆、訊息也出現在聊天室。

在「設定 → 頻道串接」點選已連接的 LINE 帳號:

  • 重新驗證: 重新向 LINE 確認 token 與 Webhook 狀態
  • 更換 Token: 在 LINE Developers 重新發行 token 後,貼上新的 token。重新發行會讓舊 token 立即失效,若同一個官方帳號還有其他服務在用,要一併更新;只是要確認連線正常的話,用「重新驗證」就好,不必換 token。單純更換 token 不需要重新發布對話流程
  • 解除綁定: 解除後專案無法再透過這個官方帳號回覆訊息,Chatbotta 設定的圖文選單也會一併移除;之後可以重新連接

所有 token 都以 AES-256-GCM 加密保存,LINE 傳來的 Webhook 也會驗證簽章,來源不符的請求一律拒絕。

  • 確認複製的是 Channel access token (long-lived),不是 Channel ID 或 Channel secret
  • 確認前後沒有多餘的空白或換行
  • token 若曾在 LINE Developers 重新發行,舊的會失效,請貼上最新的

Webhook 網址已由系統設定,但 LINE 端的開關沒有打開。到 LINE Official Account Manager 的「回應設定」開啟 Webhook(或在 LINE Developers Console 的「Messaging API」分頁開啟「Use webhook」),回到 Chatbotta 點「重新驗證」。

「Token 已儲存並驗證,但 Webhook 網址設定失敗」或「圖文選單同步失敗」

Section titled “「Token 已儲存並驗證,但 Webhook 網址設定失敗」或「圖文選單同步失敗」”

token 本身沒問題,是後續向 LINE 設定時失敗。稍後點「重新驗證」再試;持續失敗請聯絡我們。

  • Token 與 Webhook 狀態都是「已啟用」嗎?
  • LINE Official Account Manager 的「回應設定」中,Webhook 已開啟、「自動回應訊息」已關閉嗎?
  • 最新的對話流程已經發布了嗎?
  • 這個官方帳號是否也串接在其他機器人平台?同一個官方帳號只能有一個 Webhook 網址,後設定的會覆蓋前一個

好友名單綁在官方帳號上,換平台只是把 Webhook 指向 Chatbotta。完整步驟見聊天機器人平台搬家指南。