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
    上一页
    接入开发规范
    下一页
    综合问题排查
    Built with