企业微信对接指南2——自助对接方式
本文仅作为私有部署用户的对接指南，SaaS用户对接请参考代开发对接指南
本文主要分为两部分：
-
第一部分：HAP如何对接到企业微信
-
第二部分：HAP单个应用如何对接到企业微信
第一部分：HAP平台如何对接企业微信
1、企业微信管理员登录企业微信的管理后台
2、在自建分类下，点击【创建应用】
3、HAP系统的管理员进入组织后台，打开对接信息页面
企业微信、钉钉、飞书只能选择一个平台对接，如果已经对接了一个，另外两个就不再显示了。如何关闭对接
4、在对接信息页面，分别获取到 Logo ，应用主页地址，可信域名
5、返回企业微信后台中，自建应用页面
设置好LOGO、名称、可见范围，点击创建应用
6、配置主页、可信域名和企业可信IP等信息
将第4步获取的HAP的应用主页和可信域名复制后，粘贴写入对应的配置项中
-
配置应用主页
-
配置可信域名
-
配置企业可信IP
将贵司服务器的出口IP写入即可
如果企业微信是私有部署，需要进一步添加应用可读取字段
添加路径："安 全配置"> "应用可读取字段" ，其中账号和姓名务必勾选，为了信息的完整性其他字段建议全部勾选，选择后点击保存即可。
7、将企业微信中刚才建立的“HAP应用” 的信息写入到HAP系统中
返回HAP的组织后台 》 企业微信集成 》 对接信息录入
如何获取 CorpId（企业ID）、AgentId、Secret 这三个信息？
信息保存时报错？
-
在复制粘贴信息时，不要有空格，不然保存时会报错。
-
应用的Secret 和 AgentId 要确保是同一个自建应用，不然保存时会报错。
8、设定需要同步的人员范围
贵司使用企业微信的人员是100人，但是使用HAP的人数可能是50人，因此并非同步所有的账号。我们可以根据部门和指定人员来确认好同步的人员范围， 设定范围如下图：
选择人员的范围可以是部门、成员和标签， 如果选择了成员和标签，那么不会同步部门信息。
9、同步通讯录
企业微信账号要一键登录HAP，那么在HAP也必须要有一个关联绑定的组织账户，对接完成前最后一步就是同步账户数据，将企业微信账户和HAP组织账户绑定起来。
由于企业微信的通讯录限制，服务商（HAP）在获取企业微信账户时，不能获取到手机号和邮箱地址，因此在同步时不能准确的匹配两个平台间的账户，只能通过相同姓名默认关联，再由操作人员决定是否关联正确，如果不正确可以手动关联。
同步
组织超级管理员进入 组织管理后台 > 企业微信 ，点击【同步】按钮
1)绑定关系
在下方表格区，将企业微信账户绑定到HAP组织账户
-
左侧是HAP的组织账号（还未绑定企业微信），在右侧选择要绑定的企业微信账户
-
系统会根据姓名自动匹配相同姓名的账户（有姓名匹配标签），如果不对，可以移除重新绑定
2)同步内容概览
选择完成账号绑定关系后，在上方会有本次同步的信息汇总
-
新增组织用户数
如果获取到的企业微信账户未绑定到组织账户，同步时将会自动创建新的HAP账户并与之自动绑定。如下图，右侧詹善福（企业微信账户）还未选择绑定，那么确定同步时会自动创建新账号。
-
匹配到已有组织用户数
本次同步将要绑定组织账户的企业微信账户数量。下方的解绑和绑定都会改变此值。
-
同步企业微信用户数
是在本次同步前已经绑定过组织账户的企业微信账户数量。 再次点击同步仅同步信息。如果历史没有绑定过，则不显示此项。
3)确认同步
确认绑定关系后，点击同步按钮即可。
如果本次同步还有企业微信账户没有被绑定到组织账户，则会有以下提示，让您再次确认，如果无误，点击【确认】按钮即可。
4)管理已绑定关系
-
可以查看目前已经绑定的账户
-
可以取消现有绑定，被取消的企业账户将不能再登录HAP，再次点击同步时，可以重新绑定。
10、通过企业微信进入HAP
同步完成后，就可以进入企业微信工作台 ，点击HAP图标，可免登陆直接进入系统。
11、企业微信中如何删除HAP应用
企业微信管理员登录网页端管理后台 》 应用管理 》进入HAP，进行删除。
第二部分：HAP单个应用如何对接到企业微信
前置条件： 已完成第一部分平台之间的对接。
1、入口
应用管理员进入应用管理-发布-发布到企业微信，打开此应用的安装指南页面，依照指南完成安装。
2、效果演示
