# 消息流概述
## 功能介绍

**「飞书消息流开放」**是指通过调用相关接口，在飞书消息列表中展示形式内容更加丰富的**消息流卡片**，通过自定义消息流卡片的标签、按钮、提示音、临时置顶状态等，让重要信息触达更轻松。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/ecb74df5e0624f1c8d4abaf28c5b904c_ixg5CE6DmL.png?height=678&lazyload=true&width=1280)

<br> 
**「飞书消息流开放」优势一览：**

接入前 | 接入后
---|---
-   重要信息难触达，各类消息堆积，信息爆炸<br>- 新消息不断刷新消息列表，重要信息被淹没<br>- 信息处理路径长，处理过程操作繁琐，容易遗忘<br>- 通知提示音无区分，无法感知收到重要信息<br>![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/58e64c4370e7d02b1a7a6c4760352f4d_EeVk5CenFE.png?height=1800&lazyload=true&width=4000) | -   消息流卡片醒目的**按钮**、**标签**，重要信息一眼看到<br>- 重要信息**可持续置顶**展示，防止遗漏<br>- 关键操作按钮外露，**一键处理**重要事项<br>- **自定义通知提示音**，第一时间了解重要信息    <br>![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/4e4b7421de441c3ea8b66d8c7b1b9021_SesG0VK4Qi.png?height=1800&lazyload=true&width=4000)

<br> 

## 适用场景

**「飞书消息流开放」** 功能应用场景多样，下面列举几个典型的应用场景。

使用场景 | 场景描述 | 接入效果
---|---|---
**考勤打卡提醒** | 痛点：上下班时间事项繁多，容易忘记打卡，导致缺卡缺勤。<br>接入后：<br>- 上下班打卡前十分钟，打卡机器人在消息列表中置顶展示，形成强提醒，避免遗忘；<br>- 配置快捷打卡按钮，可一键打卡，操作简单方便；<br>- 打卡完成后取消置顶，不打扰日常工作。 | &nbsp;
**重要日程提醒** | 痛点：日程繁多，记不清有哪些日程需要参加，容易错过重要日程会议。<br>接入后：<br>- 日程置顶展示，第一时间获取日程信息；<br>- 通过标签提示日程开始时间，提前安排；<br>- 展示加入会议按钮，一键入会。 | &nbsp;
**投诉差评处理** | 痛点：投诉差评需要及时进行处理，但消息量较大的情况下，难以快速找到对应信息。<br>接入后：<br>- 投诉信息置顶展示，与其它消息区分明显，一目了然，处理及时；<br>- 设置自定义提示音，设备待机状态下也能第一时间了解到信息触达。 | &nbsp;
**员工培训任务** | 痛点：一线员工琐事较多，消息一看即忘，重要通知容易遗漏。<br>接入后：<br>- 培训通知在员工飞书消息列表常驻提醒，持续置顶，防止员工因处理其它事项而忘记培训；<br>- 配置按钮，员工可一键前往学习，缩短操作路径；<br>- 只有员工完成培训后，提醒才自动消失，大大提高任务完成率。 | &nbsp;
**进货配送通知** | 痛点：员工需要多次了解货物配送时间、进度，多次进入系统，操作不方便、不灵活。<br>接入后：<br>- 货物开始配送时，在消息列表自动显示配送情况、预计送达时间；<br>- 通过按钮可快捷签收、查看进货单、联系司机，操作更加快捷方便；<br>- 确认收货后通知自动消失。 | &nbsp;
…… | 更多场景案例，可参考 👉  [🔥飞书首页升级助力门店提效](https://bytedance.larkoffice.com/docx/RU0Tdvtb8oIrwSxWnxacWZAGnQc)

<br>
## 名词介绍

**「飞书消息流开放」** 中包括如下几种名词介绍：

名词 | 标识 | 解释 | 示例图
---|---|---|---
消息流卡片 | ```app_feed_card``` | -   在消息列表中一种特殊的消息展示类型，使信息更加醒目，更快触达用户。<br>- 消息流卡片有以下 2 种类型：<br>- 应用消息流卡片：由应用创建的消息流卡片，可自定义消息流卡片的外观、点击后跳转的链接、消息流长按或右键操作。<br>- 群聊/机器人消息流卡片：将应用机器人会话、机器人所在群聊直接更新为消息流卡片，仅可自定义卡片按钮、即时提醒状态等。 | <p>应用消息流卡片
即时提醒 | ```time_sensitive``` | - 即时提醒状态打开时，消息流卡片将在消息列表中常驻置顶展示，保持在消息列表第一位，不会被新消息淹没。<br>- 即时提醒状态关闭时，消息流卡片不再置顶展示。<br>- 应用对象：应用消息流卡片、群组 & 机器人会话消息流卡片<br>- 即时提醒状态，true-打开，false-关闭 | &nbsp;

<br>
## 接入流程
### 应用消息流卡片：

步骤 | 介绍
---|---
1. 创建一个应用 | -   如需创建企业自建应用，可参考 [自建应用的开发流程](https://open.feishu.cn/document/home/introduction-to-custom-app-development/self-built-application-development-process)<br>- 如需创建应用商店应用，可参考 [开发和上架应用商店应用](https://open.feishu.cn/document/uMzNwEjLzcDMx4yM3ATM/uYzNwEjL2cDMx4iN3ATM)
2. 开通权限 | 调用 API 前，你需要先获取访问凭证并开启对应的权限：<br>- 创建、更新、删除应用消息流卡片<br>- 调用即时提醒能力
3. 获取目标推送用户的 user id， [创建消息流卡片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/group/im-v2/app_feed_card/create) | - 可自定义消息流卡片的外观、点击后跳转的链接、消息流长按或右键操作
4.  调用 API，[更新消息流卡片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/group/im-v2/app_feed_card-batch/update) | -   该接口用于更新消息流卡片的头像、标题、预览、标签状态、按钮等信息<br>- **字段更新策略**：具体更新的字段以 `update_fields` 为准，根据 `update_fields` 代表的字段从 `app_feed_card` 中取出来进行更新，不在 `update_fields` 中的字段不会更新
5.  调用 API，[删除消息流卡片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/group/im-v2/app_feed_card-batch/delete) | - 通知任务完成后，调用此 API 删除对应的消息流卡片

### 群聊、机器人消息流卡片：

步骤 | 介绍
---|---
1. 创建一个应用 | -   如需创建企业自建应用，可参考 [自建应用的开发流程](https://open.feishu.cn/document/home/introduction-to-custom-app-development/self-built-application-development-process)<br>- 如需创建应用商店应用，可参考 [开发和上架应用商店应用](https://open.feishu.cn/document/uMzNwEjLzcDMx4yM3ATM/uYzNwEjL2cDMx4iN3ATM)
2. 开通权限 | 调用 API 前，你需要先获取访问凭证并开启对应的权限：<br>- 创建、更新、删除应用消息流卡片<br>- 调用即时提醒能力
3. 选择已有群组/机器人会话，获取对应 chat_id | - 如选择某个群组，需要将应用机器人拉入目标群组中
4.  调用 API，[更新消息流卡片按钮](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/group/im-v2/chat_button/update) | - 可为群组消息、机器人消息的消息流卡片添加、更新、删除快捷操作按钮
5.  如需常驻置顶，开启“[即时提醒](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/group/im-v2/feed_card/patch)”状态 | -   需要获取希望置顶的用户 `user_id`，调用后，消息流卡片在这些用户的消息列表常驻置顶<br>- 如需取消置顶，再次调用，将即时提醒状态关闭即可