1. 概述

1.1 应用场景

飞书集成环境下，希望能够将结构化的图表内容以卡片形式嵌入至聊天消息、群置顶消息、链接预览等飞书协作场景中，提升信息传递效率。

例如消息卡片场景下，用户通过消息卡片推送项目报告、业务监控、审批流转等信息。

1.2 功能简介

仪表板新增「发布飞书卡片」功能，将产品中的图表字段与飞书卡片中的变量进行映射匹配后可推送至飞书的个人/群组中。

1.3 注意事项

需要在 飞书集成模式 下才能使用。

2. 功能说明

​

3. 制作卡片

3.1 准备工作

1）开通应用发送消息权限

在飞书开放平台，在「权限管理」页面中，点击「开通权限」。将以下权限的 Key 粘贴到权限搜索框，点击 确认开通 权限：

im:message:send_as_bot

2）检查应用可用范围

应用的可用范围必须是所有用户，如下图所示：

3.2 在飞书中创建卡片

如何制作飞书卡片请参考飞书官方文档：飞书卡片

https://open.feishu.cn/cardkit 进入飞书卡片搭建环境，创建空白卡片：

注1：右上角企业账号信息和九数云集成飞书企业信息保持一致。

注2：需要新建空白卡片，才能成功推送。

接下来在飞书卡片中配置变量，详情请参见：配置卡片变量

将组件拖入界面后，可以在组件中设置变量，如下图所示：

表格还可以设置列变量，如下图所示：

保存卡片并发布，如下图所示：

3.3 配置卡片发送对象

制作完成后，即可在将卡片添加至应用和自定义机器人。如下图所示：

发送到个人

发送卡片到某个用户，需要添加「所有应用」。如下图所示：

注：管理员可只添加「九数云应用」。

发送到群

1）应用添加机器人

在左侧导航栏中，进入 应用能力 > 添加应用能力 页面，找到 机器人 卡片，并点击 添加。

2）创建群自定义机器人

若用户 使用自定义机器人发送飞书卡片，则需要参考链接文档创建并配置应用。

登录飞书客户端。创建一个群聊，打开群聊的设置界面。

打开群聊的 设置 界面，添加自定义机器人，如下图所示：

复制并保存好 Webhook 地址，如下图所示：

4. 添加卡片推送数据

4.1 添加卡片推送设置

进入项目下的指定仪表板中，拖入图表后，点击「发布飞书卡片」，如下图所示：

复制卡片 ID ，如下图所示：

进行卡片配置，此处设置发送到机器人群中，输入 Webhook、卡片ID，并匹配变量，输入卡片中的变量名，由于卡片中变量设置的是柱状图，因此选择对象，并选择仪表板中的图表组件，如下图所示：

对于图表Pro，需要手动选择飞书图表中的 X轴和 Y轴分别匹配图表 Pro 中的哪个字段，如下图所示：

在设置完成后，用户还可以点击「向我发送预览」测试是否设置成功，如下图所示：

4.2 发送方式说明

发送方式有两种，全量发送和按仪表板权限发送，说明见下表。

例如，仪表板权限配置指定空间下的用户只能查看「长期合同」数据。如下图所示：

卡片配置中选择「按仪表板权限发送」数据，所选的用户「陶某」在仪表板权限的指定空间（april的个人团队）内。如下图所示：

陶某仅可查看到长期合同的消息。如下图所示：

若依据「陶某」的权限发送到群。则群内的数据也仅可查看长期合同。如下图所示：

4.3 变量匹配说明

飞书卡片中的所有变量均需成功匹配才可发送成功，请参考下文的匹配关系进行配置。

5. 效果查看

5.1 发送到个人

5.2 发送到群

在消息中即可看到群聊机器人通知发送了变量生效后的卡片内容，如下图所示：

若设置了多种展示类型，发送的效果如下图所示：