卡片交互回调

卡片交互回调

接口描述

卡片交互回调作用于消息卡片的 请求回调 交互组件。当终端用户点击消息卡片上的回传交互组件后,你在消息卡片列表设置的回调请求地址将会收到 卡片交互回调。该回调包含了用户与卡片之间的交互信息。

请求头

参数名
类型
描述
必填
Content-Type
string
值必须为:application/json;charset=UTF-8
必填
userShowId
string
当前人员登陆ID
必填
code
string
当前人员token
必填

请求参数

参数名
类型
描述
必填
schema
string
回调的版本,当前固定为1.0
必填
tag
string
交互组件的标签。示例:button
必填
name
string
组件的自定义唯一标识。示例:Button_3b326797
必填
timezone
string
用户当前所在地区的时区。当用户操作日期选择器、时间选择器、或日期时间选择器时返回。示例:Asia/Shanghai
必填
formData
object
表单容器内用户提交的数据。
必填
field name1
array
数据列表
必填
field name2
string
示例:value2
必填
DatePicker_bpqdq5puvn4
string
示例:2024-04-01 +0800
必填
DateTimePicker_ihz2d7a74i
string
示例:2024-04-29 07:07 +0800
必填
Input_lf4fmxwfrd9
string
示例:1234
必填
PersonSelect_2ejys7ype7m
string
示例:ou_3c14f3a59eaf2825dbe25359f15*****
必填
Select_a2d5b7l3zd
string
示例:1
必填
TimePicker_7ecsf6xkqsq
string
示例:00:00 +0800
必填
host
string
卡片展示场景
必填

请求参数示例

{ "schema": "1.0", // 回调的版本 "tag": "button", // 交互组件的标签 "timezone": "Asia/Shanghai", // 用户当前所在地区的时区。当用户操作日期选择器、时间选择器、或日期时间选择器时返回 "formData": { // 表单容器内用户提交的数据 "DatePicker_bpqdq5puvn4": "2024-09-01", // 表单容器内日期选择器组件的 name 和 value "DateTimePicker_ihz2d7a74i": "2024-09-29 07:07", // 表单容器内日期时间选择器组件的 name 和 value "Input_lf4fmxwfrd9": "1234", // 表单容器内输入框组件的 name 和 value "PersonSelect_2ejys7ype7m": "ou_3c14f3a59eaf2825dbe25359f15*****", // 表单容器内人员选择-单选组件的 name 和 value "Select_a2d5b7l3zd": "1", // 表单容器内下拉选择-单选组件的 name 和 value "TimePicker_7ecsf6xkqsq": "00:00" // 表单容器内时间选择器组件的 name 和 value }, "name": "Button_3b326797", // 用户操作交互组件的名称,由开发者自定义 "host": "portal" // 卡片展示场景 }