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

调试指南⭐

一、说明#

Webhook 用于接收平台推送的实时事件数据(如登录状态、好友变化、群消息等)。
当相关事件发生时,系统会向你配置的回调地址发送 HTTP POST 请求,你只需在服务端接收并处理即可。
所有回调数据格式均为 JSON。

二、接入流程#

1.
在控制台配置 Webhook 回调地址(URL)
2.
启动设备并保持在线状态
3.
触发相关事件(如扫码登录、加好友、发送消息等)
4.
服务端接收回调请求并解析数据

三、回调请求说明#

1. 请求方式#

POST
Content-Type: application/json

2. 回调示例#

{
   "data" : [{
      "cmd":15500
      "msgServerId" : 1017723,
      "msgType" : 2131,
      "msgUniqueIdentifier" : "9FcHZl98QZK_AlX",
      "senderId" : 10030,
      "seq" : 9409929,
      "timestamp" : 1682676419
   }],
   "error" : 0,
   "msg" : "成功"
}

四、调试方法#

1. 本地调试#

如果你的服务在本地运行,可使用内网穿透工具(如 ngrok)将本地服务暴露为公网地址,然后填写到 Webhook URL 中。

2. 调试步骤#

1.
配置回调地址
2.
启动设备
3.
触发事件(如扫码登录)
4.
查看服务端日志是否收到数据

3. 校验要点#

回调接口必须返回 HTTP 200
请求地址必须为公网可访问地址
数据格式必须正确解析(JSON)

五、常见问题#

Q1:为什么收不到回调?#

可能原因:
未配置 Webhook 地址
设备未在线
接口未返回 200 状态码
回调地址无法被公网访问

Q2:回调失败会重试吗?#

如系统支持重试机制,当回调失败(非200)时会自动进行重试,具体次数以实际策略为准。

Q3:收到的数据为空或不完整?#

检查事件类型是否正确
确认触发的行为是否符合事件定义
查看服务端是否正确解析 JSON
修改于 2026-04-30 12:56:03
上一页
回调结构说明
下一页
常见问题
Built with