WTAPI开发文档
官方网站
服务报价
后台系统
免费试用
复制页面
平台简介
快速入门
接入开发规范
消息订阅收发
综合问题排查
回调信息速览
回调消息详解
更新日志
API模块
登录接口
①获取登录二维码
②执行登录
弹窗登录
③设置回调地址
检查是否在线
退出
断线重连
联系人接口
获取通讯录列表
获取通讯录列表缓存
获取群/好友简要信息
获取群/好友详细信息
搜索好友
添加联系人/同意添加好友
删除好友
设置好友仅聊天
设置好友备注
获取手机通讯录
上传手机通讯录
搜索企微
添加企微好友
同步企微好友
获 取企微好友详情
消息接口
下载
下载文件
下载图片
下载语音
下载视频
下载emoji和表情包
发送文字消息
发送文件消息
发送图片消息
发送语音消息
发送视频消息
发送链接消息
发送名片消息
发送emoji消息
发送appmsg消息
发送小程序消息
转发文件
转发图片
转发视频
转发链接
转发小程序
撤回消息
个人接 口
获取个人资料
获取自己的二维码
获取设备记录
隐私设置
修改个人信息
修改头像
标签接口
添加标签
删除标签
标签列表
修改好友标签
群聊接口
创建微信群
修改群名称
修改群备注
修改我在群内的昵称
邀请/添加 进群
删除群成员
退出群聊
解散群聊
获取群信息
获取群成员列表
获取群成员详情
设置群公告
获取群公告
同意进群
添加群成员为好友
获取群二维码
群保存到通讯录
管理员操作
聊天置顶
设置消息免打扰
扫码进群
确认进群申请
朋友圈接口
自己的朋友圈列表
联系人的朋友圈列表
点赞/取消点赞
删除自己朋友圈
设置朋友圈可见范围
是否允许陌生人查看朋友圈
设置某条朋友圈为隐私/公开
下载朋友圈视频
发送文字朋友圈
发送图片朋友圈
发送视频朋友圈
发送链接朋友圈
上传朋友圈图片
上传朋友圈视频
转发朋友圈
某条朋友圈详情
评论/删除评论
收藏夹接口
同步收藏夹
获取收藏夹内容
删除收藏夹
视频号接口
获取我的视频号信息
修改我的视频号信息
用户主页
关注
评论
浏览
发布视频-新
关注列表
消息列表
评论列表
获取赞与收藏的视频列表
搜索视频号
创建视频号
同步私信消息
根据id点赞
根据id点小红心
发送视频号消息
发送视频号朋友圈
获取私信人信息
发私信文本消息
发私信图片消息
扫码关注
搜索并关注
扫码浏览
扫码评论
扫码点赞
扫码点小红心
延迟点赞、小红心
扫码登录视频号助手
扫码获取视频详情
我的视频号二维码
上传CDN视频
发布CDN视频
消息订阅收发
复制页面
📡 消息订阅常见问题
开发场景下何时启用消息订阅能力?
开发消息自动应答 、社群交互类业务时,如需实时监听好友私聊、微信群聊消息数据流,基于消息内容触发自动回复、群成员管控、人员拉入移出等自动化逻辑场景,均需接入消息订阅服务。
回调接口部署配置流程
开发者登录 WTAPI 开发管理后台,进入 Token 回调配置页面,填写自研业务回调接口地址并完成绑定。绑定生效后,当前授权 Token 下所有已登录微信实例接收到的消息,都会统一推送至预设的公网回调地址。
服务端回调接口开发规范
平台推送消息统一采用
POST 请求
,请求体格式为标准
JSON
,开发者直接解析请求 Body 即可获取完整消息字段。
接口响应超时阈值为
3 秒
,超出时限平台判定请求失效并终止推送。接口无业务逻辑可直接返回空报文。
程序主动调用 API 下发的消息
不会触发回调
,仅终端微信原生收发消息才会触发(多端消息同步机制)。
地址绑定完成后,平台会自动下发验证类 JSON 测试报文,用于校验接口连通性。
回调接口必须部署在
公网可访问的服务
上,内网穿透仅适用于本地调试,网络波动易造成消息丢包。连通异常可借助 Apifox 工具自测接口可用性。
如何主动发送消息?
业务开发前期,优先调用
通讯录拉取接口
,同步好友列表、微信群列表至本地数据库。数据同步完成后,直接调用对应的消息发送 API 即可完成主动消息推送。
如何接收消息并实现交互?
实现私聊、群聊消息的实时监听与交互,需要先配置全局消息订阅,再结合自身业务编写数据处理逻辑,最后搭配消息发送接口完成整套收发联动开发。
如何开发群管理、自动化功能?
市面上主流微信机器人、智能客服类功能,底层均依赖订阅接收的消息流做二次逻辑开发。可实现的场景包括:群权限管理、消息持久化存储、多账号消息聚合、跨群消息转发、社群运营推送、订单云发单、自动回复等。只需配置消息订阅并编写自定义业务逻辑,即可快速搭建专属自动化程序。
如何最快完成联调测试?
平台内置
Apifox 在线接口调试工具
,支持网页端直接发起请求完成联调。同时开放全套开发示例源码,新手开发者可直接参考案例代码快速上手,也可接入免费回调测试地址完成前期调试。
修改于
2026-06-09 06:29:29
上一页
接入开发规范
下一页
综合问题排查