默认读本地库（回调与增删改会自动更新）。首次使用或需与企微对齐时点「从企微刷新」；头像/手机/邮箱亦可点「从回调补全」或 OAuth 授权写入缓存。业务平台查询见 通讯录 API 文档。
← 请先在左侧选择部门
| UserID | 姓名 | 手机 | 邮箱 | 职务 | 状态 | 操作 |
|---|---|---|---|---|---|---|
| 选择部门后加载员工 | ||||||
连接与同步配置 加载中…
通讯录同步 Secret
企微 管理工具 → 通讯录同步 开启「API 接口同步」并勾选编辑通讯录，粘贴 Secret 用于成员/部门写入。
服务器出口 IP 须加入企业可信 IP。读取组织架构走自建应用 WECOM_CORP_SECRET。
接收事件服务器（通讯录回调）
企微 管理工具 → 通讯录同步 → 设置接收事件服务器 填写 URL、Token、EncodingAESKey（与下方保存值一致）。
接收 change_contact 成员/部门变更事件。
回调 URL：—
成员敏感信息（头像 / 手机 / 邮箱）
2022 年后新建的自建应用，user/list 与 user/get 默认不返回头像、手机、邮箱。
请在企微 应用管理 → 自建应用 → 开发者接口 中勾选需读取的敏感字段（管理员授权）。
本页会逐人调用 user/get 并合并本地缓存；若仍为空，请在企微后台确认该成员确有填写且应用可见范围覆盖其部门。
成员可修改字段
在企微管理后台 我的企业 → 通讯录管理 → 成员可修改字段 配置员工可自行修改的资料。 取消勾选「姓名」可禁止员工在手机端自行改名；勾选「头像」则允许员工自行换头像（不影响本页通过 API 修改）。
通讯录回调事件日志
| 时间 | Event | ChangeType | 成员/ID | 状态 | |
|---|---|---|---|---|---|
| 展开后加载… | |||||