# 组织架构与门店

在「组织结构」里用部门树管理成员和岗位，把门店挂载在对应区域下，记下合作方、供应商、渠道的外部联系人，并从企业微信单向同步通讯录。通过企业微信同步的部门和部分人员字段为只读，信息以企业微信为准。

## 谁能用

| 角色 | 「组织架构」 | 「门店」 | 「外部联系人」 | 「通讯录同步」 |
|---|---|---|---|---|
| 组织管理员 | 完整读写，包含「部门类型」配置 | 完整读写 | 完整读写 | 完整读写 |
| 审计员 | 只读查看 | 只读查看 | 只读查看 | 导航栏中不显示 |
| 部门管理员 | 管理所负责部门子树：新建、修改、删除下级部门，邀请成员到本部门，调入管辖范围内的人；不能配置「部门类型」，不能修改业务角色 | 导航栏中不显示（除非同时拥有管理员或审计员权限） | 导航栏中不显示（除非同时拥有管理员或审计员权限）；不能写 | 没有权限 |
| 普通成员 / 分析员 | 提示「没有权限」 | 导航栏中不显示 | 导航栏中不显示 | 没有权限 |

> **部署与权限说明**
>
> - 若部署环境未启用部门模型，打开页面显示标题「组织架构」，页面状态为「不可用」，并提示「这个部署没有启用部门与成员管理。」。
> - 若部署环境未开启协作平台连接，打开「通讯录同步」页面显示状态为「不可用」，并提示「这个部署没有开启协作平台连接。」。
> - 由企业微信同步生成的部门属于只读部门：名称和上级部门为只读，仅可执行「设类型」；不能在页面中新建子部门、不能删除、不能往里「调入成员」，如需调整必须在企业微信后台修改。

## 怎么打开

你可以通过以下几种方式进入相关页面：

1. **打开「组织架构」**：
   - 方式一：在顶部或侧栏导航中进入「我的组织」，点击「组织结构」，选择「组织架构」。
   - 方式二：在「门店」列表中，点击某门店行操作菜单中的「在组织架构中查看」，可直接跳转至该门店对应的组织架构部门。
2. **打开「门店」**：
   - 在侧栏导航中点击「门店」。
3. **打开「外部联系人」**：
   - 在侧栏「组织结构」中点击「外部联系人」。从助手或已发出的链接进入时，地址带 `?contact=` 会直接打开该联系人。
4. **打开「通讯录同步」**：
   - 在侧栏导航中点击「通讯录同步」。相关的企业微信连接配置与密钥需要在「应用 → 协作平台」中设置。

## 界面一览

### 「组织架构」

「组织架构」页面包含页头、左侧部门树、右侧部门卡片与下方人员列表：

![「组织架构」：左树右人](/shots/admin-directory.webp)

图：「组织架构」：左树右人

1. 页头「组织架构」
2. 「部门类型」：给部门分类并规定挂载关系（仅完整管理员）
3. 「新建部门」
4. 未选部门时「邀请成员」；选中后「邀请成员到本部门」
5. 左栏「全部成员」与部门树
6. 部门「总部」：点开看本部门的人

- **页头**：
  - 显示标题「组织架构」。
  - 拥有写权限时显示「部门类型」（仅组织管理员可见）和「新建部门」按钮。
  - 在左侧选中非企业微信部门时，显示「邀请成员到本部门」；未选中部门或选中企业微信部门时，显示「邀请成员」。如果你是部门管理员且未选中任何部门，相关按钮处于禁用状态，悬停提示「先在左边选一个你管理的部门」。
- **左侧部门树**：
  - 顶部设有搜索框，提示文字为「搜索部门」。
  - 搜索框下方显示「全部成员」及总人数。
  - 部门树节点支持「展开」与「收起」，节点右侧显示包含下级部门的总人数。
  - 当存在尚未分配主部门的成员时，树底部显示「未归入部门」入口。
  - 空状态提示：未建立任何部门时提示「还没有部门。先建一个顶层部门，如公司或总部。」；搜索无匹配时提示「没有匹配的部门。」。
