# 机器人&消息卡片最佳实践
## 一、机器人&消息卡片能做什么
飞书机器人可以与飞书日历、审批、云文档等应用、第三方主流业务系统、企业自建系统打通，通过向用户发送消息卡片的形式，在飞书中实现一站式聚合各类应用的通知、报警。包括可与企业已有业务系统集成，发送监控告警、待办事项提醒、公司活动通知、数据日报推送、库存预警等。
消息卡片是飞书机器人可以推送的一种消息类型。对比普通的文本消息，消息卡片能让机器人在内容呈现、用户交互上更有生命力。[快速了解消息卡片](https://open.feishu.cn/document/home/build-a-beautiful-message-card-in-5-minutes/what-is-a-message-card)
文中提及的机器人及 DEMO 代码均为示例，真实的业务功能的实现，需要开发者进行适当研发。我们提供了开发教程及丰富的消息卡片模板来帮助你了解上手开发：
**开发教程**：[互动型消息卡片发送（审批）](https://open.feishu.cn/document/home/interactive-message-card-sending/introduction)
**卡片模板**：[消息卡片模板库](https://open.feishu.cn/tool/cardbuilder?from=howtoguide)
### 1. 一站式消息通知
通过[消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)，你可以：
* 使用消息卡片提供的富文本样式、图文布局模块，发送样式精美的卡片，比如醒目的通知、图文并茂的文章列表等，让重要的信息更好地触达用户。
* 使用消息卡片提供的交互组件，使用户只需在卡片上点击一下就能提交信息，从而无需离开聊天会话，就能快捷完成 OA 审批、投票统计、报警处理等系统操作。
与普通的纯文本消息相比，消息卡片可承载富文本、图片、按钮等多种元素，通知内容丰富多样，结构清晰明了，增加了消息通知的触达率和易读性。
[数据日报DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/338ce64a17929df4d0e467445226d938_7nioc6HsOq.json)、[写汇报提醒DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/af2e1c3c510691525d35a1b820686149_EK1uRlC1Af.json)
### 2. 可交互性强
消息卡片可承载按钮、链接、选择器等可交互元素，用户可通过与消息卡片的交互完成流程处理、意见反馈、信息收集等。
有关交互模块的详细示例、交互方式、字段等，可查看[交互模块](https://open.feishu.cn/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN)。
**案例**：
以向群成员发送周报提醒为例，消息卡片的可交互性提高了团队协作、信息收集和统计的效率。
有关如何在群聊中充分发挥 Bot 的作用，请查看[如何在群聊中使用机器人](https://open.feishu.cn/document/ukTMukTMukTM/uATM04CMxQjLwEDN)
- 在会话中@机器人，触发创建卡片，填写提醒内容，设置提醒时间频次。
- 到了提醒时间，机器人会将提醒发到群里， 群成员可以点击完成，表示收到或已完成。
- 到了截止时间，机器人会收集大家的完成情况，发送给创建人统计数据。
### 3. 研发成本低
实现以上功能无需客户端开发经验，飞书已经为卡片消息定义了结构化的组件与样式，通过服务端一段 JSON 描述，即可构造样式精美、可交互的消息卡片。使用 JSON 便可构建，主要依赖后端对接飞书官方现成接口，开发成本比小程序更低。
以开发一款与监控系统关联的报警机器人&消息卡片为例：
* 若仅需要实现报警通知实时推送，开发周期仅需要1~2天；
* 若在消息卡片中增加与监控系统交互的模块，例如点击按钮可查看日志等，也仅需要3~4天。
[DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/c56dd2d1255599751e4ab8cda91dd2a2_X8a2kw3RMn.json)
我们提供了[消息卡片搭建工具](https://open.feishu.cn/tool/cardbuilder?from=howtoguide)，让你可以通过简单的拖拽操作，所见即所得地调试你的卡片。更有丰富模板等你一键启用。立即使用工具直观感受下消息卡片的丰富能力吧！
## 二、场景案例
### 2.1 ERP：资源实时监控预警，提升资源管理效率
关联 ERP系统，提升企业资源可控性及使用效率。
#### 1. 预算预警、库存监控、AP风险预警
库存不足时，群聊内的 Bot 发送预警，并反馈处理进度。
[DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/7c08a59d5186ab1c036d50bce062518b_IT39X1BV1T.json)
#### 2. 员工IT资产盘点、IT资产报修反馈
[DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/6c75e9e2a4956f99e073e58aa46ff942_3Sot9hPzaf.json)
（要实现消息卡片向小程序或网页应用的跳转，可以配置 AppLink 协议的链接。参考 [AppLink 协议](https://open.feishu.cn/document/uYjL24iN/ucjN1UjL3YTN14yN2UTN)。）
### 2.2 DevOps：关联主流工具，消息通知助力流程高速运转
#### 1. 研发：可与主流工具如 Jira、Jenkins、GitLab 等打通，使用消息通知推进研发流程的运转。
[Jira 创建 issue DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/b1f0e439588e2bbe71cea2b1b7453aad_gDKXwWgT8Z.json)
（响应@Bot 的交互需要注册“接收消息”的监听事件，参考机器人和消息会话事件，如[机器人进群](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-member-bot/events/added)）
#### 2. 运维：与监控、运维系统打通，飞书实时收到告警，快速定位问题，立即做出响应
可与主流 APM 工具如 Zabbix、Nagios，或企业自建运维、监控系统打通，实现飞书一站式接收网络监控、服务器监控、应用性能监控等多维度监控的告警。
想要实时掌握服务器、应用的运行情况？害怕漏掉重要的应用监控告警信息？用飞书机器人即可实时收到监控告警及走势图。
无需跳转至其他界面，直接在飞书中查看日志。
也可以为机器人设置命令，直接通过“@ Bot+action” 的形式，执行相关操作，如启动备服务器以扩充计算资源等。
[DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/c56dd2d1255599751e4ab8cda91dd2a2_X8a2kw3RMn.json)
### 2.3 销售：线索追踪不用烦，销售助理在身边
[待办提醒DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/cabb22c3dde294fd53bc10eb50610043_20hR9GmxQ6.json)
交互操作请查看[交互模块](https://open.feishu.cn/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN)。
### 2.4 行政：智慧助手来帮你，活动省心又省力
智能机器人可协助各位轻松完成一场活动的举办。如活动前的组织，活动中的互动，活动后的反馈信息收集等，省心又省力。
有关如何在消息卡片中展示图片，请查看[上传图片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/image/create)。
有关用户在卡片上操作后，更新消息卡片，请查看[交互模块](https://open.feishu.cn/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN)。
### 2.5 人力资源：打通飞书与HCM二脉，提升人力资源调配效率
#### 1. 打通招聘系统，助力HR提升面试及新员工onboard效率
#### 2. 工资单推送
发薪日即时Bot通知，直接从消息卡片跳转至应用中心进行查询。
### 2.6 审批：关联 BPM 系统，实现流程标准化与高效流转
[审批消息卡片json代码以及相关接口连接](https://bytedance.feishu.cn/docs/doccnOAQ7iaYt43M9Ep5vr3fOv9)
## 三、Bot&消息卡片的构建
### 构建方法
消息卡片通过 JSON 便可轻松构建。我们提供了丰富的元素和[交互模块](https://open.feishu.cn/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN)，你可以自由组合出自己需要的卡片样式，并通过后端对接飞书官方现成接口实现与其他应用的关联，在一周之内完成 Bot+消息卡片的开发。
有关如何开发消息卡片，请查看[消息卡片开发流程](https://open.feishu.cn/document/ukTMukTMukTM/uAzMxEjLwMTMx4CMzETM)。
有关如何构建消息卡片的样式，请查看[卡片结构](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)、[卡片内容](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)。
### 构建案例
[飞书-生日机器人方案详细设计](https://bytedance.feishu.cn/docs/doccnKv7CCYNgKVE9IfAKSmXZtc)
以下是两类消息卡片的模板。
窄版模板
[窄版卡片DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/b45f1edb73f56c1bd60923995a98f66b_0tifMCwCfg.json)
宽版模板
[宽版卡片DEMO代码](//sf3-cn.feishucdn.com/obj/website-img/933a9ec3e9f9ce8c5e191eb1af01ac37_bl727hfp3u.json)
## 四、相关文档
有关如何开发机器人消息卡片，请查看[消息卡片开发流程](https://open.feishu.cn/document/ukTMukTMukTM/uAzMxEjLwMTMx4CMzETM)。
有关如何构建消息卡片的样式，请查看[卡片结构](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)、[卡片内容](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)。
有关消息卡片的设计，请查看[消息卡片设计规范](https://open.feishu.cn/document/ukTMukTMukTM/ugDOwYjL4gDM24CO4AjN)。
[如何使用 Bot](https://getfeishu.cn/hc/zh-CN/sections/360004585573-机器人)。