← API 參考
渠道方對比

Webhook 標準事件差異

目前各 provider 解析器已映射的標準 webhook 事件與 payload 差異。此處表示原始碼層級支援，不保證每個帳號或部署都會產生全部已映射事件。

能力

能力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 payload 可能附帶 edit_message_id，代表這是對既有訊息的編輯，而非新訊息。
  • X 不會即時下發已讀回條，狀態事件僅限 sent 與 failed。
  • Zalo 的狀態事件為盡力而為：在低流量情境下可能延遲或缺漏。
  • 目前原始碼僅將私聊映射為 message.received；群聊、ACK、notice 與 comment 不屬於公開標準事件。原始碼支援不等於真實帳號 E2E 已驗證。