登入開始免費試用
easyCoexistence 官方 API

TikTok 留言 Webhook 事件

TikTok 的 API for Business 會在帳戶的相片貼文與公開影片上,留言或回覆被建立、刪除、隱藏、設為僅好友可見或公開後五分鐘內,發送 comment.update Webhook。每個事件會列明留言、貼文、動作、留言者的識別碼與文字,並附上 Tiktok-Signature 標頭簽署。

easyCoexistence 會在事件到達時,將帳戶的每個 TikTok 留言事件以該帳戶專用的密鑰簽署,即時轉發至您的 HTTPS 端點,且不保留副本。

5 min

comment.update 在留言或回覆被建立、刪除或可見度改變後觸發的時限。

72 hours

回調未以 HTTP 200 回應時,TikTok 重試投遞的時長,並採指數退避。

comment.list

帳戶須已授予並持續有效的權限範圍,comment.update 事件才會發送。

At least once

TikTok 的投遞承諾:同一事件可能送達多於一次,因此處理應具冪等性。

comment.update 回報什麼?

帳戶相片貼文與公開影片貼文上的留言變動,無論是透過 API 還是 TikTok 應用程式發布。comment_action 說明發生了什麼:

  • insert:留言或回覆已被建立。
  • delete:已被刪除。
  • set_to_hidden:已被隱藏,由用戶或審核操作。
  • set_to_friends_only:已設為僅好友可見。
  • set_to_public:由隱藏或僅好友可見改為對所有人可見。

事件包含什麼?

TikTok 發送 JSON,包含 client_key、event、create_time、user_openid(即帳戶的 ID)以及 content(序列化後的 JSON 字串)。content 內包括 comment_id 與 video_id、回覆的 parent_comment_id、comment_type(comment 或 reply)、comment_action、時間戳、留言者的 unique_identifier 及文字。這些 ID 是超出 double 可精確表示範圍的 JSON 數字,因此請從原始字串讀取。

事件如何送達您的端點?

TikTok 將 Webhook 發送至開發者應用程式,整個應用程式共用一個回調 URL。easyCoexistence 接收後,會將已連接帳戶的每個 comment.update 一次性、即時轉發至您為該帳戶設定的 HTTPS 端點,並以該帳戶自己的密鑰簽署。您可在 Claude 或 ChatGPT 中使用 set_social_webhook_destination 設定端點,或透過 Partner API 的 PUT /channels/:id/webhook 設定;密鑰只顯示一次,URL 為 null 即會關閉轉發。

轉發的事件是什麼樣子?

一個 POST 請求,包含 platform、list_social_accounts 為該連接提供的 account_id、帳戶的 external_id(即 TikTok 的 open_id),以及 entry:事件名稱、create_time 與 content。content 已解析,其 ID 已轉為字串,因此不會被四捨五入。

A forwarded comment.update event
{
  "platform": "tiktok",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<TIKTOK_OPEN_ID>",
  "entry": {
    "event": "comment.update",
    "create_time": 1793318400,
    "content": {
      "comment_id": "<COMMENT_ID>",
      "video_id": "<VIDEO_ID>",
      "parent_comment_id": null,
      "comment_type": "comment",
      "comment_action": "insert",
      "timestamp": 1793318399000,
      "unique_identifier": "<UNIQUE_IDENTIFIER>",
      "text": "<COMMENT_TEXT>"
    }
  }
}

如何驗證轉發的事件?

每個轉發的投遞都帶有 X-EC-Signature 標頭,格式為 t=<unix>,v1=<hex>,其中 v1 是以帳戶的簽署密鑰為金鑰,對時間戳、一個點(.)與原始請求內容計算的 HMAC-SHA256。請依原樣對收到的內容重新計算,以恆定時間比對兩者,並拒絕超過 5 分鐘的時間戳。

轉發的事件會重試嗎?

easyCoexistence 不會重試。每個事件只於記憶體中轉發一次,不保留副本供重試;轉發等待 8 秒回應,且不跟隨重新導向。上游的 TikTok 會對其自身投遞重試最多 72 小時,並承諾至少送達一次,因此同一事件可能送達您兩次:請以 comment_id 加 comment_action 去重。

常見錯誤

  • 將 ID 解析為數字。comment_id 與 video_id 超出 double 的精確範圍;easyCoexistence 以字串轉發,請保持其字串形式。
  • 對已解析的內容副本計算簽署。HMAC 涵蓋的是送達時的原始內容,重新序列化會令比對失敗。
  • 重複處理同一事件兩次。TikTok 至少投遞一次,因此採取行動前請以 comment_id 與 comment_action 作為鍵。
  • 將目的地指向會重新導向的位址。轉發不跟隨重新導向,請填寫最終的 HTTPS URL。
使用 EasyCoexistence 完成這項設定

請在 Claude 或 ChatGPT 中使用 set_social_webhook_destination 開啟,或透過 Partner API 開啟。每個連接每月由 US$ 9 起,隨連接增加而降至 US$ 0.75,首 3 天免費試用。

常見問題

哪些 TikTok Webhook 事件會被轉發?

comment.update,即已連接帳戶貼文上留言與回覆的建立、刪除、隱藏、設為僅好友可見或公開。

TikTok 發布事件也會被轉發嗎?

不會。轉發只包含留言事件;請改用 get_tiktok_publish_status 追蹤貼文的發布狀態。

TikTok 留言事件多快送達?

TikTok 在變動後五分鐘內發送 comment.update,easyCoexistence 收到後即刻轉發。

TikTok 留言事件是否包含文字?

TikTok 文件在事件的 content 中記載了 text 欄位,與留言及貼文 ID、動作及留言者的 unique_identifier 並列。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期