跳到主要内容

飞书自建应用

应用介绍​

飞书是字节跳动旗下的企业协同OA系统，飞书有两种接入方式，一个企业自建的飞书机器人进行接入，一个使用HiFlow在飞书平台的机器人进行接入。两个方式的功能有所不同，本文介绍的是飞书企业自建机器人的接入方式。 官网：https://www.feishu.cn/

应用场景介绍​

通过HiFlow场景连接器，可以快速打通飞书自建应用和其他应用之间消息&数据，实现比如定时/自动发送消息/接收消息/自动回复等。

应用支持的触发条件和执行操作​

（一）飞书自建应用应用支持的触发条件如下：

1. 会议室状态发生变更时：会议室被预定、被释放以及被修改时间时会推送此事件

2. 审批实例状态变更：为保护企业的数据隐私，在应用后台订阅审批事件后，仍需要再次通过执行事件[订阅/取消订阅审批定义]来订阅指定的审批定义，才会收到审批事件；开发者不会收到未订阅的审批定义产生的事件

3. 任务信息变更时：当任务信息发生了变更

4. 机器人消息已读时：当用户阅读机器人发送的单聊消息时

5. 员工离职时：当员工离职时触发流程

6. 员工入职时：当员工入职时触发流程

（二）飞书自建应用应用支持的执行操作如下：

1. 发送文本消息：发送纯文本消息

2. 发送富文本消息：给员工或者部门下所有员工发送文本消息

3. 向指定的用户发送消息：给指定的用户发送文本消息

4. 订阅/取消订阅审批定义：应用订阅后，该应用就可以收到该审批定义对应实例的事件通知；当应用不希望再收到审批事件时，可以取消订阅进行取消

5. 获取审批实例ID列表：通过审批定义code获取审批实例ID

6. 获取单个审批实例详情：通过审批实例ID获取审批实例详情

7. 获取单个用户信息：获取指定用户的详细信息

8. 审批同意/拒绝：同意或者拒绝指定审批事件

9. 查看审批定义：查看摸个审批定义的详情

10. 获取会议报告：获取一段时间内的会议报告

应用账号和参数配置（或其他相关）​

（一）飞书自建应用使用应用的前置条件

  1. 需要是飞书企业管理员；
  2. 需要进入飞书开放平台创建【企业自建应用】，成功创建后即可获得AppID和Secret；
  3. 点击成功创建的应用后，在左侧栏【权限管理】-【设置通讯录权限范围】下，将通讯录权限范围配置为“全部成员”，然后再【权限配置】下将【事件订阅】、【通讯录】、【消息与群组】、【审批】、【任务】、【视频会议】和【会议室】下的所有权限进行批量开通；
  4. 在左侧栏【事件订阅】下，将请求地址配置完成后，点击【添加事件】，将【审批实例状态变更】、【消息已读】、【员工离职】、【员工入职】、【群配置修改】、【任务信息变更】、【会议室状态信息变更】这些事件进行添加；
  5. 完成以上权限的配置和添加后，在左侧栏【应用发布】-【版本管理与发布】下，点击创建保存版本后，点击【申请线上发布】，企业管理员在飞书管理后台-工作台-应用审核中进行审核通过并发布，发布后以上申请的所有权限和内容才可生效

（二）添加新的飞书自建应用应用账户 添加新的飞书自建应用应用账户需要:

  1. 必填字段：AppID、App Secret
  2. 需要进入飞书开放平台创建【企业自建应用】，成功创建后即可获得AppID和Secret

enter image description here#500px

（三）飞书自建应用的配置参数 作为触发条件时，以【会议室状态发生变更时】为例，配置参数如下

  1. 完成【前置条件】相关内容和权限的开通和生效；
  2. 添加账号：可以选用在触发条件添加的账户，也可以添加一个新账户；
  3. 将【配置参数】下生成的HTTP/HTTPS URL地址复制，需要进入飞书开放平台-【事件订阅】下的 【请求地址配置】，将复制的URL添加配置完成
  4. 操作一次选择的触发事件后，点击【测试并预览】获取到真实的样本数据，可在后续节点引用

enter image description here#500px