FRIDAI 小編實作筆記

SHOPLINE 串接 AI 客服教學:開通 OpenAPI、產生金鑰,AI 就能查商品、庫存和訂單

開通 SHOPLINE OpenAPI 後,新增 API 專用管理員、在 API Auth 勾商品和訂單權限產生金鑰,貼到 FRIDAI,AI 客服就能查商品和訂單。

服飾店老闆在櫃檯摺衣服,微笑招呼拿著購物袋的客人

客人在私訊問「這件還有 M 號嗎?」「我的訂單寄了沒?」,你得切到 SHOPLINE 後台查完再回,一忙起來訊息就堆成山。把商店接上 FRIDAI 之後,這些問題 AI 會自己去 SHOPLINE 查好再回答。OpenAPI 開通好之後,產生金鑰到連接完成大約五分鐘。

教學流程圖|SHOPLINE 串接 AI 客服教學:開通 OpenAPI、產生金鑰,AI 就能查商品、庫存和訂單
請 SHOPLINE 開通 OpenAPI下一步新增一位 API 專用管理員下一步在 API Auth 勾商品和訂單權限下一步按 Generate 產生金鑰並複製下一步貼到 FRIDAI 整合服務下一步卡片顯示已連接
SHOPLINE OpenAPI 串接 FRIDAI:開通 OpenAPI、新增管理員、產生金鑰、貼到 FRIDAI
圖解|SHOPLINE OpenAPI 串接 FRIDAI

接上 SHOPLINE 之後,AI 客服能幫你做什麼?

接好之後,客人在 Instagram、Facebook、LINE 或網站聊天問商品和訂單,AI 會即時查你的 SHOPLINE 商店再回答:

客人問的事AI 怎麼回
有沒有這個商品用商品名稱或貨號搜尋,附上商品連結
還有沒有貨查各規格的庫存,有尺寸或顏色的商品會分開說哪個有貨
訂單到哪了核對買家資料後,告訴他訂單狀態和物流單號

訂單資料一定先核對身分:客人要提供訂單編號,加上下單時填的 Email 或手機,對得上才會說訂單內容。別人只拿到訂單編號也問不到,客人的資料安全,你也安心。

整個串接只讀不寫:FRIDAI 只會查商品、庫存和訂單,不會改你的商品、價格或訂單。

開始前:準備好這三件事

  1. SHOPLINE 的 OpenAPI 權限:聯絡你的 SHOPLINE 窗口或客服,說要開通 OpenAPI。SHOPLINE 官方文件寫明,開通後管理員設定裡才會出現「API Auth」。
  2. 商店的管理員帳號:要能新增管理員、調整權限,用店長帳號登入最順。
  3. 一個 FRIDAI 訂閱:整合服務在 FRIDAI 後台左側選單的「整合服務」,選好要接 SHOPLINE 的品牌帳號再進去。

步驟一:新增一位 API 專用管理員

打開管理員設定,按新增

登入 SHOPLINE 後台,到「設定 → 管理員設定」(英文介面是 Settings → Admin & Security Setting),在管理員列表右上角按「Add」新增。

SHOPLINE 官方 OpenAPI 文件的畫面:管理員設定頁,管理員列表右上角的 Add 按鈕
SHOPLINE 官方 OpenAPI 文件的畫面:管理員設定頁,管理員列表右上角的 Add 按鈕

填這位管理員的 Email

Email 填一個你們公司收得到的信箱,例如專門給系統用的信箱。這位管理員只用來產生 FRIDAI 的金鑰,之後要停用也很好管理。填好按「Add」。

SHOPLINE 官方 OpenAPI 文件的畫面:新增管理員頁填 Email,再按 Add
SHOPLINE 官方 OpenAPI 文件的畫面:新增管理員頁填 Email,再按 Add

步驟二:打開 API Auth,勾商品和訂單的權限

編輯剛新增的管理員

回到管理員列表,在剛新增的那位管理員右邊按「Edit」。

SHOPLINE 官方 OpenAPI 文件的畫面:管理員列表中按新管理員的 Edit
SHOPLINE 官方 OpenAPI 文件的畫面:管理員列表中按新管理員的 Edit

切到 API Auth 分頁勾權限

切到「API Auth」分頁,往下找到「products」(商品)和「orders」(訂單)兩組,把這兩組的權限勾起來。AI 查商品和庫存靠 products,查訂單靠 orders,兩組都要勾;FRIDAI 只會讀資料,不會用到新增、修改或刪除。

SHOPLINE 官方 OpenAPI 文件的畫面:管理員編輯頁的 API Auth 分頁與權限勾選
SHOPLINE 官方 OpenAPI 文件的畫面:管理員編輯頁的 API Auth 分頁與權限勾選

步驟三:按 Generate 產生金鑰,複製起來

產生金鑰

權限勾好後拉到最下面,按「Generate」。上面的「Expired At」是到期時間,可以不填:SHOPLINE 官方文件寫明不設到期時間,金鑰就不會過期,AI 也就不會哪天突然查不到。

SHOPLINE 官方 OpenAPI 文件的畫面:到期時間為選填,按 Generate 產生金鑰
SHOPLINE 官方 OpenAPI 文件的畫面:到期時間為選填,按 Generate 產生金鑰

複製 Token

產生後,「Token」欄位會出現一整串金鑰,整串複製起來。