- **右侧部门卡片（选中部门时显示）**：
  - 顶部显示面包屑导航：「全部」→ 上级部门……。
  - 显示部门名称、部门类型徽章，以及企业微信同步来源的「企业微信」徽章。
  - 信息栏展示格式为：负责人姓名（未设置时显示「未设置」）、本部门人数、含下级总人数及部门编号。
  - 提供「调入成员」按钮。
  - 更多操作菜单：包含「编辑部门」（企业微信部门显示为「设类型」）、「新建子部门」（门店类型及企业微信部门无此项）、「删除部门」（仅手工创建的部门显示）。
  - 企业微信同步的部门标记为「只读」，并提示「由企业微信同步，请在企业微信里修改」。下级部门名称可点击直接跳转。
- **下方人员列表**：
  - 列表标题显示当前列表总人数。
  - 选中「未归入部门」时，列表顶部显示提示：「还没归入部门的人：「本部门」类的数据范围和审批的「部门负责人」找不到他们。点人设置主部门。」。
  - 工具栏提供「含下级部门」切换开关，以及搜索框「搜索姓名、邮箱、用户名」。
  - 表格列包含：「成员」「职务」「部门」（在全部成员视图或开启含下级部门时显示）、「业务角色」「管理权限」「状态」。
  - 行内徽章包括：「你」「负责人」「兼任」「企业微信」「企业微信 · 已离职」「企业微信 · 扫码登录」；成员任职展示格式为 角色名 @ 部门名。
  - 点击成员行打开速览，「打开完整资料」进入[成员页面](/admin/members)。
  - 空状态提示：
    - 搜索无匹配：提示「没有符合的成员」和「换个搜索词试试。」。
    - 部门内无人：提示「这个部门还没有人」；若当前部门有下级部门，提示「人可能在下级部门里：打开「含下级部门」。」，无下级部门则提示「邀请新同事，或把已有成员调进来。」。
    - 未归入部门且所有人均已归入：提示「每个人都有部门了」。
    - 全部成员列表为空：提示「没有成员」和「邀请同事加入。」。

### 「部门类型」侧栏

点击「组织架构」页头的「部门类型」可打开右侧抽屉栏：

- **页头与说明**：显示标题「部门类型」，描述说明为「给部门分类（如大区、门店），并规定哪类能放在哪类下面。门店是平台认识的类型。」，并提供「新建类型」按钮。
- **类型卡片**：展示层级类型的名称、编号；系统内置的门店类型带有「内置」徽章。
- **层级规则**：展示「可放在：」顶级、普通部门或允许挂载的层级类型名称；若未限制则显示「不限」；门店类型追加显示「；下面不能再有部门」。
- **统计与操作**：显示该类型下的部门数量；提供「编辑」按钮；非内置类型支持删除。
- **空状态提示**：未创建自定义类型时提示「还没有自定义类型」和「如省、区、城市。」。

### 「门店」

![「门店」列表](/shots/admin-stores.webp)

图：「门店」列表

1. 页头「门店」
2. 「新建」后接类型名（默认「门店」）
3. 按名称、编号或地址搜索
4. 列「营业状态」：筹备 / 营业 / 停业 / 闭店

- **页头与统计**：
  - 显示标题「门店」。
  - 拥有写权限时显示按钮「新建」后接类型名（默认显示「新建门店」）。
  - 尚未创建门店时提示「还没有」+ 类型名，以及「新建一家」+ 类型名 +「。」。
  - 已有门店时显示门店数量，描述信息由各营业状态及对应人数以「 · 」拼接显示。
- **筛选与搜索**：
  - 顶部提供「全部区域」和「全部状态」（包含「未建档」）下拉筛选器。
  - 搜索框提示文字为「名称、编号或地址」。
