概述

EBAOZU V4 支持对接企业微信（Work WeChat），实现将系统内的客服、员工与组织架构与企业微信通讯录进行双向同步，并支持通过企业微信接收业务提醒。

---

常见问题与排查指南

通讯录无法同步成员数据

• 根本原因：根据企业微信官方最新接口规范，通讯录读取权限已由早期的通讯录管理应用变更为必须通过 自建应用 授权获取。
• 解决步骤：
  1. 登录 企业微信管理后台 -> 【应用管理】 -> 【自建】 -> 创建一个自建应用（如“承信租助手”）。
  2. 在该自建应用的详情页中，找到【企业可信IP】配置，将部署 EBAOZU 系统的服务器公网 IP 添加到可信 IP 列表中。
  3. 将自建应用的 AgentId 与 Secret 填写到 EBAOZU 后台【企业微信配置】中并保存。
  4. 为该应用设置可见范围（勾选需要同步的部门或全体成员）。

---

提示 ip is not in whitelist 或同步接口报错

• 排查：在企业微信后台自建应用的“企业可信IP”中，检查是否配置了当前服务器正确的出口公网 IP（若服务器使用了多出口 IP 或 NAT 网关，需全部配置）。
• 日志排查：查看 runtime/log/ 错误日志，搜索 workWechat 或 contact 查看企业微信接口返回的具体错误码。

---

修改部门名称后系统后台未自动更新

• 说明：企业微信的事件回调机制中，仅对“部门层级移动、成员增删、上级架构变动”等核心事件推送回调。若仅单纯重命名部门名称，微信不一定触发全局回调。
• 解决：在 EBAOZU 后台【员工/部门管理】中点击 【手动全量同步】 即可拉取最新的组织架构名称。