使用說明 使用說明
Workspace

連接 LINE 與 Meta

一個專案的「對話」頁籤：連接 LINE 官方帳號與 Meta 粉專、「通知對象（角色）」，以及客戶面板區塊。

本頁內容 3

一個專案的「對話」頁籤，是專案連接「Line 官方帳號」或「Meta 粉專（Messenger / Instagram）」的地方。連接之後，客戶傳來的訊息，會進到對話應用程式裡的客戶對話。這個頁籤也用來設定客戶面板區塊。

頁籤最上面寫著：「這裡設定專案怎麼跟客戶說話。只有專案的管理者可以看到與修改。」這裡說的管理者，是擁有「管理聊天頻道」這項角色權限的成員，請看權限一覽。專案擁有者一定有這項權限。其他人打開這個頁籤，只會看到這一行字。

這個頁籤設定的，是「專案」分頁正在查看的專案。

外部聊天頻道

「外部聊天頻道」的旁邊是「＋ 新增頻道」。還沒有頻道時，這裡寫著「還沒有連接任何頻道。連接 Line 官方帳號或 Meta 粉專後，顧客的訊息就會進到對話裡。」

每一個頻道一行，寫著名稱、類型、「啟用中」或「已停用」，以及「通知：」和「全部成員」或勾選的角色名稱。後面有「編輯」與「刪除」；按「刪除」時，那一行會先問「確定刪除？」。

按「＋ 新增頻道」會打開「新增外部聊天頻道」，按「編輯」會打開「編輯外部聊天頻道」。框裡有這些：

  • 「頻道類型」：「Line 官方帳號」或「Meta 粉專（Messenger / Instagram）」。只有新增頻道時可以選。編輯時只會顯示類型，旁邊寫著「（建立後不能改；要換平台請新增一個頻道）」。
  • 「顯示名稱」：下面寫著「會顯示在訊息頁客戶名稱旁邊，讓客服知道訊息來自哪個帳號。」填了它，「儲存」才按得下去。
  • 「Webhook 網址」與「複製」：下面寫著「貼到平台後台。網址必須是公開的 https 網域，平台才連得到（localhost、內網 IP 不行）。」
    • LINE 的網址最後是 /api/line/webhook，Meta 的網址最後是 /api/meta/webhook。網站上每一個專案，用的都是同一個網址。
    • 網址的前半段是網站自己的網址，所以請直接從框裡複製。
    • 這不是工作流的 Webhook。工作流的 Webhook，請看Webhook 觸發。
  • 選「Line 官方帳號」時：
    • 「Channel access token」：下面寫著「Line Developers console → Messaging API 分頁發行的長效 token。」
    • 「Channel secret」：下面寫著「Line Developers console → Basic settings 分頁。驗簽用。」
    • 新增頻道時，這兩個都要填。
  • 選「Meta 粉專（Messenger / Instagram）」時：
    • 「粉專 ID」。
    • 「Instagram 帳號 ID」：下面寫著「有連結 IG 專業帳號時才填。」
    • 「Page access token」。
    • 「App secret」。
    • 「Verify token」：下面寫著「自己取一組字串，跟 Meta 後台 webhook 設定填的一樣即可。」
    • 新增頻道時，「粉專 ID」、「Page access token」、「App secret」與「Verify token」都要填；「Instagram 帳號 ID」可以空著。
  • 「通知對象（角色）」：請看下面的通知對象（角色）。
  • 「啟用」：新的頻道一開始是打開的。關掉時，這個頻道不會收進任何客戶的訊息，在它的對話裡回覆也送不出去。

存好之後不會再顯示的：「Channel access token」、「Channel secret」、「Page access token」與「App secret」。按「編輯」時，已經存過的這幾個框，灰色提示是「已設定，留空表示不變」，留空就保留原本存的。「粉專 ID」、「Instagram 帳號 ID」與「Verify token」會照原樣顯示，可以直接改。每一次儲存，「Verify token」都要有填。

「刪除」會把這個頻道整個刪掉，連同存在裡面的密鑰，不能復原。只想暫停一陣子的話，請把「啟用」關掉。頻道刪掉之後，它原本的對話還會留在對話應用程式裡，但在這些對話裡回覆送不出去，和關掉「啟用」時一樣。

