消息接收

配置 Webhook 后，平台会把微信收到的消息和事件推送到你的业务系统。

使用前提

• 提供公网可访问的 HTTP/HTTPS 回调地址。
• 回调接口快速返回，耗时任务放入异步队列。
• 按 newMsgId 等字段做幂等，避免重复入库或重复触发业务。

TIP

没有服务器时，先用 Webhook 本地联调 查看回调内容；需要调试本地代码时，再生成临时公网地址。

接口范围

场景	说明
本地联调	没有服务器时查看 Webhook 内容，或临时调试本地接口
回调配置	设置或取消 HTTP 回调地址
消息解释	查看普通消息、系统消息和不同消息类型字段含义
内容下载	对图片、视频、文件、表情等消息内容进行下载或异步查询

使用建议

先接入回调配置和文本消息，再接入图片、文件、视频等媒体消息。媒体内容按消息类型调用对应下载接口。