移动平台

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

# 一、使用条件

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

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

3、若只是测试环境配置，请客户申请一个测试OA环境以及测试飞书企业进行配置。切记不能使用生产飞书企业，不然后续会产生一系列业务问题。

# 二、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

3、微协同基础配置那通过，说明微协同跟oa服务网络已互通。但是若是oa要跟飞书集成，oa服务器还必须能访问到https://open.feishu.cn 地址。

4、oa访问飞书api地址报连接超时异常，可能是无法解析飞书的域名。客户网管可以对 https://www.feishu.cn、https://open.feishu.cn 这两个域名做下dns解析，并且让oa服务能访问到这个两个地址。为保证配置后能够正常使用微协同，请务必在OA服务器上ping通上述两个地址，并且配置下DNS解析。必须要保证OA能够访问这两个地址。 1717664758443.jpg

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

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

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

1698830478542.png 1698830506613.png

# 四、飞书后台创建应用（优先创建 "致远协同" ）

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

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

1660396499082.png 1660396520615.png

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

点击第四步所创建的致远协同应用，复制应用凭证下的App ID和App Secret。

1698831303914.png 1660396573689.png

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

1698832989312.png

只有配置“致远协同”应用，并且通过致远协同应用绑定微协同后，才会收到消息，配置其他的应用或通过其他应用无法收到消息。

1660396610227.png 1660396772595.png 1660396783164.png

##七、回填飞书后台应用相关地址 飞书开放平台有所升级，需要用户自行添加应用能力。请添加网页应用和机器人即可

1698833352527.png 配置移动和PC应用主页地址

1698833654939.png

# 八、启动机器人

1698833717608.png

# 九、安全设置

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

1698833894166.png

点击开放平台左侧菜单“安全设置”---->配置H5可信域名

1735286956128.png

# 十、权限管理

必须将所有权限均打开。

1744338597522.png

# 十一、版本管理与发布

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

1698909492285.png

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

1660397073837.png 发布后最终PC端点击应用展示页面如下

1699002251605.png

##十三、常见配置问题说明

# 1、移动端页面修改：目前飞书集成配置默认跳转页面为全部应用，且页面下没有底导航展示。

1698834836010.jpg 要想有底导航展示的话，请修改飞书开发平台-网页应用-移动端主页地址

1698834786557.png

# 2、如果客户方需要使用审批集成，那么请先同步下组织架构，然后在配置审批。

即是在集成配置完成之后，在下方页面选择“致远协同”进行组织架构同步

1698911674412.png

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

如果需要删除的话，请按照以下步骤一步一步的操作，顺序不能乱。 1.删除集成配置

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

1698916530693.png 1698916621498.png 3.进入OA数据库，找到如下几张表，将数据全部删除即可，删除后需要重启下OA，因为有数据缓存。 wechat_user和wechat_department表数据全部删除

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

编撰人：het、tanghu、zhuling

快速跳转

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