FRIDAI 小編實作筆記

CYBERBIZ 串接 AI 客服教學:建立自訂應用程式、貼上 API Token,AI 就能查商品、庫存和訂單

在 CYBERBIZ 建立自訂應用程式、權限選 read_products 和 read_orders,把 API Token 貼到 FRIDAI,AI 客服就能查商品、庫存和訂單。每一步都有畫面。

保養品店老闆娘微笑把商品遞給客人

客人在私訊問「這件還有 M 號嗎?」「我的訂單寄了沒?」,你得切到 CYBERBIZ 後台查完再回,一忙起來訊息就堆成山。把商店接上 FRIDAI 之後,這些問題 AI 會自己去 CYBERBIZ 查好再回答。整個設定大約三分鐘,每一步都有畫面可以對照。

教學流程圖|CYBERBIZ 串接 AI 客服教學:建立自訂應用程式、貼上 API Token,AI 就能查商品、庫存和訂單
打開我的擴充服務的自訂分頁下一步建立自訂應用程式並選讀取權限下一步複製 API Token下一步貼到 FRIDAI 整合服務下一步卡片顯示已連接
CYBERBIZ API Token 串接 FRIDAI:打開自訂分頁、建立應用程式、複製 API Token、貼到 FRIDAI
圖解|CYBERBIZ API Token 串接 FRIDAI

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

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

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

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

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

開始前:準備好這三件事

  1. CYBERBIZ 的「API 與 Webhook 串接」功能:CYBERBIZ 官方說明寫明,企業版內建這個功能;PLUS 方案要在選配模組選它。後台找不到「自訂」分頁的話,請 CYBERBIZ 客服幫你開通。
  2. 有「自訂應用程式」權限的帳號:用店長帳號最順;員工帳號要先在「管理中心 → 網站權限」開這個權限。
  3. 一個 FRIDAI 訂閱:整合服務在 FRIDAI 後台左側選單的「整合服務」,選好要接 CYBERBIZ 的品牌帳號再進去。

步驟一:打開「我的擴充服務」,建立自訂應用程式

登入 CYBERBIZ 後台,左側選單點「APP MARKET」→「我的擴充服務」,切到「自訂」分頁,按「建立自訂應用程式」。

CYBERBIZ 官方說明的畫面:我的擴充服務的自訂分頁,中間有建立自訂應用程式按鈕
CYBERBIZ 官方說明的畫面:我的擴充服務的自訂分頁,中間有建立自訂應用程式按鈕

步驟二:填名稱,API Scopes 選 read_products 和 read_orders

在「基本設定」填這兩項:

  1. 自訂應用程式名稱:填 FRIDAI,之後看到就知道是給誰用的。
  2. API Scopes:選 read_products(讀商品)和 read_orders(讀訂單)。AI 查商品和庫存靠 read_products,查訂單靠 read_orders,兩個都要選;write_ 開頭的寫入權限都不用選。

Webhook 不用設定,填好按儲存。

CYBERBIZ 官方說明的畫面:自訂應用程式頁的名稱欄位、APP Secret、API Token 與 API Scopes
CYBERBIZ 官方說明的畫面:自訂應用程式頁的名稱欄位、APP Secret、API Token 與 API Scopes

步驟三:複製 API Token

儲存後,系統會產生「APP Secret」和「API Token」。FRIDAI 要的是 API Token:按它右邊的「複製」。

CYBERBIZ 官方說明的畫面:自訂應用程式頁的 API Token 欄位與複製按鈕
CYBERBIZ 官方說明的畫面:自訂應用程式頁的 API Token 欄位與複製按鈕

API Token 旁邊的「更換」會換一組新的,舊的那組就失效了。接好 FRIDAI 之後不要按它;真的換了,記得回 FRIDAI 貼上新的。

步驟四:把 API Token 貼到 FRIDAI,按「連接 CYBERBIZ」

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

FRIDAI 整合服務的 CYBERBIZ 卡片,貼上 API Token 再按連接 CYBERBIZ
FRIDAI 整合服務的 CYBERBIZ 卡片,貼上 API Token 再按連接 CYBERBIZ

FRIDAI 會先跟 CYBERBIZ 確認 API Token 讀得到商品和訂單,再加密保存。

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

連接成功後,卡片右上角變成「已連接」,下方顯示你的商店名稱和網址。API Token 有到期日的話,卡片也會顯示到期日,到期前換一組新的貼上就好。

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

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

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

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

連不上時:看訊息照著改

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

畫面訊息怎麼處理
這看起來不像 CYBERBIZ 的 API Token回到自訂應用程式頁,按 API Token 右邊的「複製」再貼一次
CYBERBIZ 不接受這組 API Token確認是整串複製,而且這個自訂應用程式還在
這組 API Token 沒有讀商品或訂單的權限到自訂應用程式的 API Scopes 加上 read_products 和 read_orders,儲存後再貼一次
這組 API Token 一天內就會過期確認貼的是自訂應用程式頁上的 API Token,不是 APP Secret
CYBERBIZ 暫時沒有回應CYBERBIZ 端忙線,過幾分鐘再按一次連接
需要新金鑰API Token 過期或應用程式被刪掉了,照步驟三重新複製一組貼上

最常見的是貼成了 APP Secret:兩個欄位長得很像,FRIDAI 要的是下面那個「API Token」。

總結:建一個自訂應用程式,三分鐘接好 CYBERBIZ

FRIDAI

FRIDAI 的小叮嚀

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

  • 到「APP MARKET → 我的擴充服務 → 自訂」按「建立自訂應用程式」
  • 名稱填 FRIDAI,API Scopes 選 read_products 和 read_orders,按儲存
  • 複製 API Token(不是 APP Secret),貼到 FRIDAI 的 CYBERBIZ 卡片
  • 看到「已連接」就完成,之後別按「更換」,換了就要回 FRIDAI 重貼

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

常見問題

FRIDAI 串接 CYBERBIZ 要另外付費嗎?

FRIDAI 這邊不用,串接功能包含在 FRIDAI 訂閱裡。CYBERBIZ 那邊要有「API 與 Webhook 串接」功能:企業版內建,PLUS 方案在選配模組選它。

後台找不到「自訂」分頁怎麼辦?

代表商店還沒有「API 與 Webhook 串接」功能,或你的帳號沒有自訂應用程式權限。先確認帳號權限,還是看不到就請 CYBERBIZ 客服開通。

要設定 Webhook 嗎?

不用。AI 是在客人來問的時候才去 CYBERBIZ 查資料,只要 API Token 就夠了。

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

不會。權限只選 read_products 和 read_orders 兩個讀取權限,FRIDAI 只能查商品、庫存和訂單,沒辦法修改任何資料。

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

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

不想接了要怎麼中斷?

在 FRIDAI 整合服務的 CYBERBIZ 卡片按「中斷連接」,AI 就不會再查你的商店,保存的 API Token 也會一起移除。想徹底停用,也可以回到 CYBERBIZ 刪掉這個自訂應用程式。

FRIDAI 能怎麼幫你

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

官方資料來源