TikTok Shop 客戶服務 API 審核資格:2026 申請檢查清單
TikTok Shop Customer Service API 是必須經過專案審核的自訂權限,並非一般 TikTok 私訊 API。依 TikTok 現行文件,申請者必須提出可運作的應用程式內聊天、訂單、出貨履約與售後整合,並具備 1,000 家已授權賣家或每日 100 萬次 API 呼叫。商家自行開發的 TikTok Shop Seller 應用程式可爭取特別審核,但存取店鋪資料前仍須取得該賣家授權。
重點摘要
- Customer Service API 處理的是 TikTok Shop 買家與賣家之間的客服對話,不會提供一般 TikTok 帳號收到的所有私訊。
- 審核從產品證明開始:實際可用的聊天介面、對話紀錄,以及串接訂單、物流、退貨和退款的客服流程。
- TikTok 公開的規模門檻為 1,000 家已授權賣家或每日 100 萬次 API 呼叫;商家自研應用程式可進入特別審核程序。
- 自訂權限通過審核與各賣家個別授權是兩道關卡。兩者都完成後,應用程式才能讀取該店鋪的對話。
- 若真正需求是一般帳號的即時入站私訊,而非 TikTok Shop 買家客服,應另行評估架構,不要把兩種訊息場景混為一談。
哪些團隊符合 TikTok Shop 客戶服務 API 的申請資格?
TikTok 將 Customer Service API 定義為供獨立軟體服務商(ISV),以及自行建置客服工具的商家使用的自訂 API。合作夥伴或 ISV 必須在 Partner Center 將業務類別及應用程式或服務類別都設為 Customer Service,再申請對應的自訂權限。
官方 Customer Service API 概覽列出四個實際審核層次:
| 審核層次 | TikTok 要求的證明 | 為何重要 |
|---|---|---|
| 可運作的客服產品 | 使用者看得到的聊天視窗、對話清單與詳細資料、時間戳記、參與者,以及真實收發訊息流程 | 此 API 用來擴充既有客服產品,不是原型的第一個元件 |
| 電商情境 | 與對話連結的訂單、履約與售後介面 | 客服協助買家時,必須能查看訂單狀態、配送進度、退貨與退款資料 |
| 合作夥伴規模 | 至少 1,000 家已授權賣家或每日 100 萬次 API 呼叫 | Customer Service 是受限制的自訂權限,並非預設 API 類別 |
| 授權 | 應用程式取得自訂權限,且每一家賣家分別授權存取 | 權限審核通過不代表所有店鋪自動開放 |
TikTok 表示,歸類為 TikTok Shop Seller、由商家自有開發團隊建立的應用程式,可能取得特別核准。這是一條可送審的途徑,不是保證豁免;官方頁面並未承諾商家自有應用程式必定通過。
這是它與較廣泛的 TikTok 私訊 API 問題最重要的差異。一般 TikTok 開發者平台仍未提供普通帳號的即時收件匣端點;Shop Customer Service API 僅針對買賣雙方的電商客服對話,提供一條範圍有限且須審核的官方管道。
審核通過後實際開放哪些功能?
自訂權限通過、賣家也完成授權後,官方 API 可列出對話、取得訊息、傳送訊息並標示為已讀、管理客服設定、上傳買家訊息圖片,以及接收 New Conversation 和 New Message webhook。TikTok 參考文件將必要權限列為 seller.customer_service。
例如,官方 Get Conversation Messages 操作使用:
GET /customer_service/202309/conversations/{conversation_id}/messages
Required scope: seller.customer_service
這個端點屬於 TikTok Shop,並且需要賣家 access token;它不能替代 TikTok for Developers 的 Login Kit、Content Posting、Research 或 Data Portability 產品。既有的 TikTok 電商 API 功能界線整理說明了更完整的產品範圍;本檢查清單只處理如何取得受限制的 Customer Service 權限。
申請資料檢查清單
提出自訂權限申請前,先備妥完整的審核資料:
- 展示完整聊天產品。 提供未裁切的對話清單與詳細頁面,清楚顯示參與者身分、時間戳記、歷史紀錄及訊息收發流程。TikTok 要求螢幕截圖和簡短螢幕錄影;只有設計稿通常不足以證明產品已經運作。
- 把對話連結到電商資料。 展示訂單明細、配送狀態及相關退貨或退款狀態,並說明客服如何在實際對話中使用這些資訊。
- 證明採用的規模門檻。 提供 1,000 家已授權賣家的證明,或可顯示每日 100 萬次 API 呼叫的報表。商家自研 Seller 應用程式應交代商家主體、開發團隊及內部客服流程,不要預設特別審核等同自動豁免。
- 申請正確的自訂權限。 TikTok 的 access scope 指南指出,自訂權限須從 Partner Console → App & Service → Manage → Manage API 提出。確認應用程式已啟用
seller.customer_service。 - 另外測試賣家授權。 應用程式審核成功不等於已取得賣家 token。請驗證安裝與授權流程、保存店鋪識別碼與已授予權限,並處理撤銷授權。
- 送出前再次確認官方頁面。 自訂權限規則可能依市場與帳號而異。本文記錄的是 2026 年 7 月 18 日可見文件;最後仍應以你在 Partner Center 帳號看到的申請內容為準。
先決定真正需要哪一種訊息介面
| 你的需求 | 正確介面 | 主要限制 |
|---|---|---|
| 在既有電商客服系統中服務 TikTok Shop 買家 | TikTok Shop Customer Service API | 自訂權限審核、產品證明、規模與賣家授權 |
| 對符合資格的既有買家發送核准的電商觸達訊息 | TikTok Shop Customer Engagement API | 獨立功能權限、收件者資格、範本與頻率規則 |
| 匯出使用者已授權的 TikTok 資料 | TikTok Data Portability API | 審核、支援地區、使用者同意與匯出;不是即時收件匣 |
| 接收已連結普通帳號所支援的入站訊息 | UnifyPort 非官方介面 | 獨立帳號連線與 webhook 維運模式;不含 TikTok Shop 權限 |
開始開發前先完成這項判斷。需要訂單連結 Shop 對話的團隊,應申請官方 Customer Service API;需要一般帳號即時入站訊息流的團隊,不該為了讓另一種產品看似符合資格,額外製作訂單與履約畫面。
UnifyPort 適合哪一種情境?
UnifyPort 不會授予 seller.customer_service、核准 Partner Center 應用程式、代替店鋪授權、開放 Seller Center 訂單資料,也不會提供 TikTok 官方客服與服務指標。如果這些電商功能是必要條件,請使用官方 API。
UnifyPort 適用的是另一種情境:一般帳號的入站訊息。UnifyPort Exporter 發布與連線指南記錄了瀏覽器輔助的 TikTok 工作階段交接;之後 API 會透過標準 message.received webhook 事件格式傳送所支援的入站訊息。以下為假設性的入站事件,欄位結構與其他 provider 的文件一致:
{
"id": "evt_7b9f2d41c6",
"type": "message.received",
"provider": "tiktok",
"account_id": "acc_4e81a7",
"occurred_at": "2026-07-18T03:14:25Z",
"data": {
"conversation": { "id": "7421183065", "type": "user" },
"sender": { "id": "7369021841", "type": "user", "name": "Mina" },
"message": {
"id": "msg_20260718_031425",
"type": "text",
"text": "Is this item available in Thailand?",
"direction": "inbound",
"sent_at": "2026-07-18T03:14:24Z"
}
}
}
若 webhook 端點設有 signing_secret,請先依原始 request body 驗證 X-Device-Timestamp 和 X-Device-Signature,再儲存事件。標準事件類型與 payload 參考是查閱事件格式的深入文件;依賴任何出站動作前,也應確認目前 provider 的功能文件。
限制與取捨
若客服需要 Shop 買家身分、訂單連結、對話生命週期、核准的出站行為或平台原生服務操作,TikTok Shop 官方管道更適合。電商授權和平台政策都能留在 TikTok 支援的模式內。
非官方介面無法讓應用程式取得 Customer Service API 資格,不能把一般私訊變成 Shop 對話、發起官方買家活動,或重現 Seller Center 資料。它較聚焦的價值,是為支援的已連結帳號提供標準入站事件流。只有已具備合法且可靠的資料來源時,才應在自己的系統維護訂單和履約紀錄。
常見問題
TikTok Shop 客戶服務 API 的審核資格有哪些?
TikTok 目前要求可運作的應用程式內聊天視窗、清楚可見的訂單、履約及售後整合,並具備 1,000 家已授權賣家或每日 100 萬次 API 呼叫。應用程式須申請 Customer Service 自訂權限,各賣家也必須個別授權。
單一 TikTok Shop 商家可以申請 Customer Service API 嗎?
有可能,但不會自動通過。TikTok 表示,TikTok Shop Seller 類別中的商家自研應用程式可能取得特別核准。商家應提出開發團隊、已運作聊天產品、電商情境與預計客服流程的證明。
Customer Service API 是一般 TikTok 私訊 API 嗎?
不是。它只涵蓋 TikTok Shop 買家與賣家之間的客服對話,不會提供創作者或普通 TikTok 帳號收到的所有私訊。
應用程式通過審核後,還需要賣家授權嗎?
需要。自訂權限審核讓應用程式取得使用該功能的資格;賣家授權才會開放特定店鋪。兩道關卡都必須完成。
應用程式目前不符合資格,該怎麼做?
先釐清需求。官方 Shop 客服可繼續使用 Seller Center;缺少產品證明的團隊應補齊後重新申請;若不需要 Shop 專屬身分、訂單和客服功能,則可評估一般帳號的入站介面。
下一步
若你的產品確實承擔 Shop 買家客服,請以 TikTok 的 Customer Service API 概覽作為申請清單,並在自己的 Partner Center 帳號中再次確認條件。若需求是一般帳號的入站訊息分流,請先閱讀 UnifyPort 的標準 webhook 事件參考,再選擇獨立的帳號連線路徑。
資料來源
以下 TikTok 官方來源已於 2026 年 7 月 18 日查核: