消息接收

消息接收用于把微信实例收到的消息推送到业务系统。接入方配置 HTTP 回调地址后，平台会按消息类型推送文本、图片、文件、视频、群聊等事件。

使用前提

• 业务系统需要提供公网可访问的 HTTP 或 HTTPS 回调地址；生产环境建议使用 HTTPS。
• 回调服务应尽快返回成功响应，耗时处理建议进入异步队列。
• 接收方需要对消息 ID 做幂等处理，避免网络重试导致重复入库或重复触发业务。

TIP

还没有公网服务器时，可以先用 Webhook 本地联调 暂时接收回调，验证消息格式；需要调试本地代码时，再生成临时公网地址。

接口范围

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

使用建议

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