SHOPLINE 官方 OpenAPI 文件的畫面:產生後的 Token 欄位
SHOPLINE 官方 OpenAPI 文件的畫面:產生後的 Token 欄位

不要加 IP 白名單

Token 下面有一個「+New IP Whitelist」(新增 IP 白名單),這個不要按。FRIDAI 主機的 IP 不固定,加了白名單之後 FRIDAI 會連不上。

SHOPLINE 官方 OpenAPI 文件的畫面:Token 下方的新增 IP 白名單按鈕與視窗
SHOPLINE 官方 OpenAPI 文件的畫面:Token 下方的新增 IP 白名單按鈕與視窗

步驟四:把金鑰貼到 FRIDAI,按「連接 SHOPLINE」

打開 FRIDAI 後台的「整合服務」,在電商平台找到「SHOPLINE」卡片,把金鑰整串貼到「SHOPLINE OpenAPI 金鑰」欄位,按「連接 SHOPLINE」。

FRIDAI 整合服務的 SHOPLINE 卡片,貼上 OpenAPI 金鑰再按連接 SHOPLINE
FRIDAI 整合服務的 SHOPLINE 卡片,貼上 OpenAPI 金鑰再按連接 SHOPLINE

FRIDAI 會先跟 SHOPLINE 確認金鑰可以使用,再加密保存。

步驟五:確認卡片顯示「已連接」

連接成功後,卡片右上角變成「已連接」,下方顯示你的商店名稱和網址。

連接成功的 SHOPLINE 卡片,顯示已連接、商店名稱與網址
連接成功的 SHOPLINE 卡片,顯示已連接、商店名稱與網址

接好之後,用你自己的帳號傳這三句私訊給品牌試試,把商品、庫存和訂單都測過:

你們有賣○○嗎?
○○ 還有 M 號嗎?
我的訂單編號是 ○○○○,寄出了嗎?

第三句問訂單時,AI 會先請客人提供下單時的 Email 或手機。補上正確資料後,它才會回訂單狀態,這正是你要的流程。

連不上時:看訊息照著改

按下連接後如果沒有成功,卡片上會直接告訴你卡在哪裡。對照這張表處理:

畫面訊息怎麼處理
這看起來不像 SHOPLINE 金鑰回到 API Auth 頁,把 Token 整串重新複製,前後不要多空格
SHOPLINE 不接受這組金鑰確認金鑰沒過期、products 和 orders 都有勾,而且沒有加 IP 白名單
需要新金鑰原本的金鑰過期或被刪掉了,照步驟二、三重新產生一組貼上

看到「不接受這組金鑰」時,最常見的是加了 IP 白名單。到 Token 下方把白名單刪掉,再按一次連接就好。

總結:開通 OpenAPI,五分鐘接好 SHOPLINE

FRIDAI

FRIDAI 的小叮嚀

SHOPLINE 接上之後,我就能自己去你的商店查商品、庫存和訂單再回客人,你不用一直切後台了。照這幾點做最順:

  • 先請 SHOPLINE 開通 OpenAPI,管理員編輯頁看得到「API Auth」就是好了
  • 新增一位 API 專用管理員,在 API Auth 勾 products 和 orders 兩組權限
  • 到期時間不填,按「Generate」後把 Token 整串複製
  • 不要加 IP 白名單,金鑰貼到 FRIDAI 的 SHOPLINE 卡片,看到「已連接」就完成

接好之後,丟一句「這件還有貨嗎?」到你的私訊試試看,看我怎麼回答 ☺️

常見問題

FRIDAI 串接 SHOPLINE 要另外付費嗎?

串接功能包含在 FRIDAI 訂閱裡,在整合服務貼上金鑰就能使用,不用另外加購。OpenAPI 的開通條件請直接問你的 SHOPLINE 窗口。

管理員設定裡找不到 API Auth 怎麼辦?

代表商店還沒開通 OpenAPI。聯絡 SHOPLINE 窗口或客服申請開通,通過後重新整理管理員編輯頁就會出現。

金鑰會過期嗎?

產生時「Expired At」不填,金鑰就不會過期。有填到期時間的話,到期後卡片會顯示「需要新金鑰」,照步驟重新產生一組貼上就好。

FRIDAI 會修改我的商品或訂單嗎?

不會。FRIDAI 只讀取商品、庫存和訂單,不會更改商店的任何資料。

客人問訂單時,AI 會把訂單資料給任何人嗎?

不會。客人要提供訂單編號,再加上下單時填的 Email 或手機,對得上才會回答訂單內容。

我有好幾家 SHOPLINE 商店,可以都接上嗎?

一個 FRIDAI 品牌帳號接一家商店。每家商店各自產生金鑰,再分別接到對應的 FRIDAI 品牌帳號。

不想接了要怎麼中斷?

在 FRIDAI 整合服務的 SHOPLINE 卡片按「中斷連接」,AI 就不會再查你的商店,保存的金鑰也會一起移除。想徹底停用,也可以回到 SHOPLINE 後台刪掉這位 API 專用管理員的金鑰。

FRIDAI 能怎麼幫你

FRIDAI 把私訊、留言和你的 SHOPLINE 商店接在同一條流程:客人在 Instagram、Facebook、LINE 或網站聊天問商品、庫存和訂單,AI 直接查好商店資料再回答,真的需要你處理的再通知你接手。用其他平台開店的話,也可以看 Shopify 串接 AI 客服教學 和 CYBERBIZ 串接 AI 客服教學。

官方資料來源