企业微信号二次开发 & wecomapi.com
个人微信接口官网地址管理后台
个人微信接口官网地址管理后台
  1. 接入指南与说明
  • API文档目录
    • 接入指南与说明
      • 👉 接入须知
      • 🛡️ Webhook调试指南
      • 🔄 消息推送(回调)服务
      • 📖 常见业务与技术 FAQ
      • ⚠️开发常见问题
    • 开放接口
      • 01 登录与设备
        • 配置消息回调地址
        • ① 创建设备并获取 guid
        • ② 获取登录二维码
        • ③ 校验登录验证码(按需)
        • ④ 查询扫码登录状态
        • 免扫码二次登录
        • 恢复设备在线状态
        • 停止并释放设备
        • 查询账号在线状态
        • 退出当前设备
      • 02 联系人管理
        • 外部联系人与好友申请列表
        • 内部联系人列表
        • 批量获取联系人详情
        • 搜索联系人
        • 通过二维码查询联系人
        • 添加个微联系人
        • 添加企微联系人
        • 添加群成员为好友
        • 添加企微名片联系人
        • 重新添加单删联系人
        • 同意好友申请
        • 修改个微联系人备注
        • 修改企微联系人信息
        • 删除联系人
        • OpenID 转 UserID
        • UserID 转 OpenID
      • 03 消息收发与会话
        • 发送引用消息
        • 发送文本消息
        • 发送富文本消息
        • 发送图片消息
        • 发送 GIF 表情
        • 发送视频消息
        • 发送文件消息
        • 发送语音消息
        • 发送链接消息
        • 发送小程序消息
        • 发送名片消息
        • 发送视频号消息
        • 发送位置消息
        • 语音转文字:提交任务
        • 语音转文字:查询结果
        • 收藏 GIF 表情
        • 同步个人收藏消息
        • 撤回消息
        • 修改消息状态
        • 查询群消息置顶列表
        • 设置群消息置顶
        • 移除群消息置顶
        • 发起群发消息
        • 查询群发状态
        • 查询群发规则
        • 同步历史消息分页
        • 查询会话列表分页
        • 编辑会话分组
        • 查询会话分组
      • 04 文件上传与下载
        • SDK 临时云存储上传
        • 企微文件异步上传
        • 企微大文件异步上传
        • 个微文件异步下载
        • 企微文件异步下载
        • 企微大文件异步下载
        • CDN 文件转临时 URL
        • 本地文件上传
        • URL 文件上传
        • 个微文件下载
        • 企微文件下载
      • 05 外部群与群组管理
        • 查询群组列表分页
        • 批量获取群详情
        • 群成员变动查询
        • 获取群二维码
        • 创建外部群组
        • 修改群名称
        • 修改群备注
        • 修改群内昵称
        • 修改群公告
        • 开启或关闭群改名权限
        • 禁止群成员修改群名称
        • 邀请或添加群成员
        • 管理员确认群成员邀请
        • 移除群成员
        • 禁止群成员互相添加
        • 添加群管理员
        • 取消群管理员
        • 开启入群确认
        • 通过链接接受入群邀请
        • 退出群组
        • 转让群主
        • 解散群组
        • OpenID 转 RoomID
        • RoomID 转 OpenID
      • 06 账号资料
        • 生成个人二维码
        • 获取账号资料
        • 更新账号资料
        • 查询企业资料
      • 07 客户标签管理
        • 查询标签列表分页
        • 客户标签增删
        • 个人标签增删改
      • 08 朋友圈能力
        • 朋友圈素材上传
        • 发布朋友圈
        • 删除朋友圈
        • 朋友圈点赞或取消点赞
        • 朋友圈评论或追评
        • 查询朋友圈互动列表
        • 批量获取朋友圈详情
        • 删除朋友圈评论
  1. 接入指南与说明

📖 常见业务与技术 FAQ

账号与环境#

Q:是否需要安装第三方插件?
A:不需要。建议使用官方正版企业微信客户端,并保持账号登录环境稳定。
Q:对企业微信版本是否有强制要求?
A:通常没有特殊强制要求,以能够正常扫码登录和稳定在线为准。

Token 与实例#

Q:单个 Token 可以绑定多个账号吗?
A:可以。实际可绑定数量取决于授权实例数量和当前套餐配置。
Q:单 Token 和多 Token 有什么区别?
A:单 Token 适合简单接入,多个账号共用一套回调配置;多 Token 适合多业务线、多客户或多系统隔离,每个 Token 可独立管理回调和权限边界。

消息与回调#

Q:为什么收不到 Webhook 回调?
A:优先检查四点:回调 URL 是否配置正确、服务是否公网可访问、账号是否在线、接收端是否在规定时间内返回 HTTP 200。
Q:收到消息后可以自动回复吗?
A:可以。常见链路是:Webhook 接收消息 → 业务系统解析内容 → 生成回复内容 → 调用消息发送接口回复给联系人或群聊。
Q:回调处理慢会有什么影响?
A:回调接口处理过慢可能导致推送超时。建议回调层只做验签、入库、投递队列,然后异步处理实际业务逻辑。

发送与风控#

Q:发送消息是否建议并发?
A:不建议。正式环境应通过消息队列串行或限速发送,并结合业务场景控制发送频率。
Q:哪些操作需要特别谨慎?
A:群发、建群、邀请成员、删除联系人、退出/解散群、修改账号资料、朋友圈发布等会产生真实业务影响的接口,建议增加权限校验、操作日志和人工确认。
修改于 2026-07-03 10:14:32
上一页
🔄 消息推送(回调)服务
下一页
⚠️开发常见问题
Built with