回调事件索引

先按 messageType 把事件分到业务处理器，再按具体字段处理。完整字段、示例和历史兼容说明保留在 完整回调字典。

事件分类

分类	常见用途	详细字段
通知类	登录、离线、联系人变化、系统状态	查看通知类事件
私聊消息	文本、图片、文件、语音、视频、链接	查看私聊事件
群聊消息	群文本、群媒体、成员与群状态变化	查看群聊事件
公众号消息	公众号文本、文章与事件	查看公众号事件

推荐分发结构

function handleWebhook(event) {
  const { messageType, data } = event

  if (isNotification(messageType)) return handleNotification(data)
  if (isGroupMessage(messageType)) return handleGroupMessage(data)
  if (isOfficialAccount(messageType)) return handleOfficialAccount(data)
  return handlePrivateMessage(data)
}

具体类型判断应以完整字典为准，不要只依赖示例中的少量类型。

通用处理规则

• 先校验 JSON 结构，再读取业务字段。
• 未识别类型记录脱敏日志并返回成功，避免反复重试阻塞主链路。
• 使用 newMsgId 或业务唯一键做幂等。
• 耗时处理放入队列，回调请求 6 秒内结束。