← 返回目录
📁 Organic API › Accounts API › Guides › Webhooks › Webhook event types

评论更新事件

评论更新类别包含 comment.update 事件。

注意
若想为你的开发者应用配置 Webhook 回调 URL,需使用 Webhook API 接口 /business/webhook/update/。

comment.update

当自有 TikTok 账号下的任意图片帖子或公开视频帖子中的评论或回复被创建、删除,或评论可见性设置被修改,将在 5 分钟内触发该事件。这适用于通过 /business/video/publish/ 或 /business/photo/publish/ 接口发布的帖子,以及通过 TikTok 应用手动发布的帖子。

前提条件

为确保能接收 comment.update 事件,TikTok 账号所有者需为开发者应用授予 comment.list 权限(读取应用内内容的评论和回复)。

这一授权必须保持有效且已激活。如果授权过期或被撤销,你将无法再接收该 TikTok 账号的 comment.update 事件。

事件内容

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| comment_id | number | 评论或评论回复的唯一识别 ID。 |
| video_id | number | 已创建评论的自有帖子的唯一识别 ID。 |
| parent_comment_id | number | 仅对评论回复返回。<br> 回复所对应的评论的 ID。 |
| comment_type | string | 评论类型。<br>枚举值: <ul><li> `comment`:评论。</li><li> `reply`:评论回复。 </li></ul>|
| comment_action | string | 对评论或评论回复采取的操作。<br>枚举值: <ul><li>`insert`:评论或评论回复已创建。</li><li>`delete`:评论或评论回复已删除。 </li><li>`set_to_hidden`:评论或评论回复已由用户或经审核被设为隐藏。</li><li>`set_to_friends_only`:评论或评论回复已被设为仅对用户的好友可见。</li><li>`set_to_public`:评论或评论回复已从隐藏或仅对好友可见更改为对所有用户公开可见。</li></ul>|
| timestamp | number | 对评论采取操作的日期和时间,采用 Unix/Epoch 格式。 |
| unique_identifier | string | 分配给每个发表评论的用户的全局唯一识别 ID。该识别 ID 在不同 API 中保持一致,便于交叉引用和集成。<br><br><b>示例</b>:+ABc1D2/E0fGhijklMNOrD34vDW/zDiZUNRH5Jyahue6OcA7b8ZpwnqXV9u1Uh+k。 |
|text|string|评论或评论回复的文本内容。|

有效负载示例

(code curl http)
{
 "client_key": "bwo1m23456a7k89",
 "event": "comment.update",
 "create_time": 1615338610,
 "user_openid": "_000abPL1cJIdVefgDhGijkl2mFn3AB0abY4",
 "content": "{\"comment_id\":7247303576418566913,\"video_id\":7203946942097902849,\"parent_comment_id\":7235861947622916866,\"comment_type\":\"reply\",\"comment_action\":\"delete\",\"unique_identifier\":\"+ABc1D2/E0fGhijklMNOrD34vDW/zDiZUNRH5Jyahue6OcA7b8ZpwnqXV9u1Uh+k\",\"timestamp\":1687394416109,\"text\":\"text\"}"
} 
(/code)

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →