飞书消息通知配置
主数据管理支持飞书通知功能。支持飞书推送的模块有:【主数据模型-(实体/分类/BOM)-通知设置】、【流程中心-工作流-办理期限】、【流程中心-工作流-通知设置】、【流程中心-工作流-抄送设置】。
本章节将介绍如何使用飞书推送功能,流程主要分为以下五步:创建飞书应用→飞书开放平台权限设置→飞书应用配置→消息推送设置→飞书推送日志。
创建飞书
创建企业应用,首先需要登录飞书首页,创建企业号,后进入飞书管理后台创建应用。
飞书管理后台:https://hcnow0hhymrv.feishu.cn/admin/index
飞书开放平台:https://open.feishu.cn/app?lang=zh-CN (开发者后台)
用管理员的账号扫一扫登录飞书管理后台。已创建成功的飞书企业管理后台的首页界面(如下图),记录此处的企业编号(CorpId)。后续飞书配置时需要。
在飞书管理后台创建一个应用,点击【工作台】-【应用管理】-【创建应用】即可。
创建应用设置
创建好应用后,需要发布,当前配置方可生效。
点击【创建版本】填好版本号,点击保存,发布即可。
发布完成后,飞书应用即创建完成。点击查看该应用的应用凭证与基础信息,查看并记录“飞书应用App ID和App Secret”,后续主数据中添加飞书应用时需要。
以上飞书应用便创建成功。
为了消息推送,需要在飞书开发者后台(https://open.feishu.cn/app?lang=zh-CN),应用能力下,添加应用能力“机器人”
在权限管理,点击批量导入权限,将下面json复制进去(如下图),批量新增权限,确定-申请开通后,发布应用即可。
{ "scopes": { "tenant": [ "admin:app.info:readonly", "contact:contact.base:readonly", "contact:department.base:readonly", "contact:department.organize:readonly", "contact:group:readonly", "contact:user.base:readonly", "contact:user.department:readonly", "contact:user.employee:readonly", "contact:user.employee_id:readonly", "contact:user.id:readonly", "contact:user.phone:readonly", "corehr:person.phone.search:read", "corehr:person.phone:read", "corehr:person.phone:write", "im:chat", "im:chat:create", "im:chat:operate_as_owner", "im:message", "im:message:send_as_bot", "im:message:send_multi_depts", "im:message:send_multi_users", "im:resource", "tenant:tenant:readonly" ], "user": [ "admin:app.info:readonly", "contact:contact.base:readonly", "contact:department.base:readonly", "contact:department.organize:readonly", "contact:user.base:readonly", "contact:user.department:readonly", "contact:user.employee:readonly", "contact:user.employee_id:readonly", "contact:user.id:readonly", "contact:user.phone:readonly", "im:chat", "im:message" ] } }
飞书应用配置
飞书应用创建好后,进入环境配置飞书应用。
【操作步骤】:【系统设置】-【企业消息集成】-【飞书配置】
点击【添加飞书应用】按钮。输入相应的信息项后点击确定,飞书应用即可添加成功。(如下图)点击【飞书检测】检测通过,确定即可。
a. 飞书应用名称:用来描述应用名称;
b. 应用ID(appId):在【飞书开发平台】下所对应的应用中的【凭证与基础信息】中找到;
c. 应用秘钥:在【飞书开发平台】下所对应的应用中的【凭证与基础信息】中找到;
d. 企业编号(CorpId):在【飞书管理后台】-【企业概览】中找到企业编号;
e. 用户匹配规则:有“按飞书账号匹配“和”按手机号匹配”两种匹配方式。默认是按飞书账号匹配;
f. 匹配字段:下拉的字段为系统用户字段,匹配字段默认显示为USERID_(用户代码),用户也可以选择其他系统用户字段进行匹配。
例如:用户匹配规则是“按手机号匹配”,匹配字段是按“手机”的匹配方式,则需要在【机构用户】中创建一个与电话相同的系统用户ID,或将系统用户的电话设置为同一电话。比如我们给张三系统用户设置电话(如下图)。
匹配完成后,去【飞书配置】-【应用成员】中查看飞书成员ID与系统用户是否匹配上。
添加飞书应用后,飞书消息推送不仅可以推送给用户,还可以推送给群聊。只需要配置群聊即可。
选择应用:选择想要新建群聊的飞书应用ID;
群名称:可根据需求填写群名称;
群成员:在选择飞书应用后会加载相应的用户,可选择进入群聊的用户,最少2人,最多2000人;
群管理员:输入的群管理员ID必须在已选群成员中!可为空,系统会随机从已选群成员中选一人作为群主。
9.4.
消息推送设置
支持飞书消息推送的模块有:【主数据模型-(实体/分类/BOM)-通知设置】、【流程中心-工作流-办理期限】、【流程中心-工作流-通知设置】、【流程中心-工作流-抄送设置】。
【主数据模型-(实体/分类/BOM)-通知设置】操作流程:
例如我们对机构主数据模型的数据变更进行消息推送,发布机构主数据后;
然后在主数据维护-数据变更处,进行数据变更;
将会在飞书客户端,收到相关变更的消息推送(如下图)。
【流程中心-工作流-办理期限】操作流程:
【流程中心-工作流-通知设置】操作流程:
【流程中心-工作流-抄送设置】操作流程,在抄送设置中有“手工抄送”和“自动抄送”两种抄送方式选择。
手工抄送:选择手工抄送后,当用户在审批流程时,可手工抄送给相关用户。
如下图,手动抄送给“张三”。张三系统用户与飞书【应用成员】进行匹配
将会在飞书客户端,收到相关审批流程的消息推送(如下图)。
自动抄送:自动抄送中,可以直接指定“收件人”。
飞书推送日志
飞书发送成功后可查询日志,日志查询入口:
将鼠标放在设置图标上点击【系统设置】-【日志】-【飞书应用推送日志】便可查看推送日志。
请先登录