一、创建应用
若已有稳定可用的已发布应用,此处也可不新建,直接单击需选用的应用进入详情页进行操作即可,为确保应用稳定可用,此处建议新建应用(以下操作需要登录企业微信管理平台,请先确保已经注册企业微信管理员账号,企业微信管理员账号注册流程请参见企业微信页面,此处不再赘述)。
1. 登录企业微信管理平台。(若链接无法直达,可如下操作,通过进入企业微信页面,单击右上角企业登录进入后台管理登录页)。
2. 登录成功后,单击应用管理按钮,进入应用管理页面。
3. 如图找到“自建”区域,单击创建应用按钮,进入“创建应用”页面。
4. 填写“应用 Logo”、“应用名称”、“应用描述” 并选择 “可见范围”。
注意:说明:
注意:“可见范围”决定从企微同步到企业控制台的数据范围,请根据业务需要进行数据范围选择。后期根据业务变化也可以再次修改。
5. 创建成功后,进入应用详情页面并提示“应用创建成功,可继续配置应用属性”,此时我们所需应用已经创建成功。
二、查询企业微信凭证信息
企业微信凭证信息主要包含:企业 ID、AgentId、Secret 三个信息,主要用于后面企业控制台侧企业微信数据源配置使用。
1. 在“企业微信管理后台 > 应用管理 > 自建”区域找到上一步骤新创建应用,单击应用,进入应用详情页面。查看 AgentId 和 Secret。(注意:Secret 需要单击查看后,使用管理员账号在移动端企业微信 App 中进行确认,确认通过后,会将 Secret 发送到企业微信 App 上)
2. 进入“企业微信管理后台 > 我的企业”页面,在我的企业页面查看“企业 ID”信息。
三、配置可信域名及可信 IP
配置须知: 根据企业微信开发管理规则,自建应用获取企业内部数据前,必须完成可信域名与可信 IP 的配置。若省略此步,将导致接口调用失败。
操作准备:
·域名: 提前准备已备案的企业可信域名。
·IP 信息: 部署企业控制台 Agent 的服务器 IP,需要可对外访问公网 IP。
以下为你详细说明配置步骤。
1. 在“企业微信管理后台 > 应用管理 > 自建”区域找到上一步骤新创建应用,找到开发者接口区域,单击设置可信域名,进入可信域名配置页面。
2. 在“可信域名”处填写公司页面可信的域名信息,单击确定。
注意:填写时,企业微信方会校验域名的真实性以及所有权。
3. 域名配置成功后,返回应用详情页面,在应用详情页面下方,找到开发者接口区域 > 企业可信 IP,单击配置,进入可信 IP 配置页面。
4. 在“企业可信 IP”地址框中,填写部署企业控制台 Agent 的服务器 IP。
注意:如果是集群配置可配置多个,中间用英文;隔开。
四、范围及权限管理
企业微信创建应用时会对应用所能访问的数据(包括:用户数据和组织机构数据)进行权限控制,此步骤描述如何控制同步至企业控制台的数据范围。
1. 在应用详情页找到“可见范围”,显示的是当前应用可以访问数据的范围,也就是可以同步到企业控制台的数据。单击编辑进入编辑页面。
2. 进入可见范围编辑页面,可对当前范围进行删除、添加等操作,单击添加按钮,进入添加页面。
3. 可见范围控制支持三种:“根据部门”、“根据成员”、“根据标签”,三种方式可以同时使用,也可以只使用其中一种或两种,具体可根据业务需要进行选择,选择完成单击确认。
4. 回到可见范围编辑页面,单击完成,完成权限变更操作。
五、数据源选择&应用凭证绑定
1. 在 企业控制台 > 组织与成员 > 数据源管理中,单击添加数据源。跳转数据源选择页面选择企业微信数据源。
2. 进入企业微信配置中,选择 Agent 并填写在其中获得的企业微信应用“AgentId”、“Secret”和“企业 ID” 。
3. 若已经完成企微数据源配置,并且企微数据源和企微数据源使用的是同一台企微服务器时,系统会自动获取你在数据源配置的企微信息,你可以单击选择企微数据源选项,自动拉取企微配置信息。
4. 数据源功能详情配置 需注意,此处企业控制台暂不支持设置部门或人员范围,若同步过程有指定范围的要求,可在第一步创建企业微信应用时在“可见范围”中进行数据权限设置
5. 字段映射配置
有关字段映射的更多问题可查看字段映射说明文档
·部门映射字段对应关系固定,不可修改;
·人员字段对应关系中,用户 id、用户登录名、用户姓名字段对应关系固定,不可修改。其他字段可自行添加对应关系。
注意:受企业微信个人隐私保护规则影响,企业微信部分数据不可直接获取。具体可获取字段明细请参考字段映射说明文档“企业微信获取数据说明”章节。
6. 配置定时同步
定时器可以让同步任务定时触发,以保证企微中的组织架构的变更能周期性地同步到腾讯统一身份中, 定时器可以设置触发时间和触发间隔。
7. 删除保护配置 此处为了防止你误删除操作,我们设置了删除保护条件,系统执行同步任务之前将识别本次操作是否会触发保护条件,若满足保护条件,则本次同步任务将不会进行,我们会给你留下的联系方式发送通知,删除保护条件可支持修改(为了避免误删除操作带来的影响,若非频繁触发导致日常同步难以进行,不建议修改保护条件)。
注意:触发删除保护时,仅会自动停止你的删除操作请求,如果同一次同步中同时发起了新建、修改请求,新增、修改等请求会继续执行,不会受到影响。
8. 保存页面配置 单击保存配置按钮,对页面全局改动进行保存,即完成了整体企业微信数据源配置流程。
六、步骤3:启动同步
为你提供了两种导入/同步的执行方式:手动同步、定时同步。
1. 手动同步
当你配置好企微作为数据源后,你会在“数据源”页面下,看到“手动同步”按钮。
通过单击手动同步按钮,系统会立即执行一次导入/同步任务,手动同步的特点是即点即执行。
2. 定时同步
当你需要经常维护你的目录数据,但希望避免 “每一次维护后都进入腾讯统一身份后台去手动单击进行同步” 这样的繁琐操作时,你可以设置一个定时器来周期性地自动进行目录数据同步。
在第三步的“设置同步策略”模块,你可以打开定时同步开关,在弹出的时间设定选项中,设置定时同步的频率。
例如: 设置每1小时进行一次自动同步,每天的同步从零点开始,可以做如下设置:
七、步骤4:查看同步日志
在同步运行完毕后,可进入账号同步的页面查看同步日志,展示了在什么时间,以手动或者自动的方式进行了同步,并且可以查看同步的成功数据和失败数据。
单击具体某条同步日志,可以查看具体同步详情。
进入日志详情页面,可查看同步数据具体详情信息。
八、其他:数据源更换(非必要不建议更换)
1. 单击“数据源更换”按钮,二次确认更换后可更换数据源类型(此处若只需要更换应用凭证而非更换数据源类型,可直接编辑数据源并更新凭证);
2. 需注意,更换数据源操作后,原有数据源的所有配置和同步记录将清空,已同步至企业控制台侧的人员会保留。
九、Q1:字段映射测试功能必须要开通额外权限吗?
额外权限开通场景为:需要通过手机号搜索真实人员做映射实例时才需要开通,若直接用默认实例查看映射关系或通过 userid 搜索真实人员的情况,则不需要开通额外权限。
十、Q2:需要开通些什么额外权限?
权限开通操作流程请参考这篇档中第一步-第3点“范围及权限管理”模块相关描述。
十一、Q3:如何在企业微信侧获取 user_id?
登录企业微信管理平台,进入“通讯录-成员管理”模块,查看成员列表,选定需要查看的成员,在弹出的人员信息浮层顶部,员工名称后括号内容中存在员工 UserID 字段,即为该员工的 user_id。
十二、Q4:映射结果中预览处提示字段缺失怎么办?
此处的“字段”指的是你在字段映射模块设置的映射关系中企微侧选择的字段,“缺失”指的是在脚本编辑框中未找到对应的被选字段。若此处测试时你选择的搜索真实人员数据做映射,则出现该报错的原因可能是因为企业微信侧应用创建时未开通对应字段的权限,请检查权限。