# 客户
「客户」是店长和前台员工查看与管理本组织客户档案的工作台界面，提供客户 360 视图、标签与归属管理、合并建议、渠道活码、同意与退订登记、客户匿名化以及 CSV 导入导出功能。
「客户」应用作为 [工作台](/guide/workspace) 的可选应用。未安装时，[会员](/apps/membership)、[站点](/apps/site) 与 [订单](/apps/order) 仍可登记和查看客户。
## 谁能用
「客户」应用通过权限点与数据范围控制操作权限。助手仅能进行读取操作，无法直接向系统发起写入。
| 权限标签 | 说明 | 是否带数据范围 |
|---|---|---|
| 「查看客户」 | 查看客户档案、时间线、标签与权益 | 是 |
| 「编辑客户」 | 给客户打标签、指定归属员工、批量操作、导入客户、查看完整手机号 | 是 |
| 「合并客户」 | 合并两个客户档案、处理合并建议 | 否 |
| 「导出客户」 | 导出客户清单 | 否 |
| 「管理同意与退订」 | 登记同意与退订（只增不改） | 否 |
| 「匿名化客户」 | 匿名化客户（清除姓名与手机号等，不可恢复） | 否 |
**数据范围与默认角色说明**
- **数据范围规则**：
- **全部范围**：可以查看或修改本组织全部客户。
- **仅自己**：仅能查看或修改归属员工为自己的客户。
- **部门范围**：仅能查看或修改归属部门在授权部门（含子部门）内的客户。
- **无归属客户**：没有归属员工的客户，仅拥有全部范围权限的成员可见。[会员](/apps/membership) 登记产生的客户初始通常没有归属，普通成员默认看不到，需由管理员在客户应用中指定归属后方可查看。
- **关联操作要求**：合并客户、登记同意与退订、匿名化虽然不带独立数据范围，但要求操作者在「查看客户」范围内能同时查看到涉及的客户。超出范围的客户直接提示找不到。合并建议列表仅展示两端客户均在查看范围内的建议。
- **全部范围专属操作**：标签字典的新建、改名与删除，以及渠道活码的新建与删除，需要「编辑客户」的全部范围权限。给单个客户打已有标签只需「编辑客户」权限；在详情页输入新名字建标签也只需「编辑客户」。导入客户时，非全部范围权限成员导入的客户归导入人负责；全部范围权限成员导入的客户不设归属。
- **组织默认角色**：
- **组织管理员**：拥有全部权限点与全部数据范围。
- **审计员**：拥有「查看客户」权限（全部范围），只读访问。
- **普通成员**：拥有「查看客户」与「编辑客户」权限，数据范围仅限自己。
- **分析员**：拥有「查看客户」权限（全部范围）以及「导出客户」权限。
- **其他成员**：「合并客户」「管理同意与退订」「匿名化客户」默认无权限，仅管理员或在 [角色](/admin/roles) 中被单独授权的成员可用。
- 组织切换到自管角色后，改由管理员在 [业务角色](/admin/roles) 中分配具体权限。组织管理员仍持有全部权限，审计员仍可读。
### 无权限提示
- 无「查看客户」权限时，进入列表页或渠道活码页，界面显示「没有查看客户的权限」，并说明请联系管理员开通「客户查看」。
- 无「合并客户」权限时，进入合并建议页，界面显示「你没有合并客户的权限」，并说明合并建议只给有「客户合并」权限的人看。需要的话请联系管理员。
- 访问「导入导出」页时，若既无导入权限也无导出权限，界面显示「你没有导入或导出客户的权限」，并说明需要「客户编辑」才能导入，需要「客户导出」才能导出；若缺少其中一项，分别提示导出需要「客户导出」权限，请联系管理员，或导入需要「客户编辑」权限，请联系管理员。
- 访问负责范围之外的客户时，界面显示「找不到这位客户，或你没有权限查看」，说明「可能已被合并、匿名化，或不在你负责的范围内。」。
### 助手权限限制
助手不能自己改客户或导出客户。助手通过动作提出修改建议，经由你确认批准后方可以你的身份执行。查看完整手机号不提供助手操作，必须由你在界面上手动点击。
## 怎么打开
1. 在 [工作台](/guide/workspace) 中切换到「康复」套件，点击「客户」页签（本应用为可选应用，套件必装应用为 [会员](/apps/membership)）。
2. 在浏览器中直接输入地址访问：`https://customer.apps.{base}`。
进入应用后，顶栏提供以下页面标签（无侧边栏，根据权限展示）：
- **「客户」**：客户列表与 360 档案主视图。
- **「合并建议」**：系统识别的疑似同一人档案对比建议（角标显示未处理建议数，约 2 分钟刷新一次）。
- **「渠道活码」**：配置扫码添加员工的企业微信渠道活码。
- **「导入导出」**：批量导入客户 CSV 与导出客户数据。
工作台或助手打开客户、标签、合并建议或活码时，会落到对应档案、对话框或卡片。引用标题用姓名；没有姓名显示「未填姓名的客户」，不含手机号。
在 [会员](/apps/membership) 详情中点击「打开客户档案」可直接跳转到本应用对应客户；在 [组织成员](/admin/members) 离职交接中移交「负责的客户」后，会自动打开按接手人筛选的客户列表。
## 界面一览
图：「客户」列表：会员和订单带进来的人
1. 「合并建议」：同一人的两份档案
2. 「管理标签」：门店共用的标签字典
3. 按姓名、手机号或后几位查找
4. 按阶段筛选：全部、线索、客户等
5. 列表列：阶段
6. 列表列：标签
| 页面 / 区域 | 主要内容与功能 |
|---|---|
| 「客户」列表 | 顶部展示搜索框（支持姓名、手机号、手机后几位，最多 40 字）、「待关联」开关（仅在有待关联人数或已开启该筛选时显示）、「有合并建议」开关（需「合并客户」权限）；阶段筛选芯片（包含「全部」「线索」「客户」「沉睡」及人数统计）；下拉筛选器（「按标签筛选」「按归属员工筛选」「按来源筛选」）；右上角提供「管理标签」与「导出」按钮。列表展示客户姓名、脱敏手机号、阶段徽章、标签芯片、归属员工、来源应用及渠道、最近联系时间；每页 30 人，底栏显示「共」后接人数再接「位」；勾选客户后出现批量操作栏。 |
| 「管理标签」对话框 | 点击列表右上角「管理标签」打开。展示所有标签名称、色点、使用客户数（后接「 位客户」）以及标签来源（手工标签、来自企业微信、由规则自动打上）。拥有全部范围「编辑客户」权限的人员可新建、修改与删除手工标签，非全部范围人员仅可查看。 |
| 客户详情页 | 页眉展示客户姓名（未填姓名显示「未填姓名」）、返回「客户」按钮、阶段徽章、脱敏手机号与归属员工。
• **企业微信说明**：存在待关联情况时显示警告「待关联：可能和另一位客户是同一个人」；通过员工备注对上时显示「按员工备注的手机号对上」。
• **「基本信息」**：展示客户所有身份项（手机号、邮箱、微信 openid、微信 unionid、企业微信客户），标注「已验证」或「未验证」；提供「查看完整号码」按钮；事实行展示来源、登记时间、最近联系、首次成交与往来次数。
• **「权益」**：只读展示名下「券与权益」（次卡、期卡、次卡+期卡、券、奖品）及「课程包」（可点击跳转对应会员页）；不显示券码，不能核销或撤销。
• **「同意与退订」**：网格展示短信、微信模板消息、企业微信与所有渠道在服务通知和营销上的状态（已同意、已撤回、未登记）；展示只增不改的登记历史记录；提供「登记一条」表单。
• **「时间线」**：按时间倒序展示客户业务往来记录（购买、退款、访问、表单、核销、企业微信变动、合并、匿名化等），每页 30 条。
• **侧栏**：提供「归属员工」查看与修改、「标签」添加与移除、「关联」业务记录（会员档案、课程包、订单、往来方、文档、表单；无权限显示「无权查看或已删除」）以及「合并另一个客户」按钮。
• **页底「危险操作」**：提供「匿名化…」操作入口。 |
| 「合并建议」 | 展示系统识别出的疑似同一人档案对比卡片。卡片标题标明判定原因（如「两个档案用了同一个手机号」「两个档案用了同一个邮箱」「两个档案对应同一个微信号」「两个档案对应同一个微信账号」「两个档案对应同一个企业微信客户」等）与发现时间。并排对比「档案 A」与「档案 B」的阶段、联系方式、归属员工、标签、登记时间、最近联系、往来次数与关联记录。明确提示合并后保留登记更早的档案；提供「不是同一个人」与「合并」操作按钮。 |
| 「渠道活码」 | 顶部标明「未对真实企业微信验证」提示。展示已创建的渠道活码卡片，包含二维码预览、活码名称、渠道、活动 ID、添加员工列表、已添加人数统计、创建时间与短码。提供二维码「下载」（SVG 或 PNG 格式）与「删除」按钮；右上角提供「新建活码」按钮。 |
| 「导入导出」 | 包含「导出」与「导入」两大区域。
• **「导出」**：支持按阶段、标签、归属、来源组合筛选；提供「导出 CSV」按钮（手机号脱敏）；管理员专享「导出完整手机号」按钮（计入审计）。
• **「导入」**：提供「下载模板」按钮；支持上传或拖拽 CSV 文件（单次最多 2000 行，文件不超过 2 MB）；提供「检查文件」预演检查与「确认导入」按钮。 |
## 常用操作
### 查找与筛选客户
图：查找与阶段、标签筛选
1. 查找客户：姓名 / 手机号 / 后几位
2. 「线索」阶段
3. 「客户」阶段
4. 按标签筛选
5. 按归属员工筛选
1. 在顶栏点「客户」。
2. 在搜索框中输入姓名、完整手机号或手机后几位（最多 40 字）。系统会在输入约 300 ms 后自动发起查询。
3. 在阶段筛选芯片中，点「全部」「线索」「客户」或「沉睡」。
4. 根据需要开启特定筛选开关：
- 点「待关联」开关，仅查看尚未对上的企业微信联系人。
- 点「有合并建议」开关（需拥有「合并客户」权限），仅查看系统已生成合并建议的客户。
5. 在下拉菜单中进一步过滤：
- 点「按标签筛选」，选择指定标签。
- 点「按归属员工筛选」，选择「我负责的」或指定组织成员姓名。
- 点「按来源筛选」，选择「会员」「站点」「企业微信」「导入」「手工登记」「优惠券」「活动」或「订单」。
6. 若没有匹配客户，界面显示「没有符合条件的客户」，点「清除筛选」重置所有筛选条件。
### 查看完整手机号
图：客户详情：基本信息与完整号码
1. 「基本信息」：联系方式默认打码
2. 「查看完整号码」：查看会记入审计，约一分钟后重新打码
3. 「归属员工」
4. 这位客户身上的标签
5. 「同意与退订」：发营销消息前会按这里检查
1. 在客户列表中点客户姓名，打开客户详情页。
2. 在主栏找到「基本信息」区域。
3. 点「查看完整号码」（需拥有「编辑客户」权限，且该客户在你的数据范围内）。
4. 手机号显示明文，界面提示完整号码已显示，60 秒后自动隐藏，并说明查看已留下审计记录。
5. 若需提前恢复隐藏，点「隐藏完整号码」；未主动点击时，系统将在 60 秒后自动恢复脱敏。
> **注意**
>
> 每次查看完整手机号都会在系统中留下审计记录。助手无法代为查看完整手机号。
### 指定客户归属
1. 在客户列表中点客户姓名，打开客户详情页。
2. 在侧栏找到「归属员工」区域。
3. 点归属下拉菜单，选择组织成员姓名，或选择「未分配」。
4. 点「保存」。
5. 保存后，界面提示已指派给对应成员或「已清空归属」，归属部门自动记录为该成员所在部门。
> **注意**
>
> 若你的权限范围仅限「仅自己」，将客户转派给其他成员后，你将立即失去该客户的查看权限。
### 为单个客户添加或移除标签
1. 在客户列表中点客户姓名，打开客户详情页。
2. 在侧栏找到「标签」区域。
3. **添加标签**：
- 在输入框（占位「添加标签：选一个，或输入新名字」）中输入标签名（最多 20 字）。
- 在下拉建议列表中点选已有标签，或点以「新建标签「」开头的建议项。
- 按回车键或点加号。打上已有标签提示「已打上」后接标签名；新建标签提示「已新建并打上」后接标签名（详情页新建标签默认颜色为灰）；若客户已有该标签，提示「已经有」后接标签名。
4. **移除标签**：
- 在手工标签芯片右侧点「×」。
- 带有「来自企业微信」或「由规则自动打上」标识的标签不能在此处修改。
### 管理标签字典
图：「管理标签」对话框
1. 标题：「管理标签」
2. 标签名
3. 「保存」：标签门店共用
1. 在顶栏点「客户」，再点右上角「管理标签」。
2. **新建标签**：
- 在对话框底部点「新建标签」。
- 在「标签名」输入框中输入名称（最多 20 字，未填写提示「请输入标签名」）。
- 在色点选项中选择颜色（可选「灰」「红」「橙」「黄」「绿」「青」「蓝」「紫」「粉」，默认选中「蓝」）。
- 点「保存」。保存后新标签出现在列表中；若存在同名标签，提示「已经存在同名的记录」。
3. **修改标签**：
- 确认你拥有「编辑客户」的全部范围权限。
- 在目标手工标签行右侧点编辑图标（读屏名「编辑标签」后接标签名）。
- 修改标签名或色点颜色，点「保存」。
4. **删除标签**：
- 确认你拥有「编辑客户」的全部范围权限。
- 在目标手工标签行右侧点删除图标（读屏名「删除标签」后接标签名）。
- 弹窗提示「删除「」后接标签名再接「」？」。若有客户正在使用，提示多少位客户不再有这个标签，否则提示「没有客户用它。」，并说明「客户本身不受影响。」。
- 点「删除」。确认后界面提示已删除标签，以及多少位客户不再有该标签。
> **危险**
>
> 删除标签会从本组织所有客户身上一并移除该标签，此操作不能撤销。
### 批量打标签、取消标签与指派归属
1. 在客户列表中，勾选目标客户左侧的多选框（可勾选表头多选框选中本页全部客户；换页或修改筛选条件会清空勾选）。
2. 在列表上方弹出的批量操作条中，查看当前已选人数。
3. 根据需要选择操作：
- **批量打标签**：点「打标签」，在弹窗中选择一个手工标签，点「确定」。若组织内暂无可用手工标签，提示先在「管理标签」里新建。
- **批量取消标签**：点「取消标签」，在弹窗中选择要取消的手工标签，点「确定」。
- **批量指派归属**：点「指派归属」，在弹窗中选择接手的组织成员姓名或选「未分配（清空归属）」，点「确定」。
4. 系统单次最多提交 200 位客户。
5. 操作完成后：
- 全部成功：界面提示已处理多少位。
- 部分失败：界面提示已处理多少位、多少位没有成功，并弹出提示框告知具体失败人数，其余客户已处理完成，点「知道了」关闭弹窗。
### 合并两位客户档案
1. 在客户列表中点目标客户姓名，打开客户详情页。
2. 在侧栏「合并」区域点「合并另一个客户」（需拥有「合并客户」权限）。
3. 在搜索框中输入另一位客户的姓名、完整手机号或手机后几位（最多 40 字，至少输入 1 字），在检索结果中点击选中目标客户。
4. 在并排预览区域核对「这位客户」与「另一位」的档案内容。系统明确标明保留登记更早的档案作为主档案，并列出合并过去的联系方式数量、标签数量、关联记录条数与时间线记录条数。
5. 点「确认合并」。合并完成后界面提示「已合并为一个客户档案」，页面自动跳转至保留的主档案。
> **危险**
>
> 合并后两个档案成为一个，不能再拆开。被并入的客户 ID 今后访问时会自动打开主客户档案。
### 处理合并建议
1. 在顶栏点「合并建议」（角标显示未处理建议数量）。
2. 查看系统给出的合并建议卡片。卡片标题会标明判定原因（如「两个档案用了同一个手机号」「两个档案用了同一个邮箱」「两个档案对应同一个微信号」「两个档案对应同一个微信账号」「两个档案对应同一个企业微信客户」等），副文显示发现时间。
3. 对比「档案 A」与「档案 B」的阶段、联系方式、归属员工、标签、登记时间、最近联系、往来次数与关联记录。系统明确标明登记更早的档案显示「保留这个档案」，另一侧显示「合并后并入对方」。
4. 做出处理决定：
- **采纳合并**：点「合并」。系统将两份档案合为一个，提示「已合并为一个客户档案」。
- **忽略建议**：点「不是同一个人」。弹窗提示「确认不是同一个人？」「这一对以后不再提示，两个档案保持原样。」，再次点「不是同一个人」。界面提示「已忽略，不会再提示这一对」，系统今后不再提示该对客户。
### 登记同意与退订
1. 在客户列表中点客户姓名，打开客户详情页。
2. 在主栏找到「同意与退订」区域（需拥有「管理同意与退订」权限）。
3. 查看「当前状态」网格中各渠道（短信、微信模板消息、企业微信、所有渠道）在服务通知与营销上的授权状态（「已同意」「已撤回」「未登记」）。
4. 在「登记一条」表单中填写：
| 字段 | 必填 | 说明 |
|---|---|---|
| 「渠道」 | 是 | 选择授权涉及的渠道（「短信」「微信模板消息」「企业微信」「所有渠道」） |
| 「用途」 | 是 | 选择消息用途（「服务通知」「营销」） |
| 「结果」 | 是 | 选择授权状态（「同意」「撤回」） |
| 「怎么得到的」 | 否 | 填写获取同意或退订的途径，最多 60 字，默认填入「前台登记」 |
5. 点「登记」。
6. 登记成功后界面提示「已登记：同意」或「已登记：撤回」，记录实时追加到下方「登记记录」列表中。
> **提示**
>
> 登记记录只增不改，同意或撤回都是新增一条记录，已有的记录不能修改或删除。系统群发营销消息前会按最新记录检查。「所有渠道」的记录对所有具体渠道均生效。
### 匿名化客户
1. 确认客户明确提出删除个人信息的要求，且你拥有「匿名化客户」权限。
2. 在客户详情页滚动至最底部，在「危险操作」区域点「匿名化…」。
3. 在弹出的对话框中，阅读处理后果：
- 「姓名清空」
- 「手机号、邮箱、微信等联系方式永久销毁」
- 「所有同意都按撤回处理」
- 「档案本身和往来记录保留，但不再能认出是谁」
页上另有说明：保留用于统计，但不再对应到具体的人。此前合并进来的档案会一并匿名化，但不写在这四条里。
4. 在确认输入框中，原样输入该客户当前的姓名；若客户当前未填姓名，输入「匿名化」。
5. 点「确认匿名化」（输入文字不符时按钮保持禁用）。
6. 处理完成后界面提示「已匿名化」，页面自动返回客户列表。
> **危险**
>
> 匿名化操作不能撤销。姓名与联系方式永久销毁，无法找回。若该客户未来使用原手机号重新登记，系统将作为全新客户建立档案。
### 导出客户数据
1. 在顶栏点「导入导出」，或在客户列表右上角点「导出」（需拥有「导出客户」权限）。
2. 在「导出」区域选择导出筛选条件：
- 选择阶段（可选「全部阶段」「线索」「客户」「沉睡」）。
- 按需选择标签、归属员工与来源。系统在下方「将导出：」中展示筛选摘要。
3. **导出脱敏清单**：
- 点「导出 CSV」。
- 浏览器下载 `客户.csv`，手机号中间几位自动隐藏脱敏。导出成功提示「已导出」。
4. **导出完整手机号（仅组织管理员）**：
- 组织管理员在导出区域可看到「导出完整手机号」按钮（非管理员显示说明「需要完整号码请联系管理员。」）。
- 点「导出完整手机号」。
- 弹窗提示「导出完整手机号？」「文件含客户完整手机号，请妥善保管。这次导出会记入审计记录。」，点「导出完整手机号」。
- 浏览器下载 `客户（完整手机号）.csv`，提示「已导出完整手机号，这次导出已记入审计」。
> **注意**
>
> 导出文件为 UTF-8 带 BOM 编码的 CSV 文件，字段包含客户编号、姓名、阶段、手机号、邮箱、归属员工、来源、标签、创建时间与最近联系时间。导出完整手机号会严格记入系统审计记录。助手无法导出客户数据。
### 导入客户数据
1. 在顶栏点「导入导出」（需拥有「编辑客户」权限）。
2. 在「导入」区域点「下载模板」，获取 `客户导入模板.csv`（包含姓名、手机号、邮箱、渠道、已验证表头）。
3. 整理准备导入的 CSV 文件：
- 单次最多导入 2000 行，文件大小不超过 2 MB。
- 表头必须包含「手机号」或「邮箱」列中的至少一列。
- 每行数据至少填写手机号或邮箱之一。
- 「已验证」列填写「是」或留空（留空默认为「否」）。未标「已验证」的号码按线索录入，不会自动合并已有档案。
- 导入不支持标签列与归属列。
4. 点选文件或将 CSV 文件拖入上传区域。
5. 点「检查文件」进行预演检查：
- 检查通过：界面提示「检查通过，可以导入。」，并显示总行数、预计新建客户数以及匹配已有客户数。
- 检查失败：界面提示有几行需要修改，一位都没有导入，并在表格中列出具体行号与问题原因。
6. 检查通过后，点「确认导入」。若检查后修改过本地文件，系统提示「文件有变化，请先重新检查」，必须重新点「检查文件」。
7. 导入完成后，界面提示已导入新建与匹配已有客户数量，页内显示具体完成明细。
> **注意**
>
> 导入采用整份成功或整份不导原则。只要有一行存在问题，就一位都不会导入，改好后必须重新检查。非全部范围权限的成员导入的客户归导入人负责；全部范围权限成员导入的客户不设归属。
### 新建与删除渠道活码
1. 在顶栏点「渠道活码」。
2. 确认组织已在 [组织连接器](/admin/connectors) 中连接企业微信并填写客户联系 Secret。未配置时页面可能提示「还没有连接企业微信」「还没有填写客户联系 Secret」，或「企业微信连接器没有启用」，并提供跳转配置按钮。
3. **新建渠道活码**：
- 点右上角「新建活码」（需拥有「编辑客户」的全部范围权限）。
- 填写活码信息：
| 字段 | 必填 | 说明 |
|---|---|---|
| 「名称」 | 是 | 填写活码名称（用于内部区分，如「春季地推」「朝阳门店台卡」），最多 60 字。未填提示「名称不能为空」 |
| 「渠道（可选）」 | 否 | 填写获客渠道，留空默认使用名称，最多 60 字 |
| 「活动（可选）」 | 否 | 填写活动编号，或活动应用里的对象链接 |
| 「由谁添加」 | 是 | 选择接待员工，至少选 1 位，最多选 20 位。选多位时企业微信会在他们之间分配新客户 |
- 点「创建」。创建成功提示「已创建活码」。
4. **下载渠道活码**：
- 在活码卡片上点「下载」，可选择保存为 SVG 或 PNG 格式图片制作展架或物料。
5. **删除渠道活码**：
- 在活码卡片上点「删除」（需拥有「编辑客户」的全部范围权限）。
- 弹窗标题为「删除「」后接活码名称再接「」？」。说明写：二维码将在企业微信里失效，已印出的海报和台卡再扫就加不上了。已加进来的客户保留，这张码的添加次数统计会清空。
- 点「删除」。删除成功提示「已删除」。
> **注意**
>
> 渠道活码目前页面顶部标有警告「未对真实企业微信验证」。创建、二维码和「添加」的统计目前只在模拟器上验证过，没有对真实的企业微信跑过；上线前请先用一个测试企业走通一遍。
## 状态说明
### 客户阶段流转
客户档案在系统中的生命周期流转如下：
```
线索 ──(首次成交)──> 客户 ──(约 180 天无触点)──> 沉睡 ──(产生新触点唤醒)──> 客户
```
- **「线索」**：客户初始状态。通过表单留资、扫码添加企业微信、导入未验证号码等方式录入但尚未成交的档案。
- **「客户」**：正式成交客户。在 [会员](/apps/membership) 或 [订单](/apps/order) 等应用中完成首次购买成交后自动推进。
- **「沉睡」**：超过约 180 天没有任何业务往来记录（无触点）的客户。该状态由系统在读取数据时动态计算，不作为固定字段落库，组织无法修改判定天数。当沉睡客户产生新的往来互动时，系统会自动唤醒并恢复为「客户」状态。
### 身份识别与合并规则
- **确定性匹配**：客户中心仅根据已验证的统一标识进行确定性合并（已验证的相同手机号、微信 unionid、同作用域 openid 或同企业企业微信客户）。系统绝不按姓名模糊合并。
- **自动合并**：两端身份信息均已验证且完全对应时，系统自动执行合并。
- **合并建议**：若联系方式相同但尚未完全验证，或企业微信联系人未提供 unionid 且仅按员工备注手机号对上时，系统不会自动合并，而是生成合并建议卡片供人工核对。
- **不可拆分**：档案一旦合并，所有联系方式、标签、关联与时间线记录将统一归并至主档案，合并后无法拆分。
## 让助手帮你做
助手在客户应用中仅具备读取权限，无法绕过系统直接发起写入，无法直接导出客户数据，也无法查看完整手机号。助手可以通过提出 [动作](/agent/confirm) 或起草 [草稿](/agent/drafts)，经由你确认批准后，以你的身份执行。
你可以对助手说：
> 把张三的客户交给李四负责。
> 给这些客户打上 VIP 标签。
> 把这两个用了同一个手机号的档案合并。
> 登记张三电话里说退订短信营销。
> 按这份 CSV 导入客户（先检查再导入）。
> 新建一张「门店前台」渠道活码，扫码加前台员工。
### 助手操作与确认机制
| 操作内容 | 类别 | 风险级别 | 确认说明 |
|---|---|---|---|
| 「指定归属员工」 | 动作 | 高 | 确认后这位客户转给所选员工负责；原来的归属员工可能不再看得到他。 |
| 「打标签」 | 动作 | 低 | 无需额外确认，直接应用。 |
| 「去掉标签」 | 动作 | 低 | 无需额外确认，直接应用。 |
| 「批量打标签」 | 动作 | 低 | 无需额外确认（单次最多 200 位）。 |
| 「批量去掉标签」 | 动作 | 低 | 无需额外确认。 |
| 「批量指定归属」 | 动作 | 高 | 确认后所选客户都转给这位员工负责；原来的归属员工可能不再看得到他们。 |
| 「合并客户」 | 动作 | 高 | 合并后两个档案成为一个，不能再拆开。 |
| 「登记同意或退订」 | 动作 | 高 | 登记后作为客户本人同意或退订的凭据，只增不改；之后的群发按它检查。 |
| 「匿名化客户」 | 动作 | 高 | 匿名化后这位客户的姓名、手机号、微信等个人信息被永久销毁，不能恢复；同意记录全部撤回，与其他应用的关联解除。（执行前须再次验证身份） |
| 「导入客户」 | 动作 | 高 | 确认后按 CSV 新建或认出客户；标为已验证的号码可能让两个已有档案自动合并。 |
| 「新建标签」 | 草稿 | 低 | 无需额外确认。名称 1–40 字，默认颜色为灰。 |
| 「修改标签」 | 草稿 | 低 | 无需额外确认。需全部范围权限。 |
| 「删除标签」 | 删除 | 高 | 删除后所有客户身上的这个标签一并去掉，不能恢复。 |
| 「采纳合并建议」 | 动作 | 高 | 合并后两个档案成为一个，不能再拆开。 |
| 「忽略合并建议」 | 动作 | 低 | 无需额外确认。忽略后不再提示这一对。 |
| 「新建渠道活码」 | 草稿 | 低 | 无需额外确认。员工最多 100 位。 |
| 「删除渠道活码」 | 删除 | 高 | 删除后已经印出或发出的二维码立即失效，不能恢复。 |
## 设置
「客户」应用没有独立设置页。客户沉睡判定天数（固定约 180 天）、批量操作上限、导入文件限制等均为内置系统规则，不支持在组织端自定义修改。渠道活码所需的企业微信连接与客户联系 Secret 配置，请由组织管理员前往 [组织连接器](/admin/connectors) 进行配置。
## 注意事项
- **数量与规格限制**：
- 客户列表每页固定展示 30 位，排序固定为创建时间倒序，界面不支持修改排序。
- 批量操作单次最多处理 200 位客户。勾选仅对当前列表页有效，翻页或修改筛选条件会自动清空已选客户。
- CSV 导入单次最多支持 2000 行，文件大小不得超过 2 MB。
- 搜索框最多输入 40 字；界面标签名最多 20 字；渠道活码名称与渠道说明最多 60 字；同意来源说明最多 60 字。
- 渠道活码添加员工在界面中最多选择 20 位。
- 合并建议单次最多加载 100 条。
- **不可撤销操作**：
- 客户档案合并后不可撤销，无法拆分。
- 客户匿名化后不可逆，个人身份信息彻底清除，解除全部应用关联；原客户若再次登记将建立全新档案。
- 删除标签会从组织所有客户身上一并移除该标签，不可恢复。
- 删除渠道活码后，外部已印出或发出的二维码立即失效，不可恢复。
- 合并建议点击「不是同一个人」忽略后，系统永久不再提示该对档案。
- **数据范围与权限隔离**：
- 没有指派归属员工的客户，仅对拥有「查看客户」全部范围权限的成员可见。
- 变更客户归属员工后，若原负责人数据范围为「仅自己」，其将立即失去该客户的查看权限。
- 完整手机号查看与管理员导出完整手机号均会严格记录审计记录。
- **只读属性与追加原则**：
- 来源为企业微信或系统规则自动打上的标签属于只读标签，无法在客户应用中修改或删除。
- 客户往来时间线与同意退订记录遵循只增不改原则，历史记录不支持修改或删除。
- **环境验证说明**：
- 渠道活码界面明确标注「未对真实企业微信验证」，正式上线前请先在测试企业环境中走通流程。
## 目前不支持
- 在客户应用中直接新建客户档案，或手工编辑客户个人资料（如姓名、备注、手工添加身份项），没有「新建客户」按钮。新客户来自会员登记、站点表单、门店成交、数据导入或企业微信添加。
- 不支持为客户档案添加文字备注。
- 不支持拆分已合并的客户档案。
- 导入 CSV 文件不支持标签列与归属列；单次超过 2000 行需要拆分文件。
- 在「权益」区域查看具体券码，或直接进行权益核销与撤销（须在对应业务应用中操作）。
- 不支持自定义修改客户沉睡天数判定规则。
- 不支持客户人群分组、客户评分模型、自动化打标规则引擎、商机漏斗以及客户之间的家庭或企业关联关系。
- 本应用没有独立设置页。
## 常见问题
#### 为什么会员应用中新登记的客户在客户列表里找不到？
会员登记产生的客户档案初始通常未设置归属员工。系统规则规定，没有归属的客户仅对拥有「查看客户」全部数据范围权限的人员可见。普通成员由于数据范围仅限自己负责的客户，因此默认看不到无归属客户。需要由管理员在客户列表中为该客户指定归属员工后，对应员工才能在列表中查看到该客户。
#### 为什么我无法点击「查看完整号码」？
查看完整手机号需要满足两个条件：你的账号被授予了「编辑客户」权限，且该客户必须在你管辖的数据范围内（如归属于你本人或你所管辖的部门）。如果不满足上述条件，该按钮不可操作。此外，点击查看完整号码会产生审计记录，并在明文展示 60 秒后自动恢复脱敏。
#### 为什么导入客户时提示失败且一位都没有导入？
客户导入采用整份成功或整份不导原则。只要 CSV 文件中有一行存在数据问题（如缺少手机号或邮箱标识列、手机号格式不对——大陆 11 位或带国家码的号码、文件内出现重复号码等），整份文件都会被终止导入，不会导入任何数据。请根据校验报错提示的具体行号修正文件，重新点击「检查文件」确认无误后再次导入。
#### 为什么在客户详情中无法删除某些标签？
带有「来自企业微信」或「由规则自动打上」标识的标签属于外部或系统规则标签，在客户应用中为只读状态。这类标签无法在详情页手动移除，也无法在「管理标签」对话框中修改或删除，只能在其数据源头处处理。
#### 忽略了一条合并建议后，还能再次合并这两个客户吗？
在合并建议页点击「不是同一个人」后，系统会永久忽略这一对档案，不再在建议列表中展示。如果你后续确认两者确为同一个人，依然可以打开其中一位客户的详情页，在侧栏点击「合并另一个客户」，通过手动搜索找到另一位客户并执行合并。