企业微信

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