API 参考
渠道方对比

Webhook 标准事件差异

当前各 provider 解析器已映射的标准 webhook 事件与载荷差异。这里表示源码级支持,不保证每个账号或部署都会产生全部已映射事件。

能力

能力TelegramWhatsAppXLINEZaloTikTok
message.received完整支持完整支持完整支持完整支持完整支持完整支持
message.updated完整支持完整支持不支持完整支持不支持不支持
message.deleted完整支持完整支持不支持完整支持不支持不支持
message.read完整支持部分支持不支持完整支持不支持不支持
message.reaction完整支持完整支持不支持完整支持不支持不支持
message.delivered完整支持部分支持不支持完整支持不支持不支持
conversation.updated完整支持完整支持不支持不支持不支持不支持
conversation.deleted不支持完整支持不支持不支持不支持不支持
conversation.cleared不支持完整支持不支持不支持不支持不支持
conversation.history不支持完整支持不支持不支持不支持不支持
group.updated完整支持完整支持不支持不支持不支持不支持
group.join_request不支持完整支持不支持不支持不支持不支持
account.status.updated完整支持完整支持完整支持完整支持完整支持完整支持
account.started不支持完整支持不支持不支持不支持不支持
account.history.synced不支持完整支持不支持不支持不支持不支持
account.auth.required完整支持完整支持不支持完整支持完整支持完整支持
account.auth.succeeded完整支持完整支持完整支持完整支持完整支持完整支持
account.auth.failed完整支持完整支持完整支持完整支持不支持不支持

备注

  • WhatsApp 的送达回执映射为 message.delivered,已读回执映射为 message.read;sent / failed 不会形成独立标准事件。群聊回执可能为控制 webhook 流量而被过滤。
  • WhatsApp 的反应消息会作为 message.reaction 事件下发(emoji 在 data.event.reaction,被反应消息 id 在 data.message.target_message_id)。
  • Telegram 的 message.received 载荷可能附带 edit_message_id,表示这是对已存在消息的编辑而非新消息。
  • X 不下发实时已读回执,状态事件仅限 sent 与 failed。
  • Zalo 的状态事件为尽力而为:低流量场景下可能延迟或缺失。
  • 当前源码仅把私聊映射为 message.received;群聊、ACK、notice 与 comment 不属于公开标准事件。源码支持不等于真实账号 E2E 已验证。