- **门店列表**：
  - 表格列包含：「门店」「区域」「地址」「电话」「营业状态」。
  - 筛选无匹配时提示「没有符合条件的门店」和「换个区域或状态试试。」。
  - 若部署未启用门店资料，提示「这个部署没有门店资料」。
- **门店详情抽屉**：
  - 字段标签包含：「编号」「区域」「地址」「坐标」「电话」「营业时间」「开业日期」「部门编号」。
  - 负责人未设置时提示「还没有负责人，请在「组织架构」里任命。」。
  - 人员区域显示人员总数与「兼任」标签；无人时提示「这家门店还没有人员。」。
  - 操作按钮包含「编辑资料」/「建档」以及「安排人员」。

### 「外部联系人」

外部联系人是合作方、供应商、渠道那边的人。他们没有平台账号，不进部门，不进汇报线，也不占席位。和客户不是一回事：客户在客户中心，这里只是记下这条关系；需要时再把一位联系人转成客户，两条记录都留着，不合并。

- **页头**：标题「外部联系人」，说明「合作方、供应商、渠道的联系人。没有账号，不进汇报线，不占席位。」。管理员看到「新建」。
- **空态**：还没有任何联系人、也没有企业微信行时，标题「还没有外部联系人」，说明「记下一位合作方或供应商的联系人。」。管理员可点「新建外部联系人」。
- **筛选**：
  - 「全部单位」列出已经填写过的单位名。
  - 「全部状态」可选「在用」「已归档」。
  - 搜索框：管理员的提示是「姓名、单位、电话或邮箱」；审计员的提示是「姓名、单位或邮箱」（按电话搜索只对管理员生效）。
  - 没有符合条件的行时，标题「没有符合条件的联系人」，说明「换个单位或状态试试。」。
- **列表**：列是「姓名」「单位 · 职务」「电话」「负责人」「客户」。已归档的行带「已归档」。已经转成客户的带「已是客户」，并能打开客户中心的该客户；打不开时只保留这个徽标。
- **企业微信来的行**：和手工联系人在同一张表里，带「企业微信」徽标，说明「由企业微信同步，只能查看。」。没有新建、编辑、归档、删除、转成客户。选了某个单位，或状态选「已归档」时，这些行不出现。
- **新建与编辑**（仅管理员）：弹窗标题「新建外部联系人」或「编辑外部联系人」。说明「合作方、供应商、渠道的联系人。他们没有账号，不进部门和汇报线，也不占席位。」。
  | 字段 | 必填 | 说明 |
  |---|---|---|
  | 「姓名」 | 是 | 最多 80 个字 |
  | 「单位」 | 否 | 对方的单位，自由填写，最多 100 个字 |
  | 「职务」 | 否 | 最多 60 个字 |
  | 「负责人」 | 否 | 我方维护这条关系的成员，可以不填。必须是本组织的成员 |
  | 「电话」 | 否 | 只能包含数字、空格、+、- 和括号 |
  | 「邮箱」 | 否 | 要像邮箱地址 |
  | 「备注」 | 否 | 最多 1000 个字 |
- **只读**：审计员可以打开联系人查看，看不到「新建」「保存」「归档」「恢复」「删除」「转成客户」。

### 「通讯录同步」

![「通讯录同步」（未连接企业微信）](/shots/admin-directory-sync.webp)

图：「通讯录同步」（未连接企业微信）

1. 页头「通讯录同步」：以企业微信为准，单向同步
2. 未连接时「去连接」：先到「应用 → 协作平台」填 Secret

- **页头与状态**：
  - 显示标题「通讯录同步」，描述说明为「从企业微信同步部门和成员：同步来的部门和成员在组织架构里只读，以企业微信为准。」。
  - 若部署未启用企业微信，提示「没有可同步的通讯录」和「这个部署没有启用企业微信。」。
  - 若企业微信未连接，提示提供方名称加「还没有连接」和「先在「应用 → 协作平台」里连接，再回来开启同步。」，并提供「去连接」按钮。
