通过推送渠道配置功能,您可以自行配置审批、告警消息等飞书机器人,用来接收相应的飞书消息,从而实现 DataLeap 各产品模块对接飞书应用执行审批、发送告警的需求。
1 约束限制
- 具备 DataLeapFullAccess 权限策略的账号才可以查看和修改配置信息。
- 目前仅华北2(北京)、华东2(上海)、华南1(广州) 和亚太东南(柔佛) 四个区域支持该功能,华北2(北京)自动驾驶云区域暂不支持。各区域开服的操作说明可参见概览。
- 目前已支持推送渠道配置的产品模块有数据开发、数据安全、数据质量。
2 前提条件
已在飞书开放平台创建相关应用的机器人。创建机器人的相关说明可参见飞书应用机器人配置。
3 操作步骤
- 登录 DataLeap 控制台。
- 选择推送渠道配置,进入飞书应用&机器人推送渠道配置页面。
- 配置飞书应用机器人。
- 单击主应用操作列的编辑按钮,填写机器人APP ID 和 Secret 后,单击保存并验证按钮,完成主应用绑定操作。
- 单击某个应用操作列的编辑按钮,填写机器人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
- 无论是否与主应用使用同一个 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
- 配置多个应用时,请确保它们属于同一个飞书组织。
- 配置成员飞书账号的映射关系。
- 单击成员飞书账号管理按钮,进入成员飞书账号管理页面,可以查看处于未匹配状态的成员列表。
- 单击调整匹配规则按钮,在弹出的窗口中,按需设置合适的账号默认匹配规则。

支持以下四个规则设置选项:
- 飞书邮箱=火山用户名:即账号的飞书邮箱与火山引擎用户名相同时,才会匹配成功。
- 飞书邮箱=火山用户名@企业邮箱后缀:即飞书邮箱与火山用户名@企业邮箱后缀相同时,才会匹配成功。其中,企业邮箱后缀根据实际情况自行填写。
- 飞书邮箱=火山邮箱:即飞书邮箱与火山引擎邮箱相同时,才会匹配成功。
- 飞书手机=火山手机:即飞书绑定的手机号与火山引擎绑定的相同时,才会匹配成功。
- 单击刷新按钮,可以查看账号是否匹配成功。

- 还可单击某个用户的修改按钮,修改其飞书账号信息,单独调整对该用户的匹配方式。
说明
- 设置好的匹配规则即为默认匹配规则。默认匹配规则不受 APP ID 是否配置影响,仍然可以使用。APP ID 配置完成后,已有的默认匹配规则直接生效。
- 调整匹配规则后,仅对匹配失败以及后续新增的用户生效,已匹配成功的不会随着规则改变而重新匹配。
- 若账号显示未匹配状态,请检查匹配规则并单击刷新按钮进行内容刷新。
4 后续操作
推送渠道配置好后,在对应的已支持飞书渠道的产品模块即可使用飞书功能:
- 配置告警消息通知机器人推送渠道后,您可在数据开发、数据安全、数据质量等产品模块进行相应的飞书消息设置,以实现接收飞书消息通知。飞书消息设置相关说明请参见监控规则、配置Hive模板规则、扫描管理等。
- 配置审批应用推送渠道后,在数据安全中,提交权限申请工单后,相应用户在不同情况下可以收到飞书审批消息:
- 轮到“我”审批时,作为审批人会收到飞书审批通知,并可通过飞书审批工单。详细说明请参见审批工单。
- “我”提交的审批单完结时,作为申请人会收到审批完结通知。
说明
- 申请人和审批人必须有飞书账号映射,审批人才能收到飞书审批。
- 获权方是否有飞书账号映射不影响飞书审批,也就是说获权方没有飞书账号映射,审批人也能收到飞书审批。