通过推送渠道配置功能，您可以自行配置审批、告警消息等飞书机器人，用来接收相应的飞书消息，从而实现 DataLeap 各产品模块对接飞书应用执行审批、发送告警的需求。

1 通知类型说明 #

不同类型的机器人发送的消息类型不同，各机器人发送消息的范围主要如下表所示，请根据实际情况配置合适的机器人。

2 约束限制 #

• 具备 DataLeapFullAccess 权限策略的账号才可以查看和修改配置信息。
• 目前仅华北2（北京）、华东2（上海）、华南1（广州） 和亚太东南（柔佛） 四个区域支持该功能。各区域开服的操作说明可参见概览。
• 目前已支持推送渠道配置的产品模块有数据开发、数据安全、数据质量。
• DataOps 人工卡点机器人通知目前是白名单开通状态，您可通过提工单的方式联系我们进行白名单开通使用。
• 开通分布式数据自治服务后，才能使用组织架构相关的功能。

3 前提条件 #

已在飞书开放平台创建相关应用的机器人。创建机器人的相关说明可参见创建飞书应用机器人。

4 操作步骤 #

1. 登录 DataLeap 控制台。
2. 选择推送渠道配置，进入飞书应用&机器人推送渠道配置页面。
3. 配置飞书应用机器人。
   1. 单击主应用操作列的编辑按钮，填写机器人APP ID 和 Secret 后，单击保存并验证按钮，完成主应用绑定操作。
   2. 单击某个应用操作列的编辑按钮，填写机器人APP ID 和 Secret 后，单击保存并验证按钮完成配置，配置结果显示在列表中。
      

   注意

   • 主应用用于飞书成员账号管理，必须先绑定主应用才可配置其他应用。
   • 若主应用和其他应用使用同一个 APP ID，只需主应用在飞书开放平台开通以下权限，除审批外的其他各应用即可正常使用，否则各应用需分别开通权限。权限开通的相关操作请参见创建飞书应用机器人。
     • 获取用户 user ID：contact:user.employee_id:readonly
     • 通过手机号或邮箱获取用户 ID：contact:user.id:readonly
     • 获取通讯录基本信息：contact:contact.base:readonly
     • 管理应用自身资源：application:application:self_manage
     • 获取应用信息：admin:app.info:readonly
     • 获取部门信息：corehr:department:read
     • 获取通讯录基本信息：旧版以应用身份读取通讯录（该权限当前已无法申请,仅对历史已开通该权限的应用有效） contact:contact:readonly_as_app 或新版 contact:contact.base:readonly
     • 获取用户组织架构信息：contact:user.department:readonly
     • 获取部门组织架构信息：corehr:department.organize:read
   • 无论是否与主应用使用同一个 APP ID，审批应用均需开通以下权限，才可正常使用：
     • 获取与发送单聊、群组消息：im:message
     • 查看、创建、更新、删除审批应用相关信息：approval:approval
     • 查询审批列表：approval:approval.list:readonly
     • 访问审批应用：approval:approval:readonly
     • 获取用户 user ID：contact:user.employee_id:readonly
     • 通过手机号或邮箱获取用户 ID：contact:user.id:readonly
     • 获取通讯录基本信息：contact:contact.base:readonly
   • 配置多个应用时，请确保它们属于同一个飞书组织。
4. 配置成员飞书账号的映射关系。
   1. 单击成员飞书账号管理按钮，进入成员飞书账号管理页面，可以查看处于未匹配状态的成员列表。
   2. 单击调整匹配规则按钮，在弹出的窗口中，按需设置合适的账号默认匹配规则。
      
      支持以下四个规则设置选项：
      • 飞书邮箱=火山用户名：即账号的飞书邮箱与火山引擎用户名相同时，才会匹配成功。
      • 飞书邮箱=火山用户名@企业邮箱后缀：即飞书邮箱与火山用户名@企业邮箱后缀相同时，才会匹配成功。其中，企业邮箱后缀根据实际情况自行填写。
      • 飞书邮箱=火山邮箱：即飞书邮箱与火山引擎邮箱相同时，才会匹配成功。
      • 飞书手机=火山手机：即飞书绑定的手机号与火山引擎绑定的相同时，才会匹配成功。
   3. 单击刷新按钮，可以查看账号是否匹配成功。
      
   4. 还可单击某个用户的修改按钮，修改其飞书账号信息，单独调整对该用户的匹配方式。

   说明

   • 设置好的匹配规则即为默认匹配规则。默认匹配规则不受 APP ID 是否配置影响，仍然可以使用。APP ID 配置完成后，已有的默认匹配规则直接生效。
   • 调整匹配规则后，仅对匹配失败以及后续新增的用户生效，已匹配成功的不会随着规则改变而重新匹配。
   • 若账号显示未匹配状态，请检查匹配规则并单击刷新按钮进行内容刷新。

5 后续操作 #

推送渠道配置好后，在对应的已支持飞书渠道的产品模块即可使用飞书功能：

• 配置告警消息通知机器人推送渠道后，您可在数据开发、数据安全、数据质量等产品模块进行相应的飞书消息设置，以实现接收飞书消息通知。飞书消息设置相关说明请参见监控规则、配置Hive模板规则、扫描管理等。
• 配置审批应用推送渠道后，在数据安全中，提交权限申请工单后，相应用户在不同情况下可以收到飞书审批消息：
  • 轮到“我”审批时，作为审批人会收到飞书审批通知，并可通过飞书审批工单。详细说明请参见审批工单。
  • “我”提交的审批单完结时，作为申请人会收到审批完结通知。

  说明

  • 申请人和审批人必须有飞书账号映射，审批人才能收到飞书审批。
  • 获权方是否有飞书账号映射不影响飞书审批，也就是说获权方没有飞书账号映射，审批人也能收到飞书审批。
• 配置DataOps机器人后，在流水线配置、运行阶段，相应人员可以接收DataOps飞书消息通知。相应阶段的详细说明请参见配置流水线、3 流水线管理等。