通讯录同步助手
数据概览
查看双方通讯录快照数量、同步概况与计划任务
同步概况
快照与计划任务
同步管理
从 CDHR 向企业微信同步部门与成员，全程预演与审批保护
部门同步
按CDHR组织架构同步部门；可核对的部门主管变更会进入预演和审批
测试数据（联调时手动输入，可选）
成员同步
按规则匹配并更新成员；成员归属完成后核对部门主管
测试数据（联调时手动输入，可选）
全量同步
先按CDHR树状新建部门，再按姓名调整现有成员部门
增量同步
按日期增量同步；留空时从北京时间前一日或上次成功同步日开始补齐
操作日志
通讯录对比
拉取 CDHR 与企业微信两侧快照，核对差异并按策略安全应用
拉取数据
从 CDHR 与企业微信分别拉取当前组织与人员快照，作为对比的基准。执行对比前必须同时准备双方数据。
测试数据（联调时手动输入，可选）
执行对比
映射管理
分别维护 CDHR 工号、代开发 UserID、企业微信原始 UserID 与部门的绑定关系
| CDHR部门ID | CDHR部门名称 | 企业微信部门ID | 企业微信部门名称 | 状态 | 操作 |
|---|---|---|---|---|---|
| 加载中... | |||||
根据最近一次企业微信部门快照检查未关联、冲突和失效映射。根部门不参与检查；同名部门仍需核对层级。请先在“数据对比”中拉取最新快照。
| 企业微信部门 | 部门 ID | 上级部门 ID | 关联的 CDHR 部门 | 问题 |
|---|---|---|---|---|
| 加载中... | ||||
CDHR 人员 ID（EMPLOYEE_ID）用于查找部门负责人；CDHR 工号（EMPLOYEE_CODE）用于成员映射。代开发 UserID 用于读取，企业微信原始 UserID 用于写入已有成员。
从企业微信后台导出通讯录后，复制“姓名、账号”两列粘贴。导出的“账号”是写入通讯录所需的企业微信原始 UserID；代开发接口返回的 UserID 仅用于读取和匹配。系统只接受双方姓名唯一且现有映射一致的成员；重名或冲突需人工核对。
| CDHR 人员 ID | CDHR 工号 | 姓名 | CDHR部门 | 代开发 UserID（读取） | 企业微信原始 UserID（写入） | 状态 | 操作 |
|---|---|---|---|---|---|---|---|
| 加载中... | |||||||
根据最近一次企业微信成员快照与当前 CDHR 映射显示未关联、冲突及失效映射。失效映射指 CDHR 已绑定的代开发 UserID 不在最新企业微信快照中。请先在“数据对比”中拉取最新快照。
| 成员姓名 | 代开发 UserID | 企业微信部门 ID | 关联的 CDHR 人员 | 问题 |
|---|---|---|---|---|
| 加载中... | ||||
离职管理
离职成员禁用后在此排队，到期自动删除，可延期或取消
| 工号 | 姓名 | 禁用时间 | 计划删除时间 | 剩余天数 | 状态 | 操作 |
|---|---|---|---|---|---|---|
| 加载中... | ||||||
定时任务
停用只影响定时运行，手动触发仍可执行；安全增量是否自动执行取决于设置
定时任务列表
| 任务名称 | Cron表达式 | 同步类型 | 启用状态 | 上次执行 | 上次状态 | 操作 |
|---|---|---|---|---|---|---|
| 加载中... | ||||||
同步日志
每次同步的过程记录、结果统计与补偿报告
同步日志
| ID | 同步类型 | 状态 | 开始时间 | 结束时间 | 总数 | 成功 | 失败 | 跳过 | 详情 |
|---|---|---|---|---|---|---|---|---|---|
| 加载中... | |||||||||
通讯录写入请求
记录发给企业微信的请求参数、返回内容与每次尝试；凭证不写入日志，仅系统管理员可查看。
| 时间 | 来源 | 接口 | 结果 | 尝试 | 详情 |
|---|---|---|---|---|---|
| 加载中... | |||||
系统设置
CDHR 数据源、企业微信授权、安全参数与免登管理员配置
CDHR数据源配置
企业微信代开发授权
指令回调地址：-
免登回调地址：-
应用主页地址请配置为 -（企业微信管理员在企微内打开即自动免登）。
通讯录写入代理
读取使用代开发应用直连，写入使用通讯录 Secret 经代理发送。配置通过主系统环境变量维护，修改后重启生效。
连接测试仅验证代理鉴权及 token 获取，不执行写入，也不代表已验证写入权限。
免登管理员（企业微信内自动登录白名单）
按企业微信通讯录中的成员姓名精确匹配，应用需有该成员的通讯录读取权限。请避免添加重名成员：同名账号都可能获得权限。旧手机号及 UserID 名单不会生效，请按姓名重新添加。
系统参数
开启后，预检通过的普通增量可自动执行；高风险仅放行纯更新（含负责人变更）。高风险混合新增/禁用、删除或严重风险仍需人工确认。
开启并配置 Webhook 后，待审核的定时任务会立即发送提醒。
用于保护重点成员，名单中的成员仍可查看和对比，但不会被系统自动改动。
用于保护重点部门，名单中的部门仍可查看和对比，但不会被系统自动改动。
系统管理员密码由部署环境变量管理，修改后重启服务生效。