配置消息回调地址

POST

https://console.wecomapi.com/wecom/finder/api

接口提示

配置当前 Token 的消息与事件回调地址；配置成功后，同一 Token 下的账号消息和状态事件会推送到该地址。

回调内容会携带 guid，业务系统可通过 guid 区分消息所属账号或设备。

消息类型可根据 cmd 与 msgType 解析，完整结构可查看 Webhook 推送服务说明。

回调服务必须公网可访问，须在 3 秒内返回 HTTP 200，响应体可为空；超时将丢弃本次消息，耗时业务放入异步队列处理。

回调鉴权通过 authType、authSecret 配置；authType 填 Authorization。设置后会验证回调 URL，接收端应在 3 秒内返回 HTTP 200。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

请求成功时返回统一响应结构，具体字段以 data 内容为准。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://console.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/client/setCallback",
  "params": {
    "callbackUrl": "https://open.wechatapi.net/webhook/events",
    "authType": "Authorization",
    "authSecret": ""
  }
}'

响应示例

{
  "code": 0,
  "msg": "成功"
}

⚠️开发常见问题