讓 AI 助理查詢 SHOPLINE 訂單、庫存與顧客彙總資料(功能開發中)

開 SHOPLINE 商店的人常遇到同一個問題:後台報表看得到數字,但想追問「上週哪些商品庫存快見底」或「會員等級的顧客分佈長怎樣」,還是得手動匯出、貼進試算表、自己算。Nexus 正在打造讓 Claude、ChatGPT 這類 AI 助理 直接讀取你的 SHOPLINE 商店資料的整合:連接完成後,只需貼上一組 API token,就能用中文提問。

> 目前狀態: 這項整合已在內部完成開發與本機測試,尚未對外開放。 > 公開／正式環境上線前,仍需完成實際 API token 的連線驗證與 > 部署核准;以下步驟說明的是啟用後的操作流程,不代表現在就能連接。

Nexus 能讀取 SHOPLINE 的哪些資料

Nexus 對 SHOPLINE 的存取是唯讀的,不會建立、修改或刪除任何商店資料。目前支援三個資料面向:

• 銷售:訂單數、營收、折扣、平均客單價、不重複顧客數,可依日期、
• 訂單狀態或 UTM 來源分組;也支援品項層級的銷售明細。
• 庫存:目前庫存快照(在庫、可售、成本、售價、狀態)與庫存週轉
• (每日銷售量、庫存可支撐天數、缺貨風險分級)。
• 顧客(僅彙總):依註冊區間統計的顧客數、會員/非會員與等級分佈、
• 行銷訂閱比例、目前累計客單價,以及「終身回購」統計——依目前累計訂單數
• 判斷是否回購(order_count > 1)的顧客數與比例,不是特定期間內的新舊客
• 比較。這裡刻意不提供查詢個別顧客的模式,姓名、email、電話等個資
• 欄位一律不會出現在回傳結果、快取或日誌中,樣本數過小的分組也會被自動
• 隱藏。

開放後的設定步驟

以下步驟描述這項整合對外開放後的操作方式,協助你預先了解流程;目前尚無法實際連接。

步驟一:在 SHOPLINE 後台建立 API token

登入商店後台,依序點選「商店設定」→「員工設定」→「API Auth」,新增一組 token 並勾選訂單、商品／庫存、顧客的讀取權限。建議設定到期日,但不要 啟用 IP 白名單——Nexus 目前沒有固定對外 IP,啟用白名單會導致連線失敗。

步驟二:在 Nexus 貼上 token

到 Nexus 的連接管理頁面,於 SHOPLINE 卡片貼上剛才複製的 token 並送出。 Nexus 會先驗證 token 是否有效,再讀取商店資訊——驗證失敗不會建立任何連接。驗證成功後,選取要開放給 AI 助理查詢的商店即可。

步驟三:開始提問(開放後)

接上 AI 助理後,可以直接問:

• 「上週的訂單數、營收與平均客單價是多少?」
• 「哪些商品的庫存可支撐天數少於 7 天?」
• 「目前會員等級的人數分佈如何?」

常見問題

這樣安全嗎? Nexus 只會讀取資料,不會建立、修改或刪除任何 SHOPLINE 資料。API token 以加密方式儲存,且不會被記錄在任何頁面或日誌中。

可以查到個別顧客的資料嗎? 不行。顧客資料一律以彙總形式回傳(人數、比例、分佈),沒有查詢個別顧客的模式。SHOPLINE 顧客 API 回傳的原始資料可能包含姓名、email、電話等個資欄位,但正規化流程會依允許清單立即捨棄這些欄位——不會保留、回傳、快取、記錄到日誌,也不會提供給 AI 助理。

這個連接器跟廣告平台的數據可以直接相加嗎? 不行。SHOPLINE 的營收是商店實際入帳的訂單金額,廣告平台(如 Meta、 Google Ads)回傳的是各自歸因定義下的轉換金額,兩者定義不同,Nexus 不會把兩者混算成單一數字。

支援哪一個 SHOPLINE 產品? 本篇與 Nexus 的整合僅支援 shoplineapp.com(商店後台版)的 Open API, 不支援全球版 shopline.com 產品。

工具怎麼選

• 手動匯出報表:資料最完整,但每次都要匯出、貼試算表、自己算,
• 沒辦法即時問答。
• SHOPLINE 內建報表:即時,但只能看固定維度,無法自由組合問題。
• Empower Nexus:開放後,接上 AI 助理即可用自然語言自由提問,並能
• 跟同一工作區裡的廣告平台資料放在一起看。SHOPLINE 整合目前尚未對外
• 開放,14 天試用與最新開放進度請見方案說明。