调试指南⭐

一、说明

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

所有回调数据格式均为 JSON。

二、接入流程

在控制台配置 Webhook 回调地址（URL）

启动设备并保持在线状态

触发相关事件（如扫码登录、加好友、发送消息等）

服务端接收回调请求并解析数据

三、回调请求说明

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. 调试步骤

配置回调地址

启动设备

触发事件（如扫码登录）

查看服务端日志是否收到数据

3. 校验要点

回调接口必须返回 HTTP 200

请求地址必须为公网可访问地址

数据格式必须正确解析（JSON）

五、常见问题

Q1：为什么收不到回调？

可能原因：

未配置 Webhook 地址

设备未在线

接口未返回 200 状态码

回调地址无法被公网访问

Q2：回调失败会重试吗？

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

Q3：收到的数据为空或不完整？

检查事件类型是否正确

确认触发的行为是否符合事件定义

查看服务端是否正确解析 JSON

一、说明#

二、接入流程#

三、回调请求说明#

1. 请求方式#

2. 回调示例#

四、调试方法#

1. 本地调试#

2. 调试步骤#

3. 校验要点#

五、常见问题#

Q1：为什么收不到回调？#

Q2：回调失败会重试吗？#

Q3：收到的数据为空或不完整？#