- **已连接面板**：
  - 验证警示：提示「尚未对真实企业微信验证」和「目前只在模拟器上验证过。」。
  - 密钥提示：未填写 Secret 时提示「现在不能同步」和「还没有填写通讯录同步 Secret。点「编辑」填写。」，提供「填写 Secret」按钮跳转至协作平台。
  - 同步控制：包含「立即同步」按钮（同步中显示「同步中…」）、「自动同步」开关（未配置 Secret 时提示「没有通讯录同步 Secret，开关不可用。」）以及「同步间隔」选择。
  - 角色映射：包含「其他部门的任职」（说明为「成员在主部门以外各部门的角色。」）和「部门负责人」（说明为「负责人在其部门的角色；审批的「部门负责人」据此找人。」）。
  - 规则说明：展示 6 条「同步的规则」。
  - 「同步记录」：展示「最近 20 次。」记录。无记录时提示「还没有同步记录」及「填写通讯录同步 Secret 后，可以立即同步一次。」或「点「立即同步」跑第一次。」。记录行显示「手动」或「自动」、状态（「成功」「失败」「运行中」）、「用时」及统计数据；失败时提示「同步失败，没有给出原因。」和「失败的一次不会改动已有的部门和成员。」；统计展示「部门」「成员」「任职」维度的「新增」「更新」「移除」「关联」「离开」「跳过」或「无变化」数量，支持展开查看跳过的成员名单。

## 常用操作

### 新建部门

![「新建部门」对话框](/shots/admin-directory-new.webp)

图：「新建部门」对话框

1. 「编号」：可选；小写字母、数字、- 或 _，建好后不能改
2. 「名称」：必填，最多 60 字
3. 「上级部门」：不选即顶层
4. 「类型」：须符合层级类型的「可放在」规则
5. 「保存」

1. 在「组织架构」页头点「新建部门」；或在已有部门卡片右上角菜单点「新建子部门」。
2. 弹出「新建部门」窗口，填写以下字段：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「名称」 | 是 | 部门名称，长度不超过 60 个字符 |
   | 「编号」 | 否 | 部门编号。只能填写小写字母、数字、短横线 - 或下划线 _，创建后不能修改 |
   | 「上级部门」 | 否 | 上级部门。若作为顶层部门，选择「（顶层）」 |
   | 「类型」 | 否 | 选择部门层级类型。如果所选类型与上级不匹配，会提示该类型「不能放在所选的上级下面」 |
3. 填写后点「保存」。保存成功后提示「已保存」。

> **注意**
>
> 门店类型部门以及由企业微信同步生成的部门下方不能新建子部门。

### 编辑部门与设置类型

1. 在左侧部门树选中目标部门。
2. 在部门卡片右上角点「编辑部门」；如果是企业微信同步的部门，点「设类型」。
3. 弹出窗口标题显示为「编辑 」+ 部门名称，或「设置 」+ 部门名称 +「 的类型」：
   - 企业微信部门：部门名称和上级部门由企业微信同步，此处仅能修改部门类型。
   - 手工创建部门：修改上级部门移动该部门时，会连同其所有下级部门一起移动。
4. 修改后点「保存」。保存成功后提示「已保存」。

### 删除部门

1. 在左侧部门树选中需要删除的手工部门。
2. 在部门卡片右上角菜单点「删除部门」。
3. 系统弹出确认提示，说明「有下级部门、成员或任职的部门不能删除。」。
4. 确认后点「删除部门」。删除成功后提示「已删除」，界面自动跳转至上级部门。

> **危险**
>
> 企业微信同步生成的部门不能在页面中删除，必须在企业微信后台操作。部门下存在下级部门、成员或任职时无法删除。

### 调入成员（修改主部门）

1. 在左侧部门树选中非企业微信部门。
2. 在部门卡片上点「调入成员」。
3. 弹出调入窗口，说明选中的成员主部门将改为该部门，其业务角色和其他任职保持不变。
4. 在搜索框中输入姓名或邮箱查找成员（列表排除外部成员，最多展示 200 人；若无可调入成员提示「没有可调入的人。」）。
5. 勾选目标成员，点「调入」按钮。调入完成后提示已把成员调入对应部门。

