这是本节的多页打印视图。点击此处打印.

移动微协同

支持COP平台应用可视化挂载到移动APP上，实现应用注册、组织同步、事项同步、消息同步，同步监控等。

1: 企业微信

2: 钉钉

3: 飞书

1、概述

支持COP平台应用可视化挂载到移动APP上，实现应用注册、组织同步、事项同步、消息同步，同步监控等。

2、能力区隔表

能力分类	能力描述	钉钉	企业微信	飞书
插件管理	一个租户下多个同类插件	√	√	√
插件管理	一个租户下多个不同类插件	√	√	√
插件管理	一个插件配置对应多个应用	√	√	√
组织映射	自动生成部门映射	√	√	√
组织映射	自动生成用户映射	√	√	√
组织同步	COP同步至移动app	√	√	√
组织同步	移动app同步至COP	√	√	√
免登	移动app免登进入COP应用	√	√	√
统一身份认证	移动app和COP同时接入同一身份认证，且用户登录态互信	√	√	√
应用发布	COP任一应用发布至移动app工作台	√	√	√
应用发布	三方异构应用发布至COP平台再由COP发布至移动app工作台	√	√	√
事项同步	COP事项中心挂载到移动app工作台	√	√	√
事项同步	COP事项推送至移动app原生待办中心	√	×	×
事项同步	事项内容按需过滤	√	√	√
事项同步	移动app免登录打开COP事项详情页	√	√	√
消息同步	COP消息推送至移动app会话消息中	√	√	√
日程同步	COP日程同步至移动app日程中心	×	√	×
扫码签到	移动app扫码签到会议	√	×	×
主动唤醒IM	COP一键唤醒移动app，并进入会话	×	√	×

3、集成场景

1 - 企业微信

1、概述

平台提供可挂载到企业微信上的移动办公应用（微协同），可实现待办事项查看处理、已办事项查看、事项详情页展示、个人工作台、通讯录、自助绑定/解绑、免登进入UDC定制应用等功能。

2、场景支持

场景	场景说明
应用上架/发布	支持COP平台以”微协同“应用挂载到企微上，包含事项中心、通讯录、个人工作台、个人信息等部分，其中个人工作台可以免登进入COP平台子应用中。支持UDC定制应用单独挂载到企微应用中心。
免登	应用发布成功后，支持企微客户端免登陆进入COP应用移动首页中。COP与企微手机号码不一致时，用户需要自助绑定/解绑后才能实现免登。
组织同步	支持COP组织人员数据同步至企微通讯录中
事项同步	“微协同”发布至企微后，用户可以在企微查看、处理待办事项
消息同步	COP消息中心的消息将会同步展示在企微应用消息中

3、操作步骤

序号	步骤名称	责任方	描述
1	提供企业ID和企业名称	企微管理员	必须，企业唯一标识信息
2	企微新建应用	企微管理员	必须，承载COP应用
3	获取AgentId	企微管理员	必须，企微应用唯一标识
4	获取应用Secret	企微管理员	必须，
5	配置Nacos	致远	非必须，企微分为自建模式和待开发模式，本场景主要针对自建模式。如果三方系统企微认证域名和企业工商认证一致则为自建模式。否则为待开发模式
6	移动插件-启用全局配置	致远	必须，启用微协同，配置租户服务器地址信息
7	移动插件-新建插件	致远	必须，承载COP与企微的关联关系
8	配置组织同步	致远	非必须，配置后COP组织人员数据会直接覆盖企微部门人员数据，请谨慎操作
9	后台配置用户映射	致远	非必须，如果COP与企微手机号一致，或者用户自助绑定解绑，则无需配置。否则需要配置，建立COP与企微人员映射
10	获取待发布地址	致远	必须，COP生成企微应用首页
11	企微配置首页访问地址	致远	必须，企微应用首页为COP提供
12	企微配置信任域名	企微管理员	必须，企微安全要求
13	可信IP配置	企微管理员	必须，企微安全要求
14	申请域名校验	企微管理员	必须，企微安全要求
15	手机端企微工作台查看应用	用户	应用发布成功后，员工可以在在企微客户端-个人工作台查看COP应用
16	移动端自助绑定账号	用户	当COP手机号码与企微手机号码不一致时，需要用户自助绑定COP账号
17	事项接受	用户	进入微协同待办菜单，可以查看COP当前用户的所有待办事项
18	消息接受	用户	COP消息将以应用消息的形式推送给用户
19	移动端自助解绑	用户	用户更换账号时，需要手动解绑，重新绑定COP账号

