配置卡片回调地址(可选)
更新时间:2026-05-26 10:21:30

配置卡片回调地址

支持通过应用机器人和自定义机器人发送消息卡片,但不支持自定义机器人发送带回传交互组件的消息卡片。

如果消息卡片内配置了用于回传交互的组件,如按钮组件的value,则在构建消息卡片后、发送消息卡片前,请按照以下步骤完成消息卡片请求网址的配置。

第一步 配置消息卡片请求网址

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

请求示例如下:

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

参数说明:

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

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

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

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

  1. 开放平台发送回调请求

当回调请求发生时,开放平台会将回调数据发送到你预先配置的请求地址.回调报文以 HTTPSHTTP 的方式进行传输,使用 POST 方法,报文格式限定为 JSON 格式。请求报文格式见回调数据内容

  1. 签名校验(可选)

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

  1. 应用响应回调请求

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

本页目录