TikTok 评论 Webhook 事件
TikTok 的 API for Business 会在账户的图片帖子和公开视频上,评论或回复被创建、删除、隐藏、设为仅好友可见或设为公开后五分钟内发送 comment.update Webhook。每个事件包含评论、帖子、操作、评论者标识符和文本,并带有 Tiktok-Signature 请求头签名。
easyCoexistence 将账户的每个 TikTok 评论事件在到达时以 HTTPS 转发到您的端点,使用该账户专属的密钥签名,且不保留副本。
comment.update 在评论或回复被创建、删除或可见性改变后触发的时限。
TikTok 在回调未以 HTTP 200 响应时重试投递的时长,采用指数退避。
账户为其 comment.update 事件发送所需授予并保持有效的权限范围。
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 接收这些 Webhook,并将已连接账户的每个 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 已转换为字符串,因此不会被四舍五入。
{
"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。
可通过 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 监控
验证时间