I8-微信集成操作手册

新中大股份有限公司I8微信集成操作手册 版本 1.0修订历史记录编号章节修订说明项目当前版本号修订日期修订前版本号修订后版本号修改人审批人1初始创建1.0234目录第一章企业微信设置6企业微信注册、登录6获取系统配置企业微信所需参数8i.获取微信企业号id8ii.注册应用9iii.获取应用ID和应用秘钥9iv.获取通讯录密钥11二、 设置企业应用功能点链接12v.设置可信域名12vi.设置应用功能点链接13第二章企业微信注册16前置检查项目16i.合法验证16ii.NetcallServer/APPServer16iii.企业微信16iv.人员信息17企业微信注册18应用设置19第三章组织机构同步21前置检查项21微信部门编码设置21i.数据范围21ii.编码设置21iii.批量设置部门编码22新增组织信息24第四章人员信息同步25前置检查项25企业微信中已有人员数据25i.同步企业微信25ii.新增人员26企业微信中无人员数据27iii.员工微信号维护27人员异动27第五章微信使用授权27注意该操作手册所有操作基于截稿时腾讯所有的企业微信的相关界面及操作。若读者在操作时发现因腾讯调整导致实际界面或操作与操作手册中的界面或操作有出入，以实际界面或操作为准。第一章 企业微信设置企业微信注册、登录企业微信可登录网页进行注册，网址为： ，点击企业注册，填写公司相关信息进行注册即可。如下图所示注册成功后，即可登录企业微信管理后台，网址为：/wework_admin/loginpage_wx?from=myhome 用管理员微信进行扫码登录，如下图所示： 进入企业微信，连接微信-微工作台-邀请关注，可扫二维码进行进行关注（注:需人员同步后才可显示，具体人员同步请参考第四章）获取系统配置企业微信所需参数i. 获取微信企业号id点击“我的企业”“CorpID”即微信企业idii. 注册应用进入应用主页主页后，点击“企业应用”“添加应用”输入应用名、介绍、应用图标、应用可见范围（需选择根部门）iii. 获取应用ID和应用秘钥注册应用完成后进入应用主页获取应用ID和密钥，“Agentid”即应用ID，“Secret”即应用密钥iv. 获取通讯录密钥点击“管理工具”“通讯录同步”“Secret”即通讯录密钥 （注：通讯录同步，权限需选择：API编辑通讯录，人员才可以同步企业微信，否则人员同步时报错。）2、 设置企业应用功能点链接v. 设置可信域名进入新创建的企业应用主页，点击“设置可信域名”可信域名固定设置为“call.cc”，同时需将文件下载下来发给新中大相关人员上传至云端。vi. 设置应用功能点链接以添加“移动审批”功能为例,点击“自定义菜单”“设置”点击“添加主菜单” “菜单内容”选择“跳转到网页”，名字设为“移动审批”填写应用网址后保存即可。微信应用的所有网址均为如下格式：“call.cc/EnterpriseInfoService/wechat/pages/index.html?NGCorpId=新中大企业号&requestType=模块英文名&agentId=新中大应用ID&appId=企业微信号ID”网址中加粗部分需根据模块英文名、新中大企业号、企业微信ID及新中大应用ID自行修改。以移动审批为例，模块英文名为MEA，替换后即可得到最终网址（手动替换字符以加粗带下划线标识）：call.cc/EnterpriseInfoService/wechat/pages/index.html?NGCorpId=710542&requestType=MEA&agentId=1000004&appId=wwc2da07007a22e7b0微信应用模块信息：市场分类模块中文名模块英文名免费模块基础应用移动消息自由呼MMP是移动新闻公告MNA是营改增移动采购比价器MPC是移动内部税局MIT否移动办公移动审批MEA否移动报表MR否移动借款报销MBR否移动请假MLA否移动签到MC否项目管理移动项目看板MPB否移动资金看板MPF否移动现场管理MSM否(注：在12.5P3中，我们做了多应用的需求，便于设置URL，详见第二章）第二章 企业微信注册1前置检查项目i. 合法验证若您已购买微信模块，在企业管理平台的合法验证的正版模块中会有显示。ii. NetcallServer/APPServer因为微信应用是基于APP扩展的，因此在i8中注册企业微信之前必须先正确部署NetcallServer以及APPServer。请确保UC基础设置中已正确填写NetcallServer/APPServer服务端地址并勾选启用netcall以及启用APP按钮。iii. 企业微信请参照第一章内容完成企业微信注册，并已获取企业ID、应用ID、通讯录密钥、新中大应用管理组密钥。若您在UC基础设置中已完成注册后在企业微信中对密钥点击了“重新获取”按钮，则需按照新获取到的密钥在UC基础设置中重新注册。iv. 人员信息如企业微信中已存在人员数据，请务必在企业微信中维护好人员的手机号（手机号要与使用人员的微信对应的手机号保持一致），否则可能导致后期人员同步失败。若您已在UC基础平台完成企业微信注册后发现企业微信中人员信息未维护完整，请在维护完整后重新在UC基础设置中进行注册。企业微信注册企业微信注册功能位于：“柔性统一平台”-“统一通讯(UC)平台”-“基础设置”。将获取到的微信企业号ID、通讯录密钥填入相应位置，并选择微信管理员（只能选择已维护手机号字段的员工，便于接受通知消息），填写完成后点击“测试”按钮测试数据正确性，连接成功则会提示：微信企业号连接成功，测试通过后保存即可。应用设置在第一章我们提到设置企业应用，在微信应用设置中把相应的应用ID（AgentId）,应用密钥（Secret），维护到相对应的功能中，如图所示：“柔性统一平台”-“统一通讯(UC)平台”-“基础设置”- “企业微信设置” 选择应用设置 （注：使用多应用设置后，就不用我们一个一个手工录入URL，点击保存并同步后，在企业微信-企业应用中的工作台应用主页，自定义菜单直接对应存入URL，一个功能对应一个应用，系统升级时需先在应用设置中重新设置，不然不能接收到推送消息）第三章 组织机构同步2前置检查项检查是否已完成企业微信注册，功能位于：“柔性统一平台”-“统一通讯(UC)平台”-“基础设置”。微信部门编码设置i. 数据范围在组织设置中，增加了微信部门编码和同步微信字段，只有维护了微信部门编码并勾选同步微信的部门信息才会被同步至企业微信。同步部门时，系统按照人力资源关系树自上而下进行同步，因此需同步的部门除了本身要维护微信部门编码并勾选同步微信之外，他的所有上级部门也需要维护微信部门编码并勾选同步微信。ii. 编码设置因为微信部门编码只支持数值型，因此部门编码无法使用i8本身的部门编码体系。如需将组织机构同步至惬意微信，则需要按照微信的规则设置微信部门编码。如果组织机构需同步至企业微信，则需要进行组织信息修改，修改时必须勾选同步微信按钮，勾选后系统会自动生成微信部门编码。若该组织机构在企业微信的通讯录中已存在，则您必须自行修改微信部门编码，与企业微信的通讯录中的部门编码相同，否则在企业微信的通讯录中会产生重复数据。所有部门的微信部门编码字段维护完成后，需重新保存人力资源关系树，在保存人力资源关系树时，系统会自动进行企业微信通讯录同步。iii. 批量设置部门编码鉴于大部分企业的人力资源关系树已维护完成，系统提供了批量设置功能。组织关系同步方式有两种：人力组织直接同步微信、微信与人力组织对应同步1） 人力组织直接同步微信“柔性统一平台”-“统一通讯(UC)平台”-“基础设置”- “企业微信设置”，选择人力组织直接同步微信。使用超级管理员登录系统，在组织设置中使用“人力组织同步微信”功能即可对微信部门编码进行批量设置。微信部门编码设置界面如下：1、若您在企业微信中已维护部门信息，则可以点击“从微信平台导出部门信息”，系统会将企业微信中的部门信息导出成EXCEL表格，根据导出的EXCEL表格填写相应部门的微信部门编码字段即可，表格中的ID列即是企业微信中的部门编码。微信部门编码填写完成后，勾选已填写微信部门编码字段的部门信息，点击“保存并同步勾选部门至微信”即可完成i8部门信息与企业微信通讯录部门信息的关联关系的创建。2、 若您在企业微信中尚未维护部门信息，则可以勾选需要同步的部门，然后点击“生成微信部门编码”按钮自动生成编码信息，最后点击“保存并同步勾选部门至微信”即可完成企业微信通讯录部门信息的建立并建立双方的对应关系。2） 微信与人力组织对应同步“柔性统一平台”-“统一通讯(UC)平台”-“基础设置”- “企业微信设置”，选择微信与人力组织对应同步。使用超级管理员登录系统，在组织设置中使用“微信部门编码设置”功能即可对微信部门编码进行批量设置。可先将企业微信部门ID导出来再一一对应。新增组织信息新增组织时，如果该组织机构需同步至企业微信，则必须勾选同步微信按钮，勾选后系统会自动生成微信部门编码。在将该组织添加至人力资源关系树并进行保存操作时，系统会自动进行企业微信通讯录同步。第四章 人员信息同步前置检查项1、检查是否已完成企业微信注册，功能位于：“柔性统一平台”“统一通讯(UC)平台”“基础设置”。2、检查组织机构信息是否已完成同步，i8组织信息中的微信部门编码必须与企业微信中的部门编码相同。企业微信中已有人员数据i. 同步企业微信同步企业微信功能是根据员工的手机号码与企业微信的通讯录进行匹配，因此只能针对员工/业务员数据进行同步，以下几种情况将无法进行数据同步：1、联系信息的本页数据中无人员类型为员工或业务员的数据。2、员工手机号码未填写。3、员工与操作员未对应或存在同一员工对应了多个操作员的关系。4、企业微信/i8通讯录中人员的手机号不一致。若i8中手机号码错误，则应修改i8中员工手机号后再同步。若企业微信中号码错误，则可以通过以下两种方式解决：（1）在企业微信中删除手机号码不一样的人员信息，在i8中维护好正确的手机号后同步至企业微信；（2）在企业微信中将人员手机号码维护正确，在UC基础设置中重新注册后再同步。注：手机号码必须与微信号绑定后方可使用企业微信，系统中维护的手机号码也必须是此手机号码，微信号对应的手机号码可以在微信设置帐号与安全中查看。 ii. 新增人员将前期在企业微信中已维护的人员信息与i8中的人员信息完成关联后，后期新增的人员即可在i8中进行维护，系统会自动同步至企业微信的通讯录中。在人员新增及批量新增界面同步微信的勾选项，填写手机号码并勾选同步微信后，系统在i8中创建人员后，会自动将该人员信息同步至企业微信的通讯录中（注：请确保该人员所在部门及上级部门已完成i8部门信息与企业微信部门的关联关系创建）。企业微信中无人员数据iii. 员工微信号维护若您的企业微信中无人员信息，则对于i8中现有的员工信息，必须手工维护员工手机号。手机号码维护完成后，在员工信息的系统信息tab页中勾选同步企业微信按钮，保存后即可将该人员信息同步至企业微信的通讯录中。注：若员工手机号码已全部维护完成，您也可以参照4.2.1同步企业微信节点进行批量操作（无需在员工信息中勾选同步企业微信）。新建员工请参照4.2.2新增人员进行操作。人员异动若您启用了企业微信，在员工任职异动审批通过执行时，系统会自动同步企业微信的通讯录，将该员工的部门信息进行更新。注：考虑到直接删除企业微信中的人员数据可能会影响其他应用，因此离职异动执行时并不会自动删除企业微信中的人员信息，如需删除人员请登录企业微信管理平台自行删除。第五章 微信使用授权微信应用授权集成在移动APP服务端授权系统中实现。微信应用分为免费模块和收费模块两种，打开收费模块时会进行模块授权状态判断，可能会出现以下几