亿信ABI
当前版本:5.6.1

与飞书配置

1.概述

飞书支持消息推送和在飞书上查看ABI报表资源。支持流程管理和用户注册等消息通知推送到飞书。同时支持添加ABI报表资源到飞书,在飞书上查看ABI报表资源。

2.创建企业应用

创建企业应用,首先需要登录飞书首页,创建企业号,后进入飞书管理后台创建应用。

飞书管理后台:https://hcnow0hhymrv.feishu.cn/admin/index

飞书开放平台:https://open.feishu.cn/app?lang=zh-CN (开发者后台)

用管理员的账号扫一扫登录飞书管理后台。已创建成功的飞书企业管理后台的首页界面(如下图),记录此处的企业编号(CorpId)。后续飞书配置时需要。

在飞书管理后台创建一个应用,点击【工作台】-【应用管理】-【创建应用】即可。

创建好应用后,需要发布,当前配置方可生效。点击【创建版本】填好版本号,点击保存,发布即可。

发布完成后,飞书应用即创建完成。点击查看该应用的应用凭证与基础信息,查看并记录 “飞书应用App ID和App Secret”,后续ABI中添加飞书应用时需要。

以上飞书应用便创建成功,接下来在ABI中添加飞书应用。

3.飞书开放平台权限设置

在ABI中添加飞书应用之前,需要在飞书开放平台里【权限管理】中。为以下字段添加权限。方不会出现(如图2)中因权限问题提交不成功的【提示】。

“admin:app.info:readonly,contact:contact.base:readonly,contact:contact:readonly_as_app,contact:department.base:readonly,contact:department.organize:readonly,contact:group:readonly,contact:user.employee_id:readonly,contact:user.id:readonly,contact:user.phone:readonly,event:ip_list,im:chat,im:chat:operate_as_owner,im:message,im:message:send_as_bot,im:message:send_multi_depts,im:message:send_multi_users,tenant:tenant:readonly,im:resource:upload,im:resource,tenant:tenant:readonly,contact:user.base:readonly,contact:user.department:readonly,im:chat,im:chat:create,contact:user.employee:readonly,im:message,im:message:send_as_bot,im:message:send_multi_users,im:message:send_multi_depts"

(如图2)

4.添加飞书应用

权限添加后,在ABI中,【系统管理】-【系统设置】-【飞书配置】点击【添加飞书应用】按钮。输入相应的信息项后点击确定,飞书应用即可添加成功。

a. 飞书应用名称:用来描述应用名称;

b. 应用ID(appId):在【飞书开发平台】下所对应的应用中的【凭证与基础信息】中找到;

c. 应用秘钥:在【飞书开发平台】下所对应的应用中的【凭证与基础信息】中找到;

d. 企业编号(CorpId):在【飞书管理后台】-【企业概览】中找到企业编号;

e. 用户匹配规则:有“按飞书账号匹配“和”按手机号匹配”两种匹配方式。默认是按飞书账号匹配;

f. 匹配字段:下拉的字段为系统用户字段,匹配字段默认显示为USERID_(用户代码),用户也可以选择其他系统用户字段进行匹配。

例如:用户匹配规则是“按手机号匹配”,匹配字段是按“手机”的匹配方式,则需要在【机构用户】中创建一个与电话相同的系统用户ID。匹配完成后,去【飞书配置】-【应用成员】中查看飞书成员ID与系统用户是否匹配上。

添加飞书应用后,飞书消息推送不仅可以推送给用户,还可以推送给群聊。只需要配置群聊即可。

a. 选择应用:选择想要新建群聊的飞书应用ID;

b. 群名称:可根据需求填写群名称;

c. 群成员:在选择飞书应用后会加载相应的用户,可选择进入群聊的用户,最少2人,最多2000人;

d. 群管理员:添加群聊的管理员。群管理员ID必顺在已选群成员中,也可为空。

5.飞书消息推送

飞书支持流程管理和用户注册等消息通知推送到飞书。具体功能操作,可以参照各功能对应的说明。

推送完成后在【系统管理】-【日志】-【飞书应用推送日志】中可以查看相关日志。

6.飞书配置ABI菜单链接

添加ABI报表资源到飞书,在飞书上查看ABI报表资源。

6.1 菜单链接添加ABI资源

点击飞书应用【菜单链接】按钮进入到菜单链接页面,有移动端和PC端两种资源链接。

添加移动端的资源链接,点击【添加】按钮,添加移动应用中的资源(如下图)

此需要强调一下,登录亿信ABI时,一定要用外网域名地址访问,并且需要在【系统管理】-【参数配置】-【服务器地址配置】中配置外网地址。不然会提示您:

添加完成后如下, 可以看到资源类型总共分为5种类型:

· 移动应用首页,显示ABI中所有的移动应用资源;

· 资源列表,显示所选择的应用下的所有资源包括:移动应用、公告、待办事项、发起流程;

· 分组资源,显示所选择的分组下的所有资源;

· 表单资源,直接展示该表单;

· 分析表资源,直接展示该分析表。

注意:复制生成的资源链接地址,添加至飞书的“应用首页地址”或“PC端首页地址”中,复制生成的重定向地址,添加至飞书的“重定向URL”中

添加PC端的资源链接,点击【添加】按钮,添加PC端应用中的资源(如下图)

添加完成后如下, 可以看到资源类型总共分为4种类型:

· PC首页,显示PC登录页;

· 表单资源,显示所选择的应用下的表单资源;

· 分析资源,显示所选择的应用下的报表资源;

· 门户资源,直接展示门户资源。

6.2 配置ABI访问菜单

ABI资源链接地址获取后,在飞书开放平台【添加应用能力】-点击添加“网页应用”,创建网页应用,在【网页应用】中,添加我们要访问的移动端和PC端的ABI链接。

在飞书开放平台【开发配置】-【安全设置】中,添加我们要访问的移动端和PC端的ABI重定向 URL。点击“创建版本”更新新版本,保存发布即可。

6.3 飞书访问ABI菜单

登录飞书账号,点击【工作台】,找到对应的应用就可以查看表单或ABI分析表。比如这里企业应用叫“亿信华辰”如下图效果展示。

PC端:

移动端:

备注:
当前登录的飞书用户需要有能匹配上的系统用户账号,点击挂载了ABI链接的应用后,系统自动用匹配上的系统用户账号免登录ABI来查看报表资源,并且该系统用户账号需要有对应的移动应用或者分析表、表单的查看等权限。

 

附件列表

0

文档内容仅供参考
如果您需要解决具体问题,还可以登录亿信社区
在提问求助板块提问,30分钟内帮您解决问题

如果您认为本词条还有待完善,请编辑

上一篇与钉钉配置

下一篇运营监控

请先登录