通知對象（角色）

「通知對象（角色）」列出這個專案的每一個角色，包括「擁有者」。

  • 一個角色都沒有勾時，這個頻道不限制誰收到推播。誰會收到，寫在對話應用程式的說明。
  • 勾了任何角色時，沒有設負責人的客戶對話收到客戶的訊息，沒有人會收到推播。 網站找這些角色的成員時，找的地方沒有存專案的角色，所以一個人都找不到。
  • 還有用的是負責人：在對話應用程式裡，替一段客戶對話設了負責人時，這段對話的推播只會送給負責人，不看「通知對象（角色）」。

所以請讓「通知對象（角色）」保持空白。它不會改變誰看得到這些對話。

  • 刪除一個角色時，它也會從每一個頻道的「通知對象（角色）」拿掉，請看刪除角色。
  • 沒有勾角色時，頻道那一行寫著「通知：全部成員」。

客戶面板區塊

客戶面板區塊是一張卡片，顯示在對話應用程式裡、客戶對話旁邊的客戶資訊面板上。它會從專案設定的網址讀出項目，讓客服看到客戶的相關資料。

「客戶面板區塊」的旁邊是「＋ 新增區塊」。還沒有區塊時，這裡寫著「還沒有任何區塊。區塊是客戶對話旁邊的卡片，會從 API 讀出項目，讓客服看到顧客的相關資料。」

每一個區塊一行，寫著名稱、「外部 API」或「內部 API」、「啟用中」或「已停用」，下面一行是「動作：」與「頻道：」。

  • 動作用英文顯示：read、create、update 與 delete。read 一定在裡面。
  • 沒有選頻道時，「頻道：」後面是「全部」。
  • 後面有「編輯」與「刪除」；按「刪除」時，那一行會先問「確定刪除？」。

按「＋ 新增區塊」會打開「新增客戶面板區塊」，按「編輯」會打開「編輯客戶面板區塊」。框裡有這些：

  • 「區塊名稱」：下面寫著「會顯示在客戶面板的卡片標題。」
  • 「排序」：下面寫著「小的排前面。」
  • 「顯示頻道」：專案有頻道時才會出現，下面寫著「不選 = 所有頻道都顯示。」
  • 「允許的動作」：「新增」、「修改」與「刪除」，下面寫著「讀取（read）固定開啟，不用選。」
  • 「讀取 API（read）」：一定會出現。
  • 每勾一個動作，就會多出它的框：「新增 API（create）」、「修改 API（update）」或「刪除 API（delete）」。勾了的動作，它的框一定要填。「修改 API（update）」與「刪除 API（delete）」的框下面寫著「必須包含 {item_id}。」
  • 「API headers」：「讀取 API（read）」的網址以 https:// 開頭時才會出現。這些 header（例如 Authorization）會加密存起來，只有網站在呼叫外部 API 時才會帶上，客服人員的客戶面板拿不到它們。但有「管理聊天頻道」的人按「編輯」時，會在框裡再看到它們的值；這和頻道的密鑰不一樣，密鑰存好之後就不會再顯示。
  • 「啟用」。

網址的寫法：

  • 外部的網址以 https:// 開頭。
  • 外部的網址要是從外面連得到的位址。指向網站自己內部網路的網址存不進去，網域找不到的也一樣，訊息是「這個網址指向我們自己的網路裡面，不能用。外部 API 要是一個從外面連得到的位址。」網站每一次呼叫它之前，都會再查一次；那時它指向內部網路的話，網站不會呼叫它，卡片會顯示紅字「這個區塊的網址指向我們自己的網路裡面，不能呼叫。」
  • 同一個區塊的每一個網址，都要是同一種。
  • 網址裡可以放這些佔位符：{conversation_id} 是這段客戶對話；{user_id} 是在客戶資訊面板的會員綁定裡綁定的會員；{item_id} 是卡片上的一個項目。
  • 佔位符可以放在網址的路徑或 ? 後面，但不能放在主機名稱裡，例如 https://{user_id}.example.com/items 存不進去，訊息是「網址的主機名稱不能放佔位符。」

「區塊名稱」與「讀取 API（read）」都填了，「儲存」才按得下去。

這個框也接受網站內部的網址，這份使用說明不談它們。