4、集成配置步骤

4.1、获取企业ID

入口：企微后台管理页面-我的企业

4.2、企微新建应用

注意：新建应用后，需要获取一下三个字段:CorpID、AgentID、AgentSecret；

选择自建应用模式时执行此步骤

4.3、获取AgentId

4.4、获取应用Secret

注意：点击查看后，需要应用管理员登录企业微信，在通知消息中查看

4.5、配置Nacos

capability:
  workWx:
    accessMode: SELF_BUILT

4.6、移动插件-启用全局配置

入口：后台管理-移动管理-移动插件

移动插件默认“不启用”，通过开启【启用微协同】开关，可启用微协同。

协同服务器地址为当前租户环境的协同服务器地址。

开启接收通知、开启连接，并勾选许可协议、风险提示。

4.7、移动插件-新建插件

注意：致远COP平台与企业微信集成中，分为自建模式和待开发模式，本次解决方案采用自建模式

4.8、配置组织同步（可选）

注意：此模式下，企业微信部门、账号数据有V8OA门户自动同步，当V8OA门户部门、账号数据变更时，企业微信部门、账号数据同步变更；

4.9、后台配置用户映射（非必须）

注意：当V8OA门户和企业微信中的组织数据不是来源于同一个组织主数据系统，且相互间没有数据同步时，需要V8机构管理员在移动插件-企业微信-用户映射标签中选择映射类型（手机号码、个人邮箱、企业邮箱、用户名、用户Id、用户编码）；

系统会根据所选映射类型与企业微信账号之间建立联系；

针对无法通过映射类型建立账号关系的特殊账号，平台支持手工配置映射；

4.10、获取待发布地址

4.11、企微配置首页访问地址

4.12、企微配置信任域名

4.13、可信IP配置【重重重】

4.14、申请域名校验

4.15、手机端企微工作台查看应用

4.16、移动端自助绑定账号

注意：除上一步骤中需要后台配置映射关系场景外，平台支持用户在登录企业微信-微协同时，自助登录绑定映射关系；

4.17、事项接受

注意：登录微协同查看待办列表，点击任一列表可免登陆打开待办详情页；

4.18、消息接受

注意：借用企业微信应用消息通知模式，接受统一消息通知；

4.19、移动端自助解绑

5、注意事项

5.1、免登

如果COP手机号码与企微手机号码一致，则无需配置用户映射即可实现企微用户免登打开COP应用。

5.2、集成收费：

企微端要求按照服务商收取接口调用年费，大概没人每年3元；

5.3、IP受限：

需要在企微管理后台-应用管理，增加企业可信IP，且所有出口IP，都需要加上

5.4、消息接受域名配置

5.5、微协同可以登录，但是无法收到消息

大概率是2.12企微配置信任域名未配置，或者2.13可信IP配置未配置所有IP段

5.6、企微备案

由于企微升级，需要提供客户名称、企业ID（CorpID）、脱敏合同，申请备案，否则企微会不定期拒绝微协同访问；

5.7、兼容企微私有化

由于企微支持私有化部署，部署后服务地址信息回变更为本地地址，需要修改Nacos配置，

cip-connector微服务下Nacos配置，其中privatization为企微私有化标识，https://qyapi.weixin.qq.com为企微服务接口地址

seeyon.mobile.qywxFlag=privatization
seeyon.mobile.qywxUrl=https://qyapi.weixin.qq.com

2 - 钉钉

1、概述

平台提供可挂载到钉钉的移动办公应用（微协同），可实现待办事项查看处理、已办事项查看、事项详情页展示、个人工作台、通讯录、自助绑定/解绑、免登进入UDC定制应用等功能。

2、场景支持

场景	场景说明
应用上架/发布	支持COP平台以”微协同“应用挂载到钉钉上，包含事项中心、通讯录、个人工作台、个人信息等部分，其中个人工作台可以免登进入COP平台子应用中。支持UDC定制应用单独挂载到钉钉应用中心。
免登	应用发布成功后，支持钉钉客户端免登陆进入COP应用移动首页中。COP平台与钉钉用户手机号码必须一致
组织同步	支持COP组织人员数据同步至钉钉通讯录中
事项同步	“微协同”发布至钉钉后，用户可以在钉钉查看、处理待办事项
消息同步	COP消息中心的消息将会同步展示在钉钉应用消息中

