← 所有文章
對比選型

TikTok Business Messaging API 定 QR 授權收件箱？私訊接入決策指南

如果你想將 TikTok 私訊接入自己後端，第一步唔係即刻揀 API，而係先決定你圍繞邊種帳號身份設計。TikTok 官方 Business Messaging API 適合營運 TikTok Business Account、需要平台原生商務訊息能力嘅團隊；透過 UnifyPort 做 QR 授權收件箱，則適合現有 TikTok 帳號已經收緊客戶訊息，而團隊想將 TikTok 同 WhatsApp、LINE、Zalo、Telegram、X 一齊送入同一個簽名 webhook 嘅情況。

重點

  • TikTok 官方 API for Business 文件列出 Business Messaging API 嘅私訊能力，包括 conversations、messages、media、webhook configuration 同 automatic-message management。
  • 呢條官方路徑應該當成 TikTok Business Account integration 評估，而唔係通用多平台客服收件箱。
  • UnifyPort 嘅 TikTok 路徑使用標準 qrcode 授權流程；第一次啟動 QR 授權時可能未有 QR URL，所以輪詢檢查係正常流程。
  • 如要做共享客服 queue，先統一接收 message.received，再接 CRM、AI triage、標籤或人工處理。

TikTok Business Messaging API 適合咩場景

TikTok 官方 API for Business 文件將 Business Messaging API 描述為整合 direct messaging capabilities、即時收發訊息、設定 automated replies 同管理 message threads 嘅方式。官方文件導覽亦列出相關操作：send a message to a conversation、get conversations、get messages、upload image、download image or video from a message、check Business Account capability，以及 create Business Messaging webhook configuration。

呢個係 TikTok 官方路徑。如果你嘅產品核心係 TikTok Business Account、廣告相關會話、平台原生自動訊息或官方商務訊息能力，應該優先評估呢條路。同時要喺 TikTok 官方文件核對 access、authorization、data security review、regional review、limits 同 return codes，再決定上線時間表。

QR 授權收件箱解決咩問題

QR 授權收件箱問嘅係另一條問題：「可唔可以將營運本身用緊嘅 TikTok 收件箱接到自己 webhook？」喺 UnifyPort 入面，TikTok 同其他 QR 類 channel 共用同一套帳號同授權模型：

  1. 建立 account，設定 provider: "tiktok" 同 auth_mode: "qrcode"。
  2. 呼叫 POST /v1/accounts/{account_id}/auth/qr/start 啟動 QR 授權。
  3. 用 POST /v1/accounts/{account_id}/auth/qr/check 或 GET /v1/accounts/{account_id}/auth 輪詢，直到有 QR 內容、成功或失敗狀態。
  4. 將 message.received 呢類簽名 webhook delivery 先儲存，再送去後端 workflow。

TikTok 呢度最重要嘅細節係：首次 QR start response 可能無 QR URL。後台 UI 應該將輪詢當成正常狀態，而唔係錯誤。完整做法可以睇：將 TikTok 帳號連到簽名 webhook。

決策表：官方 Business Messaging API vs QR 授權收件箱

問題TikTok Business Messaging APIUnifyPort QR 授權收件箱
主要身份TikTok Business Account已連接嘅現有 TikTok 帳號
最適合TikTok 單平台 business messaging、廣告會話、官方 business 功能TikTok 加其他訊息平台嘅 inbound support queue
集成重點App access、authorization、review、limits、return codesAccount creation、QR authorization、webhook storage、signature verification
事件模型TikTok 自有 API 同 webhook model標準化 message.received event stream
多平台擴展其他平台要另寫 adapter同一個 handler 可接 WhatsApp、Telegram、LINE、Zalo、X
何時優先需要官方 TikTok business 功能並符合帳號/計劃要求支援流程由現有收件箱開始，需要穩定接收同分發訊息

如果你處理 TikTok Shop 客服，亦應該睇 TikTok Shop Customer Service API production checklist。Business Messaging API、Shop Customer Service API 同 QR 授權收件箱有關，但唔係同一個 interface。

UnifyPort 嘅角色

當你需要 TikTok 平台原生商務能力時，UnifyPort 唔係官方 Business Messaging API 嘅替代品。UnifyPort 嘅定位係非官方接口：幫小型團隊將入站同營運訊息統一成跨平台事件契約。

典型 receiver 會先儲存事件：

{
  "id": "evt_2f9c1a4b7e",
  "type": "message.received",
  "provider": "tiktok",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T12:34:56Z",
  "data": {
    "conversation": { "id": "user_778899", "type": "user" },
    "sender": { "id": "user_778899", "type": "user", "name": "Jordan Lee" },
    "message": {
      "id": "msg_3003",
      "text": "Hi, is this item still available?",
      "direction": "inbound",
      "sent_at": "2026-06-08T12:34:55Z"
    },
    "event": { "kind": "message_received" }
  }
}

之後用 provider、account_id、data.conversation.id 路由。接收端應先用 endpoint 嘅 signing_secret 驗證 X-Device-Signature，再做 business logic；簽名內容係 X-Device-Timestamp + "." + raw request body 嘅 HMAC-SHA256。完整 header 同 Node.js/Python 範例見 webhook delivery and signature verification。

限制同取捨

如果產品依賴 TikTok Business Account 功能、廣告歸因、官方計劃保障或平台管理自動訊息，請揀 TikTok 官方路徑。如果眼前任務係將真實收件箱訊息穩定接收、儲存，並分派到客服或 AI queue，QR 授權收件箱更貼近需要。

QR 路徑同樣需要安全營運：保存每個入站事件，將 QR 同 session material 視為敏感資料，設計重新授權流程，並將 TikTok-specific downstream rules 放喺標準化入站層之後。

FAQ

TikTok Business Messaging API 即係 TikTok 私訊 API？

佢係 TikTok 面向 Business Account 商務訊息嘅官方介面。應該以 business-account integration 評估，並喺 TikTok 官方文件核對 access、limits 同 review 要求。

幾時應該用 UnifyPort？

當現有 TikTok 收件箱已經係客服流程一部分，而你要將佢同 WhatsApp、LINE、Zalo、Telegram 或 X 一齊接入簽名 message.received 事件流，就適合用 UnifyPort。

UnifyPort TikTok QR start 一定會返回 QR URL 嗎？

唔一定。UnifyPort provider guide 說明，TikTok 初次 QR start response 可能無 QR URL。繼續輪詢 QR check，直到有 QR 內容、成功或失敗狀態。

下一步睇邊份文件？

先睇 TikTok authorization provider guide，再睇 Check QR authentication 同 Webhook delivery。

資料核對日期：2026-09-07

UnifyPort API

令訊息接入變成一條穩定嘅產品管線。

先用統一嘅 API 跑通發送，再用標準事件將所有入站訊息接返去業務系統。

攞 API Key睇 API 參考