# 致远微协同 - 飞书审批集成配置

# 一、使用条件

1、用户需要先注册飞书(根据OA系统登记的手机号):https://ep8jgutfa0.feishu.cn/create/

2、下载PC端飞书:https://www.feishu.cn/download

3、配置审批前,请先完成集成配置,然后在配置审批

4、如果需要使用审批分组,需要进行组织架构同步才能配置审批分组

5、审批集成配置需要在飞书开放平台中另外新建一个应用,不能和集成配置使用同一个应用

# 二、OA后台微协同基础配置和致飞基础设置

1、填充相关参数后,点击确定按钮,提示成功后即可,如果不成功,可以先排查OA地址外网是否可以访问;如有内网环境与外网环境映射,请确保OA能够访问微协同(可以OA服务器通过curl -I https://weixin.seeyon.com看是否成功,如果是unknownhost,则在OA服务器上多次ping weixin.seeyon.com该域名,不同地区会返回不同ip地址,请以实时测试返回的ip地址为准,配置host文件);还需要确保微协同环境能够访问OA环境,请在OA访问策略配置白名单(微协同服务器出口ip:59.110.227.61)。

1660395954821.png 1660395967977.png 2、填充相关参数后,点击确定按钮,提示成功后即可。 注意事项:8.1SP2版本以前有致飞插件,页面如下。8.1SP2版本及其以后,将致飞插件合并到了微协同插件,因此只要微协同基础配置通过即可。

1660396739429.png 1660396697370.png

# 三、获取企业编码(CorpId)

1、登录PC端飞书,左上角人员头像——>管理后台———>首页(右侧的"企业信息"板块里面的"企业编号")

1660396298805.png 1660396306864.png 2、或者是登录飞书管理后台-点击左侧“企业设置”菜单-再点击“企业信息”菜单

1698830478542.png 1698830506613.png

# 四、飞书后台创建应用(创建 "审批" )

进入"飞书管理后台"——>工作台——>应用管理——>右侧页面创建应用。

1660396465447.png 然后点击创建企业自建应用

1660396499082.png 1698907612113.png

# 五、获取应用AppId、AppSecret(后续会在OA后台的审批集成配置里面使用)

点击第四步所创建的审批应用,复制应用凭证下的App ID和App Secret。

1698907721822.png 1698907826444.png

# 六、进入OA的后台飞书集成——>审批中心配置——>新建绑定,把对应的信息填充好后点击提交按钮,检测通过后会自动回填"飞书主页配置"的配置信息

1698908196575.png 1698908215291.png

# 七、添加机器人

飞书开放平台有所升级,需要用户自行添加应用能力。审批应用只需要添加机器人即可

1698908630024.png 1698833717608.png

# 八、安全设置

点击开放平台左侧菜单“安全设置”---->配置重定向URL

1698908816392.png

# 九、权限管理

建议所有权限均打开,可能较多会很麻烦。但是需要注意:通讯录和消息与群组权限必须打开。

1660396927210.png 如果需要同步组织架构到飞书中,那么通讯录权限范围必须设置为全部人员

1693278720068.png

# 十、版本管理与发布

1698909309145.png 发布并设置可使用范围(建议"所有员工")

1698909373599.png

# 十一、管理员审核发布的应用

1660397073837.png

# 致远微协同 - 飞书审批分组配置

# 一、创建分组之前需要先同步组织架构

1698911674412.png

# 二、进入OA的后台飞书集成——>审批中心配置——>分组配置

1698910252166.png 输入分组名称后,点击编辑,即可选择相关应用

1698914047017.png 选择相关应用后,数据就会回填至分组配置页面中

1698914117150.png 点击确定,提示保存成功后。数据将会保存至飞书审批中

1698914181305.png 登录飞书客户端-点击审批应用-再点击发起申请菜单。即可看到OA后台刚刚所配置的相关应用

1698914348355.png 1698914378672.png 点击OA审批下的应用将会打开电脑系统默认浏览器--展示应用页面(下图为点击新建事项后跳转的页面)

1698914538678.png

# 三、消息和审批测试

消息测试前请先修改配置

1698915094658.png OA触发流程后,消息和审批将会推送至飞书中(前提是人员必须要通过集成配置应用绑定微协同或者是同步过组织架构)

1698914907759.png 1698914978723.png 1698915015541.png

# 四、常见配置问题说明

# 1、集团版OA可以同步整个组织架构,也可以同步部分单位。创建分组后,在飞书客户端-审批-发起申请中。只有同步过去的单位下的人员才能看到,未同步过去的单位下的人员看不到

1698915251004.png

# 2、集团管理员可以允许单位管理员自建飞书审批应用。

1698915520001.png 允许后,登录单位管理员账号如下页面所示。审批配置与上面同理,只有在分组的时候可以看到分组类型只有单位和团队分组。 单位管理员配置的审批分组只有当前单位下的人员能看到。

1698915574503.png 1698915602387.png

# 3、很多用户在配置完审批后,又需要删除并重新配置。这时候就会出现各种各样的问题,例如删除失败、删除后重新创建发现使用不了、收不到消息和审批等等问题。

如果需要删除的话,请按照以下步骤一步一步的操作,顺序不能乱。 1.分组状态勾选为停用,然后在删除分组

1698916310003.png 2.删除审批配置

1698916382749.png 3.进入飞书管理后台-工作台-应用管理-已安装应用下搜索需要删除的应用-将应用停用。 停用后在进入飞书开发平台-找到该应用删除即可

1698916530693.png 1698916621498.png 4.如果顺序乱了,或则是操作过程中出现了问题。则采用以下手段:飞书后台操作不变;OA后台无需操作,直接进入OA数据库,找到如下几张表,将数据全部删除即可,删除后登录OA后台发现数据已经都没有了,删除后建议重启下OA,因为有数据缓存。

1698916807024.png 5.数据删除完毕后即可开始重新配置

编撰人:het、tanghu