> **提示**
>
> 人员主部门调整也可以在 [成员](/admin/members) 列表中批量「调整主部门」，或在成员页面上点主部门 chip 调部门、点「+ 兼任」加兼任部门。企业微信同步的部门不能调入成员；受[人力资源](/apps/hr)应用或企业微信锁定的成员主部门无法在此处修改。

### 邀请成员到本部门

1. 在左侧部门树选中目标部门（非企业微信部门）。
2. 在页头点「邀请成员到本部门」。
3. 按照邀请流程填写成员信息并发送邀请，成员加入后主部门直接归入该部门（具体邀请步骤详见 [成员](/admin/members)）。

### 配置部门层级类型

仅组织管理员可以配置部门类型。

1. 在「组织架构」页头点「部门类型」，打开侧栏。
2. 点「新建类型」新建，或在已有类型卡片上点「编辑」。弹窗标题为「新建层级类型」或「编辑类型 」+ 名称。说明提示「类型只用来显示、筛选和校验挂载关系，不影响数据范围。」（针对内置的门店类型，说明提示「门店是内置类型，可以改名称和能放在哪里；门店下面始终不能再有部门。」）。
3. 填写层级类型配置：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「名称」 | 是 | 类型名称，长度不超过 20 个字符（如：省、区、城市） |
   | 「编号」 | 是 | 类型编号（如 province），创建后不能修改 |
   | 「可放在」 | 否 | 勾选允许挂载的上级类型，可选「顶级」「普通部门」及其他层级类型。都不勾选表示「不限」 |
4. 填写后点「保存」。保存成功后提示「已保存」。若类型总数超出上限，提示最多允许的层级类型数；若编号重复，提示该编号已经存在。
5. 删除类型：在非内置类型卡片上点删除。弹窗提示确认删除，并说明「仍有部门使用的类型不能删除。其他类型「可放在」里的这一项会一并去掉。」。若有其他类型规则限制只能放在该类型下，系统会提示先修改它们可放的位置。

### 新建、编辑与建档门店

1. 打开「门店」页面，点右上角「新建」后接类型名按钮（默认显示「新建门店」）；或在已有门店行右侧菜单点「编辑资料」或「建档」。弹窗标题为「新建门店」、「编辑」门店名称或为门店建档。
   说明提示：门店是组织里的部门。企业微信同步的门店其名称和所属区域需在企业微信中修改，此处仅修改门店资料。
2. 填写门店资料：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「名称」 | 是 | 门店名称，长度不超过 60 个字符 |
   | 「所属区域」 | 是 | 点「选择区域」，选择上级部门。所属区域必须是非门店、非企业微信托管且符合层级类型「可放在」规则的部门（若无可用部门，提示「还没有可放」+ 类型名 +「的部门，请先在「组织架构」建区域。」） |
   | 「门店编号」 | 否 | 组织内唯一，可不填 |
   | 「营业状态」 | 否 | 状态可选「筹备」「营业」「停业」「闭店」 |
   | 「开业日期」 | 否 | 开业日期 |
   | 「省份」 | 否 | 门店所在省份 |
   | 「城市」 | 否 | 门店所在城市 |
   | 「区县」 | 否 | 门店所在区县 |
   | 「详细地址」 | 否 | 门店详细地址 |
   | 「经度」 | 否 | 门店地理经度 |
   | 「纬度」 | 否 | 门店地理纬度 |
   | 「电话」 | 否 | 门店联系电话 |
   | 「营业时间」 | 否 | 门店营业时间 |
3. 填写后点「新建」「建档」或「保存」。操作成功后提示已新建门店、已建档或已保存。

### 修改门店营业状态

