流程
更新时间:2025-05-20 08:24:59

流程

当消息卡片中的交互控件被触发时,若卡片需要回调则开放平台会向你配置的消息卡片请求网址发起POST请求回调。

第一步 配置卡片请求地址URL

  1. 登录管理平台,进入应用管理,编辑对应应用,选择机器人菜单
  2. 打开机器人,然后在消息卡片POST请求地址中输入你的卡片回调地址
  3. 点击 验证保存 时,开放平台会向你配置的请求地址发送一个application/json格式的POST请求,用于验证你所配置地址的合法性

请求示例如下:

{
  "challenge": "2fcd3339d69f4522b43f6ea377f70a63",
  "type": "url_verification",
}

参数说明:

字段名称 字段类型 说明
challenge string 需要在响应中原样返回的值
type string 表示当前请求为验证URL合法性

需要在3秒内将challenge值(JSON格式)原样返回给开放平台,否则请求地址验证失败。返回示例如下:

{
    "challenge": "2fcd3339d69f4522b43f6ea377f70a63",
}
  1. 验证通过后,单击保存完成配置

第二步 接收并响应回调请求

  • 当回调请求发生时,开放平台会将回调数据发送到你预先配置的请求地址

  • 回调报文以 HTTPSHTTP 的方式进行传输,使用 POST 方法,报文格式限定为 JSON 格式

  • 应用服务器需按规定的格式响应回开放平台,具体响应格式查看 数据内容

签名校验

UC回调请求会在请求头authorization中带上事件订阅菜单下的Token,应用可以通过校验该Token判断是否来自开放平台。

本页目录