QiWe开放平台
企微官网企微报价控制台
企微官网企微报价控制台
  1. Webhook
  • 平台介绍
  • 快速开始 ⭐
  • Webhook
    • Webhook事件⭐
    • 回调结构说明
    • 调试指南⭐
    • 常见问题
  • API参考
    • 基础能力
      • 登录模块
        • 创建设备(步骤1)
        • 二维码-获取(步骤2)
        • 二维码状态-检测(步骤3)
        • 二维码-code验证(步骤4)
        • 设置回调地址
        • 用户登录(免扫码登录)
        • 用户状态
        • 恢复设备
        • 停用设备
        • 账号退出
      • 个人模块
        • 生成二维码
        • 获取个人信息
        • 更新个人信息
        • 查询企业信息
        • 个人收藏-分页
        • 个人收藏-添加GIF表情
    • 客户管理
      • 联系人模块
        • 联系人详情-批量
        • 联系人详情-By二维码
        • 外部联系人分页
        • 内部联系人分页
        • 联系人搜索
        • 添加个微
        • 添加企微
        • 添加群成员好友
        • 添加企微名片
        • 添加删除联系人
        • 同意申请
        • 外部联系人信息-更新
        • 内部联系人信息-更新
        • 删除联系人
        • Userid转Openid
        • Openid转Userid
      • 群模块
        • 群分页
        • 群详情-批量
        • 群成员变动查询
        • 创建群
        • 修改群备注
        • 修改群名称
        • 修改群内昵称
        • 开启群改名
        • 禁止群改名
        • 邀请/添加成员
        • 群成员邀请确认(管理员)
        • 禁止群成员互相添加
        • 移除成员
        • 群二维码
        • 修改群公告
        • 添加群管理员
        • 取消群管理员
        • 退群
        • 转让群主
        • 群解散
        • 开启群邀请确认
        • 接受群邀请-By链接
        • Roomid转OpenID
        • OpenID转Roomid
      • 标签模块
        • 列表分页
        • 个人标签-增删改
        • 客户标签-增删
    • 会话与消息
      • 消息模块
        • 引用消息发送说明
        • 发送纯文本消息
        • 发送混合文本消息
        • 发送图片消息
        • 发送GIF表情消息
        • 发送视频消息
        • 发送文件消息
        • 发送语音消息
        • 发送链接消息
        • 发送小程序消息
        • 发送名片消息
        • 发送视频号消息
        • 发送定位消息
        • 撤回消息
        • 语音转文字-任务申请
        • 语音转文字-任务查询
        • 修改消息状态
        • 群消息置顶-列表
        • 群消息置顶-添加
        • 群消息置顶-移除
        • 群发助手发送
        • 群发助手-状态查询
        • 群发助手-规则查询
        • 同步历史消息分页
      • 会话模块
        • 会话分页
        • 会话组-编辑
        • 会话组-查询
    • 媒体与运营
      • 文件与媒体(下载/上传)
        • 企微文件异步上传
        • 企微大文件异步上传
        • 企微文件异步下载
        • 企微大文件异步下载
        • 个微文件异步下载
        • 文件上传-SDK云存储
        • 文件CDN转URL
        • 本地文件上传
        • 个微文件下载
        • 企微文件下载
        • 文件上传-URL
      • 朋友圈模块
        • 朋友圈列表分页
        • 获取详情-批量
        • 朋友圈文件上传
        • 发送朋友圈
        • 删除朋友圈
        • 点赞/取消赞
        • 评论/追评
        • 评论删除
  1. Webhook

常见问题

常见问题#

接入与使用过程中的高频问题解答,覆盖环境要求、Token 授权、消息风控、Webhook 回调、数据安全等核心场景。
无需插件Token 授权消息队列Webhook私有化部署

基础接入#

本服务是否需要安装第三方插件?#

本服务无需安装任何第三方插件,使用企业微信官方客户端即可正常登录。
企业微信官方下载

企业微信版本是否有要求?#

对企业微信版本无特殊要求,使用官方版本且可正常登录即可。建议使用较新版本以获得更好的稳定性。

是否提供 SDK?#

当前提供标准 HTTP REST API,不提供封装 SDK。优势是更高灵活性、更强扩展性,可适配任意技术栈(Java / Python / Node.js / Go 等)。

Token 与授权#

单个 Token 与多个 Token 的区别?#

    单个 Token → 共用一个回调地址,适合单一业务系统
    多个 Token → 可配置独立回调,实现多业务 / 多租户隔离

单个 Token 最多支持多少企业微信?#

绑定数量取决于采购授权数,无固定上限。当已登录数量 ≥ 采购数量时,将无法继续登录新账号。

一个开发者账号可以生成多少个 Token?#

Token 数量与采购数量一致。例如采购 10 个节点,最多可生成 10 个 Token。
说明:
平台默认生成 1 个 Token
可通过控制台创建多个
已登录数 ≥ 采购数时,无法继续登录

不同时间采购的服务到期后如何处理?#

部分服务到期后,系统会每日随机下线超出授权数量的账号。建议提前做好续费规划与账号管理,避免业务中断。

消息与发送#

每天发送消息是否有数量限制?#

平台本身不限制发送数量,但企业微信官方存在风控机制,包括发送频率过快、内容违规或异常行为模式等。
建议:
所有发送操作使用消息队列(Queue)
严禁并发发送,控制间隔模拟真人行为
单条消息间隔建议 2-3 秒

单个节点支持多少会话?#

理论上无硬性上限,实际取决于消息处理能力与发送频率。
参考:每条消息间隔 2-3 秒,每分钟处理 20~40 条消息。

是否支持自动回复?#

支持。实现路径:
  1. 配置 Webhook 回调
  2. 接收企微消息事件
  3. 编写业务逻辑处理
  4. 调用发送接口回复

回调与数据安全#

是否支持多个回调地址?#

单个 Token 仅支持一个回调地址。如需多个回调,请创建多个 Token 实现业务隔离。

数据安全如何保障?#

  • SaaS 模式:仅作消息路由转发,不存储用户敏感数据
  • 私有化部署:数据完全本地化,适用于金融、政务等高安全场景
仍有疑问?查看 快速开始 或
Webhook 事件 继续排查。
修改于 2026-07-01 05:57:20
上一页
调试指南⭐
下一页
创建设备(步骤1)
Built with