callback.md

回调(Webhook)

在控制台给 Token 配一个 HTTPS 回调地址,企业微信侧的消息与事件会 POST 过来。

信封结构

{
  "code": 0,
  "data": [
    {
      "guid": "账号实例ID",
      "userId": "发送方",
      "cmd": 15000,
      "msgType": 2,
      "fromRoomId": 0,
      "seq": 123,
      "msgUniqueIdentifier": "..."
    }
  ]
}

cmd 一级路由

cmd	含义
11016	设备 / 账号状态(登录、离线、扫码)
15000	会话消息(fromRoomId 非 0 = 群聊)
15500	系统事件(群成员进出、群改名、新建群、解散,以及好友、朋友圈等)
20000	异步接口回执

msgType 二级(会话消息)

0/2 文本 · 7/14 图片 · 22/23 视频 · 16 语音 · 13 链接 · 78 小程序 · 2063 撤回

两个要点

1. 3 秒内回 200 —— 否则企业微信侧会判超时并重推;
2. 按 seq / msgUniqueIdentifier 幂等去重 —— 耗时处理(入库 / AI 回复 / 工单)丢队列异步做,别卡在回调里。

最小接收示例见 examples/webhook-server.js。完整字段以在线文档为准。