FRIDAI 小編實作筆記

露天串接 AI 客服教學:申請 OPEN API 金鑰,AI 就能查商品、庫存和訂單

填露天 OPEN API 申請表、收到金鑰後貼到 FRIDAI,AI 客服就能回答露天賣場的商品、庫存和訂單問題。每一步都有畫面可以對照。

飲料店老闆微笑將餐點交給顧客

客人在私訊問「這個還有貨嗎?」「我的訂單到哪了?」,你得切到露天賣家中心查完再回,一忙起來訊息就堆成山。把賣場接上 FRIDAI 之後,這些問題 AI 會自己去露天查好再回答。申請表五分鐘就能填完,等金鑰寄到後,連接也只要一分鐘。

教學流程圖|露天串接 AI 客服教學:申請 OPEN API 金鑰,AI 就能查商品、庫存和訂單
打開露天 OPEN API 申請流程下一步填申請表並勾選商品和訂單 API下一步收到金鑰檔案和文件密碼下一步把三組金鑰貼到 FRIDAI下一步卡片顯示已連接和最近訂單下一步用模擬測試問一次商品
露天 OPEN API 串接 FRIDAI:填申請表、收金鑰、貼到 FRIDAI、測試一次
圖解|露天 OPEN API 串接 FRIDAI

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

接好之後,客人傳私訊問商品和訂單,AI 會即時查你的露天賣場再回答:

客人問的事AI 怎麼回
你們賣什麼列出賣場商品,附上商品連結
有沒有這個商品用商品名稱或賣家編號搜尋
還有沒有貨查庫存和規格,缺貨就直接說明
訂單到哪了核對買家資料後,告訴他訂單狀態

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

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

開始前:準備好這三件事

  1. 你的露天賣家帳號:金鑰綁定賣家帳號,要用實際在賣東西的那個帳號申請。
  2. 一支台灣手機門號:申請表要填台灣門號,露天會用它聯絡你、傳檔案密碼。
  3. 一個 FRIDAI 訂閱:整合服務在 FRIDAI 後台左側選單,選好要接露天的品牌帳號再進去。

步驟一:打開露天的 OPEN API 申請流程

到露天幫助中心搜尋「露天市集 OPEN API 申請流程」,打開後點「1.1 申請API」第一點的「[露天市集]OPEN API 串接申請表」連結。

露天幫助中心的 OPEN API 申請流程,第一點是線上申請表連結
露天幫助中心的 OPEN API 申請流程,第一點是線上申請表連結

步驟二:填寫 OPEN API 串接申請表

填露天帳號和身分

「請問您的露天帳號?」填你登入露天用的帳號。身分依賣場實際狀況選「個人賣家」或「法人賣家」。

申請表的露天帳號欄位與身分選項,身分選個人賣家
申請表的露天帳號欄位與身分選項,身分選個人賣家

勾選商品 API 和訂單 API

「請問您想要串接的API為?」勾選「商品API」和「訂單API」。AI 查商品和庫存靠商品 API,查訂單靠訂單 API,兩個都要勾。

API 選項勾選商品API和訂單API
API 選項勾選商品API和訂單API

填聯絡人、Email 和手機

依序填串接聯絡人、聯絡 Email 和手機號碼。這兩個聯絡方式會決定你收到金鑰的地方,所以要填你平常收得到的:

  • Email:金鑰檔案會寄到這裡。
  • 手機號碼:要是台灣門號,露天會用它傳檔案密碼。
申請表的串接聯絡人、聯絡 Email 與手機號碼欄位
申請表的串接聯絡人、聯絡 Email 與手機號碼欄位

「預計完成串接的時間」是選填,可以直接填申請當週的日期。全部填好後按「提交」。

步驟三:收到金鑰檔案,打開並找到三組金鑰

送出後,露天會在 3 個工作天內寄出主旨為「[露天市集] OPEN API 申請通知」的信,附件是以露天帳號命名的 PDF 金鑰檔案。打開檔案用的「文件密碼」寫在信裡;信裡沒有密碼時,就看手機簡訊。

露天寄來的 OPEN API 申請通知信,內含文件密碼與 PDF 金鑰檔案
露天寄來的 OPEN API 申請通知信,內含文件密碼與 PDF 金鑰檔案

用文件密碼打開 PDF,裡面有三組金鑰:

金鑰檔案裡的貼到 FRIDAI 的
API KeyAPI Key 欄位
Secret KeySecret Key 欄位
Salt KeySalt Key 欄位

超過 3 個工作天還沒收到,就加露天 OPEN API 的官方 LINE(@858qlhod)問專人,也記得看一下垃圾信匣。

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

