互动卡片

本文介绍了互动卡片常见问题。

发送互动卡片时，cardData中包含Markdown如何入参?

答：cardData中包含Markdown入参方式如下：

示例："cardData" : "{\"field_1\":\"**钉钉平台<font color=common_blue1_color>已发起</font>**\"}"

机器人发送互动卡片中高级版与普通版的区别

答：高级版与普通版的区别如下表所示：

操作能力	互动卡片普通版	互动卡片高级版
搭建平台提取操作代码	支持	不支持
搭建平台可导出JSON	可一键复制导出	可一键导出
互动卡片回调	不支持	支持
是否支持删除	支持	支持
私有数据	不支持	支持
机器人发送互动卡片	支持	支持
更新机器人发送互动卡片	支持	支持
组件 \| 区块组件库	支持	支持
一键推送测试卡片	支持	不支持
表情	支持	支持

卡片发出去，单循环渲染器里面的数据未显示出来

答：卡片发送服务端有数据格式约定，具体规则：cardData 是当前卡片的数据，对应到卡片模板上的变量字段。对于值类型是简单的字符串、数字的，则把字段放到 cardData.cardParamMap 里面。而对于值类型是复杂类型的，比如对象，或对象数组，则需要把它们放到cardData.cardParamMap.sys_full_json_obj 这个系统字段里面来。

重要

sys_full_json_obj 这个字段本身是一个 JSON 字符串，因此构造完 JSON 之后还需要把它转换成字符串，详情参见发送钉钉互动卡片接口。

卡片发送定义了privateData指定用户可见，但卡片没有更新

答：需进入卡片搭建平台 > 数据源 > 编辑，选择对应的字段开启私有变量即可正常更新。

吊顶卡片关闭组件在哪里，怎么关闭？

答：实现关闭吊顶卡片分两步：

第一步：搭建关闭按钮 UI。

需要进入卡片搭建平台创建吊顶卡片，若已经创建吊顶卡片可忽略。

方式一：使用吊顶卡片模版，模版已经包含关闭按钮。

方式二：使用图片直接搭建，布局参考方式1的模版布局。

第二步：通过调用服务端API-关闭互动卡片吊顶关闭互动卡片吊顶实现关闭。

重要

设置回传请求需调用注册互动卡片回调地址。

选择“X”图片组件所在的布局 > 点击“X” > 点击事件类型选择“回传请求” > 设置回传参数。

群成员关闭卡片后所有人不可见，建议设置关闭按钮仅对管理员可见。

卡片是否可以设置组件动态可见

答：可以实现，以横排按钮组件为例：

设置数据源>编辑变量> 按钮的点击事件类型选择回传请求 > 设置回传参数 > 设置是否显示选择条件计算 > 创建新条件。isShow为true时，则该按钮展示到卡片，isShow为false时，则该按钮不展示到卡片。

卡片多媒体资源绑定变量方式怎么上传和拿到这些资源

答：多媒体资源支持http协议，可以直接使用业务可用的http资源。

Windows和安卓卡片显示 [Object Object]

答：卡片测试期间因数据和模版更新，可能出现不兼容老版本模版的情况，重启下钉钉即可重新拉取模版。

添加多个按钮，提示不能添加多个

答：横排或者竖排按钮的添加在按钮设置最下方添加新按钮。

竖排按钮不支持显示隐藏，竖排按钮没有是否显示配置

答：区块库组件按钮暂不支持，请使用普通组件实现。

修改于 2024-01-29 09:47:46