1. 在「门店」列表对应行右侧菜单，选择目标操作：「改为筹备」「开始营业」「停业」「闭店」。
2. 状态切换规则：
   - 已营业过的门店不能再切换回「筹备」。
   - 点击「开始营业」时，若未填写开业日期，系统提示「未填开业日期的，记为今天。」。
   - 切换为「停业」时，系统说明「停业期间记录照常可查。」。
   - 切换为「闭店」时，系统说明「闭店后记录和人员保留，各应用不再列出该门店；可重新营业。」。
3. 变更成功后，系统提示门店已「开始营业」，或提示门店已进入目标状态。

### 删除门店

1. 仅处于「筹备」或「未建档」状态的门店可以删除。在门店列表对应行右侧菜单点「删除」。
2. 弹窗提示确认删除门店，并说明「仅筹备中的门店可删除，门店资料和部门一并删除；部门还有人员时无法删除。」。
3. 确认后完成删除。

### 新建与编辑外部联系人

1. 在「外部联系人」页头点「新建」，或在某一行打开后点编辑。企业微信来的行不能编辑。
2. 填写姓名，以及需要的单位、职务、负责人、电话、邮箱、备注。
3. 点「新建」或「保存」。成功后提示「已新建外部联系人」或「已保存」。

### 归档、恢复与删除外部联系人

1. 在联系人行的菜单或详情里点「归档」。确认说明「归档后仍可在「已归档」里看到，也可以恢复。」。成功后提示「已归档」。
2. 在「已归档」里点「恢复」。说明「恢复后联系人重新在用。」。成功后提示「已恢复」。
3. 删除只对已经归档、并且还没有转成客户的联系人出现。确认说明「只能删除已归档、且没有转成客户的联系人。」。成功后提示「已删除」。已经转成客户的联系人只能归档，不能删除。

### 把外部联系人转成客户

1. 还没有客户编号时，行菜单和详情里有「转成客户」。确认说明：按电话在客户中心查找或新建客户，并把客户编号记在这条联系人上；联系人仍然保留，两条记录不合并；没有可用电话时，会新建一个不带身份的客户。
2. 成功后提示「已转成客户」。再点一次不会新建另一位客户，提示「已经是客户」。
3. 转过之后，按钮变成「查看客户」，行上显示「已是客户」。

### 从企业微信同步通讯录

1. 前往「应用 → 协作平台」连接企业微信，并在配置中填写「通讯录同步 Secret」。
2. 返回「通讯录同步」页面。
3. 配置角色映射：选择「其他部门的任职」与「部门负责人」，修改后系统提示「已保存，下次同步生效」。
4. 开启「自动同步」（开启后提示「已开启自动同步」）并设置「同步间隔」（保存后提示「已保存同步间隔」）；或点「立即同步」手动执行同步。
5. 同步完成时提示「同步完成」；同步失败时提示「同步失败，原因见下面的记录」。若已有同步任务正在运行，系统提示稍后在记录中查看。

系统展示的 6 条「同步的规则」如下：
1. 以企业微信为准，单向同步，不会改动企业微信。
2. 同步部门、成员和直属上级，不同步角色及其权限。
3. 主部门为准；其他部门和负责人按上面选的角色同步为任职。
4. 同步建的任职要在企业微信里改；手工建的任职不受影响。
5. 离职成员只停用，账号和数据保留。
6. 没有邮箱的成员用占位邮箱，只能扫码登录。

## 状态说明

### 门店营业状态

| 状态 | 说明 |
|---|---|
| 「未建档」 | 门店部门已建立，尚未补充门店主档资料 |
| 「筹备」 | 筹备中的门店。门店资料和部门均可直接删除；一旦营业过则无法退回筹备 |
| 「营业」 | 正式营业中。未填写开业日期的自动记为当天 |
| 「停业」 | 暂停营业。停业期间的历史记录照常可查 |
| 「闭店」 | 停止营业。门店资料和人员予以保留，各业务应用中不再列出该门店；后续可重新改为营业 |

### 外部联系人状态

