功能概述
本文将围绕下面两个功能介绍「飞书消息」连接器的使用说明：
- 功能一：飞书消息连接器支持同步发送飞书消息，支持返回输出数据（包括 message id），下游节点可以引用输出的数据。
250px|700px|reset
- 功能二：飞书消息连接器发送飞书消息卡片时，指定用户支持直接通过 user id 来指定发送的用户
250px|700px|reset
使用「飞书消息」连接器可以实现很多有关飞书消息的相关需求，比如：
- 撤回已发送的飞书消息，需要指定撤回消息的 message_id
- 分析发出消息的内容，需要用 message_id 来获取消息的具体内容
- 发送消息后，通过 message_id 统计消息的已读情况
- 飞书连接器输出用户的 user id 后，直接引用 user id 发消息给相应的用户
使用说明
场景一：配置「飞书消息」连接器同步发送飞书消息
主要步骤 | 示例图 |
| 250px|700px|reset |
| 250px|700px|reset |
| 250px|700px|reset |
| 250px|700px|reset |
注意：
- 同步发送方式下，仅支持配置一个消息接收方（即发送单条消息）会有输出变量
- 异步发送方式下，可以支持配置多个消息接收方（即发送多条消息）但是不会输出变量
场景二：在飞书消息连接器的其他操作中引用 message id
说明 | 示例图 |
| 250px|700px|reset 250px|700px|reset 250px|700px|reset |
场景三：在系统节点中引用 message id
场景说明：将发送的消息 message id 与消息对象关联，可以在发送消息后使用「新增记录」或「更新记录」将 message id 存入对应的对象记录。
说明 | 示例图 |
| 250px|700px|reset |
场景四：通过 user id 来指定发消息的用户
user id 即 系统默认的「用户」对象中的「飞书用户 ID」字段
说明 | 示例图 |
| 250px|700px|reset 250px|700px|reset |
Q&A：哪些途径可以获得用户的 user id？
注意：
- 目前开发环境中「用户」对象的「飞书用户 ID」字段未自动同步开发者关联的测试企业中的用户 user id
- 所以在开发环境测试时，需要手动在「测试数据」中维护好用户的「飞书用户 ID」
- 默认的「用户」对象中有该字段（飞书用户 ID 即为飞书的 user id）
使用步骤：
- 使用该字段需要在「用户」对象页的「字段权限」中将「飞书用户 ID」的权限打开，如下图
250px|700px|reset
250px|700px|reset
- 然后在流程即可引用到用户记录的「飞书用户 ID」作为 user id 的值
250px|700px|reset
- 飞书连接器的很多输出变量可以返回 user id
- 在连接器的基础配置中，可以设置「用户 ID 类型」为 user id，然后在输出数据中用户的 id 即会以 user id 的形式输出，如下图所示
250px|700px|reset
250px|700px|reset
- 飞书租户管理后台-「成员与部门」菜单（仅租户管理员可查看）
- 打开成员的详情页，「用户 ID」内的值即为飞书的 user id
250px|700px|reset
- 预览页面 - 点击测试工具条内的「测试数据」
250px|700px|reset
在测试数据中的「成员与部门」菜单内，编辑测试用户的「飞书用户 ID」字段，飞书用户 ID 的值可以从上文中介绍的 飞书租户管理后台-「成员与部门」菜单（仅租户管理员可查看）中查看。
250px|700px|reset
