Skip to main content

企业微信对接指南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、安装过程关键步骤演示

  • 点击“网页授权及JS-SDK”,填入可信域名。

  • 填写工作台应用主页

    注意: 主页地址是三个字符串拼接,中间不能有空格,具体操作如附图

3、效果演示


文档问题反馈

文档中是否有错别字、内容过期、难以理解等问题? 点此给我们反馈吧