事件推送规则

事件类型（平台前缀命名空间）

TikTok 域：tiktok.comment.created/deleted/visibility_changed/updated、tiktok.message.received/sent/referral、tiktok.publish.completed/failed/live/unpublished；未覆盖的官方事件以 tiktok.<原始事件名> 透传。

订阅

• 端点级订阅：eventTypes 支持 ["*"]（全部）、["tiktok.*"]（平台通配）、精确类型数组。
• secret 只在创建时返回一次；验签密钥 = sha256(secret) 的 hex，签名头 X-Vidgate-Signature: t,v1。
• 无公网地址时用 haina listen（SSE）本地监听，断线自动重连 + Last-Event-ID 续传。

消费语义（务必按此实现）

• at-least-once：可能重复投递，按事件 id 幂等去重；
• 不保证顺序：以 occurred_at/received_at 自行排序；
• push（webhook）+ pull（GET /v1/events 游标拉取）双通道可对账。

时效口径（诚实 SLA）

• 私信事件近实时；
• 评论事件官方上限约 5 分钟（实测秒级）；
• 平台保证「收到后秒级分发」；官方侧的投递延迟不在本平台 SLA 内。

事件触发面

• 评论事件覆盖：API 发布与手动发布的帖子、自己账号发出的评论也会触发（官方不过滤 owner）；
• 私信事件：im_receive_msg（收到）/ im_send_msg（发出，含 App 内手动发送）/ im_referral_msg；
• 发布事件：post.publish.* 覆盖 API 发布的帖子（含 publish.live 携带 post_id，平台自动回填发布记录）。

来源：TikTok 官方文档（Webhooks 章节）。