3、操作步骤

序号	步骤名称	责任方	描述
1	查看企业名称	钉钉管理员	必须，进入管理后台首页，获取企业名称
2	查看CorpId	钉钉管理员	必须，进入钉钉开放平台，查看CorpId
3	新建应用	钉钉管理员	必须，钉钉要新建应用，承载COP应用H5页面
4	获取应用APPKey、AppSecret、agentId	钉钉管理员	必须，COP与钉钉应用依靠这几个参数建立联系
5	接口授权	钉钉管理员	必须，未授权时，无法完成组织同步、免登、消息推送
6	新建移动插件	致远	必须，承载COP与钉钉的关联关系及场景配置
7	启用配置	致远	必须，启用后微协同才可以正常使用
8	新建钉钉移动插件	致远	必须，承载COP与钉钉的关联关系及场景配置
9	组织同步	致远	非必须，COP与钉钉间组织同步
10	用户映射	致远	非必须，钉钉需要接受COP消息时启用
11	应用发布/上架	致远	必须，发布后生成H5URL地址，才可以挂载到钉钉上
12	钉钉应用发布	钉钉管理员	必须，钉钉需要发布后，应用才可以正常使用
13	钉钉客户端进入应用	用户	必须，
14	消息查看	用户	非必须，

4、集成配置步骤

4.1、查看企业名称

4.2、查看CorpId

4.3、新建应用

4.4、获取应用APPKey、AppSecret、agentId

4.5、接口授权

4.6、新建移动插件

4.7、启用配置

4.8、新建钉钉移动插件

4.9、组织同步

4.10、用户映射

4.11、应用发布/上架

4.12、钉钉应用发布

4.13、钉钉客户端进入应用

4.14、钉钉客户端接受消息

5、注意事项

钉钉开放平台：[https://open-dev.dingtalk.com/#/]()

钉钉管理后台：[https://oa.dingtalk.com/index.htm#/welcome]()

应用首页地址必须是相对地址：

3 - 飞书

1、概述

平台提供可挂载到飞书的移动办公应用（微协同），可实现待办事项查看处理、已办事项查看、事项详情页展示、个人工作台、通讯录、自助绑定/解绑、免登进入UDC定制应用等功能。

2、场景支持

场景	场景说明
应用上架/发布	支持COP平台以”微协同“应用挂载到飞书上，包含事项中心、通讯录、个人工作台、个人信息等部分，其中个人工作台可以免登进入COP平台子应用中。支持UDC定制应用单独挂载到飞书应用中心。
免登	应用发布成功后，支持飞书客户端免登陆进入COP应用移动首页中。COP平台与飞书用户手机号码必须一致
组织同步	支持COP组织人员数据同步至飞书通讯录中
事项同步	“微协同”发布至飞书后，用户可以在飞书查看、处理待办事项
消息同步	COP消息中心的消息将会同步展示在飞书应用消息中

3、操作步骤

序号	步骤名称	责任方	描述
1	查看企业名称	飞书管理员	必须，进入管理后台首页，获取企业名称
2	查看企业编号	飞书管理员	必须，进入飞书开放平台，查看企业编号
3	新建应用	飞书管理员	必须，飞书要新建应用，承载COP应用H5页面
4	获取应用APPKey、AppSecret	飞书管理员	必须，COP与飞书应用依靠这几个参数建立联系
5	接口授权	飞书管理员	必须，未授权时，无法完成组织同步、免登、消息推送
6	新建移动插件	致远	必须，承载COP与飞书的关联关系及场景配置
7	启用配置	致远	必须，启用后微协同才可以正常使用
8	新建飞书移动插件	致远	必须，承载COP与飞书的关联关系及场景配置
9	组织同步	致远	非必须，COP与飞书间组织同步
10	用户映射	致远	非必须，飞书需要接受COP消息时启用
11	应用发布/上架	致远	必须，发布后生成H5URL地址，才可以挂载到飞书上
12	飞书应用发布	飞书管理员	必须，飞书需要发布后，应用才可以正常使用
13	飞书客户端进入应用	用户	必须，
14	消息查看	用户	非必须，