打開 FRIDAI 後台的「整合服務」,在電商平台往下找到「露天市集」卡片,填這四個欄位:

  1. 露天帳號:你登入露天用的帳號。
  2. API Key:貼金鑰檔案裡的 API Key。
  3. Secret Key:貼金鑰檔案裡的 Secret Key。
  4. Salt Key:貼金鑰檔案裡的 Salt Key。
FRIDAI 整合服務的露天市集卡片,填露天帳號、API Key、Secret Key 與 Salt Key
FRIDAI 整合服務的露天市集卡片,填露天帳號、API Key、Secret Key 與 Salt Key

按「連接露天」,FRIDAI 會先跟露天確認金鑰可以使用,再加密保存。

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

連接成功後,卡片右上角變成「已連接」,下方顯示你的露天帳號和「最近訂單」,每筆訂單都有商品、狀態、日期和金額。看得到訂單,就代表 FRIDAI 已經讀得到你的賣場。

連接成功的露天市集卡片,顯示已連接與最近訂單
連接成功的露天市集卡片,顯示已連接與最近訂單

如果最近 3 個月沒有訂單,卡片會寫「最近 3 個月還沒有訂單」,這也是連接成功的狀態。

步驟六:用模擬測試問一次,看 AI 怎麼回

到左側選單的「AI 規則(筆記本)」,點「測試與優化」,再按右邊的「測試」打開模擬測試視窗,輸入「你們有賣什麼?」。AI 會去露天查好,回覆賣場商品和「查看商品」按鈕。

模擬測試視窗,客人問你們有賣什麼,AI 回覆賣場商品與查看商品按鈕
模擬測試視窗,客人問你們有賣什麼,AI 回覆賣場商品與查看商品按鈕

接著可以照這三句再試一輪,把商品、庫存和訂單都測過:

○○ 還有貨嗎?
我的訂單編號是 ○○○○,還沒出貨嗎?
我下單的手機是 09xx-xxx-xxx

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

連不上時:看訊息照著改

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

畫面訊息怎麼處理
露天不接受這組金鑰確認三串都完整貼上、沒貼錯欄位,而且是露天最新寄來的那組
請填露天帳號填好帳號,三串金鑰都要貼滿,前後不要多空格
露天暫時沒有回應露天端忙線,過幾分鐘再按一次連接
需要新金鑰重新申請過或帳號有異動時會出現,貼上露天最新寄來的金鑰
暫時讀不到露天訂單連線還在,過一會兒重新整理頁面

看到「不接受這組金鑰」時,對照金鑰檔案把三串重新貼一次,特別確認 Secret Key 和 Salt Key 沒有對調。

總結:填好申請表,金鑰一到就能接上

FRIDAI

FRIDAI 的小叮嚀

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

  • 用實際在賣東西的露天帳號填申請表,勾選商品 API 和訂單 API
  • Email 和手機填你收得到的,金鑰檔案和文件密碼都靠它們送到你手上
  • 把 API Key、Secret Key、Salt Key 和露天帳號貼到 FRIDAI 的露天市集卡片
  • 卡片顯示「已連接」後,用模擬測試問一次「你們有賣什麼?」

金鑰一到就丟給我試跑吧,看我怎麼回你的客人 ☺️

常見問題

FRIDAI 串接露天要另外付費嗎?

串接功能包含在 FRIDAI 訂閱裡,在整合服務貼上金鑰就能使用,不用另外加購。

申請露天 OPEN API 要等多久?

露天的申請流程寫明送出表單後 3 個工作天內會寄出金鑰。信件主旨是「[露天市集] OPEN API 申請通知」,附件是 PDF 金鑰檔案,文件密碼寫在信裡或用簡訊傳來。

通知 API 要勾嗎?

不用。AI 是在客人來問的時候才去露天查資料,勾選商品 API 和訂單 API 就夠了。

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

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

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

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

我有好幾個露天帳號,可以都接上嗎?

一個 FRIDAI 品牌帳號接一個露天賣家帳號。每個露天帳號各自申請金鑰,再分別接到對應的 FRIDAI 品牌帳號。

不想接了要怎麼中斷?

在 FRIDAI 整合服務的露天市集卡片按「中斷連接」,AI 就不會再查你的賣場,保存的金鑰也會一起移除。

FRIDAI 能怎麼幫你

FRIDAI 把私訊、留言和你的露天賣場接在同一條流程:客人傳私訊問商品、庫存和訂單,AI 直接查好賣場資料再回答,真的需要你處理的再通知你接手。用 Shopify 開店的話,也可以看 Shopify 串接 AI 客服教學。

官方資料來源