| 状态 | 说明 |
|---|---|
| 「在用」 | 正在维护的联系人。不能直接删除 |
| 「已归档」 | 仍可在「已归档」里看到，也可以恢复。还没有转成客户时可以删除 |

已经转成客户的联系人，不论在用还是已归档，都不能删除。

### 通讯录同步状态

同步记录包含以下执行状态：

| 状态 | 说明 |
|---|---|
| 「运行中」 | 同步任务正在执行中，此时无法重复触发同步 |
| 「成功」 | 同步完成。记录中统计部门、成员和任职的新增、更新、移除、关联、离开、跳过或无变化数量 |
| 「失败」 | 同步执行失败，提示「同步失败，没有给出原因。」。失败的一次不会改动已有的部门和成员 |

## 让助手帮你做

你可以让助手协助处理组织架构、门店、外部联系人和同步相关的操作。例如：

> 在销售部下建一个华北区
> 把张三调到济南1店
> 新建一家济南2店，挂在济南下面
> 把济南1店改为营业
> 新建一位外部联系人，姓名张三，单位华北供应商，职务销售
> 把这位外部联系人归档
> 把这位外部联系人转成客户
> 马上从企业微信同步一次通讯录
> 打开自动同步，每隔一小时

需要你确认的操作：
- 删除部门、调整成员的部门与角色（含兼任与任职）、修改人员资料，以及执行通讯录同步配置和手动同步属于高风险操作，助手会要求你二次确认。
- 新建、修改、归档或恢复外部联系人是中等风险。删除外部联系人、以及把外部联系人转成客户是高风险，助手会要求你确认。删除的确认是「删除后这条外部联系人不再保留。已转成客户的联系人不能删除。」。转成客户的确认是「会在客户中心按电话查找或新建客户，并把客户编号记在这条联系人上。联系人仍然保留。」。
- 配置通讯录自动同步时，助手会提示你确认：「打开后，部门和成员定时按企业微信的通讯录更新：新建和修改部门、为新成员建账号、停用已离开的人。」。
- 执行立即同步时，助手会提示你确认：「现在按企业微信的通讯录新建和修改部门、为新成员建账号、停用已离开的人。」。

> **助手边界**
>
> 助手不能直接修改企业微信中的部门或成员；不能撤销企业微信同步生成的任职；不能保证系统在真实企业微信环境中完全验证（当前系统仅在模拟器上完成验证）；不能同步企业微信的角色权限或头像。

## 设置

通讯录同步相关设置项（仅组织管理员可配置，保存后立即生效）：

| 设置项 | 作用 | 取值范围 | 默认值 |
|---|---|---|---|
| 「自动同步」 | 定时自动从企业微信拉取通讯录变动 | 开 / 关 | 关（未配置 Secret 时开关不可用） |
| 「同步间隔」 | 定时自动同步的执行频率 | 5–1440 分钟（界面常用选项：每天、每 15/30 分钟、1/2/6 小时） | 30 分钟 |
| 「其他部门的任职」 | 成员在主部门以外兼任部门的角色映射 | 「不同步（默认）」或指定的业务角色 | 「不同步（默认）」 |
| 「部门负责人」 | 企业微信部门负责人在平台中对应的角色，[审批](/apps/flow)流程中的「部门负责人」据此查找人员 | 「部门负责人（内置，默认）」、组织负责人角色、「不同步负责人」 | 「部门负责人（内置，默认）」 |

> **提示**
>
> 通讯录同步 Secret 在「应用 → 协作平台」中配置，不在本页面修改。若在协作平台中勾选「清除已保存的 Secret（自动同步会随之停止）」，自动同步将随之停止。

## 注意事项

- **规格上限**：组织内最多创建 5000 个部门，部门层级树最多 8 层；部门编号长度为 2–40 位字符，部门名称长度不超过 60 个字符。
- **部门类型数量**：层级类型最多支持 12 种，名称长度不超过 20 个字符。
- **调入数量限制**：单次「调入成员」弹窗列表最多显示 200 人。
- **门店节点限制**：门店类型在层级树中属于叶子节点，门店下面始终不能再有部门。
- **企业微信单向同步**：同步操作为单向拉取，不会修改企业微信端的数据。由企业微信同步生成的部门、任职以及部分人员资料（部门、兼任、直属上级、职务）以企业微信为准，在平台中为只读状态，不能在平台中修改或删除。
- **账号与离职处理**：企业微信同步中没有邮箱的成员会被分配占位邮箱，此类成员只能通过扫码登录。在企业微信中离职的成员在平台中只会被停用，账号和历史业务数据均会保留。
- **自动保护与互斥**：手动同步与自动同步互斥，已有同步任务运行时无法重复发起。如果某次同步失败，不会改动已有的部门和成员；当企业微信返回的成员列表为空但平台已有同步关联的成员时，整次同步会停止，以防止误停用全部成员。
- **同步内容限制**：通讯录同步不包含成员头像，不包含角色权限，也不会将邮箱变更写回身份提供方；系统当前不提供通讯录变更回调，需依赖定时自动同步或手动同步。
- **环境说明**：界面明确标注「尚未对真实企业微信验证」，目前功能仅在模拟器环境完成验证。
- **人员资料维护优先级**：企业微信 > 人力资源 > 手工。企业微信同步的人员，部门、兼任、直属上级与职务均以企业微信为准。
- **外部联系人不是成员**：没有账号，不进部门和汇报线，不占席位。电话和邮箱只在已登录的人之间可见，不会写进审计。
- **企业微信来的外部联系人只读**：在本页只能查看，改他们要到企业微信。手工记下的联系人与这些行不是同一条记录。

## 目前不支持

- 真实企业微信联调验证（当前界面明确标注仅在模拟器验证过）。
- 企业微信通讯录实时变更回调通知。
- 门店地图展示。
- 把外部联系人并进成员、部门或汇报线。企业微信同步来的外部联系人不能在本页修改。

## 常见问题

### 为什么在部门卡片上找不到「新建子部门」或「删除部门」？
如果当前选中的部门是门店类型，或者是由企业微信同步生成的部门，系统不允许在其下方创建子部门。同时，企业微信同步的部门属于只读部门，无法在页面中删除，必须在企业微信后台操作。手工创建的部门如果包含下级部门、成员或任职，也无法直接删除。

### 为什么有些成员在组织架构中看不到？
如果成员尚未归入任何主部门，他们会列在部门树底部的「未归入部门」中。此外，在部门人员列表中若未开启「含下级部门」开关，系统仅展示主部门在该部门的成员；下级部门的人员需要打开该开关才会显示。

### 为什么「自动同步」开关处于禁用状态？
开启「自动同步」的前提是已配置有效的「通讯录同步 Secret」。如果尚未在「应用 → 协作平台」中填写该 Secret，系统会提示「没有通讯录同步 Secret，开关不可用。」，此时无法开启自动同步。

### 企业微信同步记录中成员被「跳过」是什么原因？
在同步记录中展开跳过成员，可以查看具体原因。常见跳过原因包括：成员没有所属部门、主部门不在 Secret 的可见范围、成员邮箱已被占用、组织席位已满，或者账号创建失败等。

### 门店设为「闭店」后，历史数据和人员会被删除吗？
不会。将门店状态改为「闭店」后，门店资料、历史业务记录和归属人员都会保留，只是各业务应用中不再列出该门店。后续需要时，可以在行菜单中将其重新改为营业状态。

### 外部联系人和客户有什么区别？
外部联系人记的是合作方、供应商、渠道那边的人，留在「组织结构」里，没有账号。客户在客户中心。点「转成客户」后，两边都还在：联系人上记下客户编号，人不会被合并掉，也不会从这张表里消失。

### 为什么有的外部联系人不能编辑？
带「企业微信」徽标的行来自企业微信同步，这一页只给查看，没有操作按钮。要改姓名或关系，到企业微信里改。