外观
客户列表
入口：左侧菜单 运营 → 客户列表
这里是企业微信客户的全量视图：一个客户一行（同一客户被多名员工添加会出现多行关系记录），支持多条件圈人、批量打标签，并下钻到单个客户的完整画像。所有群发、活码、自动打标效果的最终落点都是这张表。
前置条件
| 条件 | 不满足时的表现 |
|---|---|
| 已选择企业微信主体 | 顶部提示「尚未选择企业微信主体」，说明客户数据按主体隔离 |
| 已同步客户数据 | 列表显示「暂无客户数据 / 同步客户后将在此显示」 |
| 标签已创建 | 标签筛选与批量打标签时选不到，先到标签管理 |
| 企业微信开放数据就绪 | 昵称与成员名显示为占位或 ID，通常稍后刷新或重新登录恢复 |
筛选区
| 筛选项 | 控件与占位文案 | 说明 |
|---|---|---|
| 客户昵称/备注 | 输入框「请输入客户昵称或备注」 | 模糊匹配，客户名与员工给的备注都命中 |
| 所属企微成员 | 成员选择器 | 只看某名员工名下的客户 |
| 包含标签 | 标签选择器「请选择包含任一标签」 | 命中任意一个标签即入结果 |
| 不包含标签 | 标签选择器「请选择需要排除的标签」 | 命中任一标签即被排除，优先于「包含标签」 |
| 首次添加时间 | 日期范围 | 按客户首次添加该员工的时间过滤 |
| 添加渠道 | 下拉「请选择添加渠道」 | 对应企业微信的客户来源，见下方对照表 |
| 操作 | 搜索 / 重置 | 未修改条件时「重置」置灰 |
标签筛选项加载失败时提示「标签筛选项加载失败，请重试」，点该区域的 重试 单独重载标签树，不影响已输入的其他条件。
结果表
| 区域 | 内容 |
|---|---|
| 计数 | 「客户列表 · 共 N 名客户」 |
| 选择 | 行首复选框，选中后工具栏显示「已选择 N 项」 |
| 批量操作 | 批量打标签、批量移除标签（未勾选客户时不可用） |
| 同步 | 同步客户（进行中显示「同步中」）、刷新 |
| 同步状态 | 未选主体「选择企微主体后可查询和同步客户」；进行中「企业微信正在同步客户，请稍候刷新」；正常「最近同步：…」；从未同步「尚未同步客户数据」 |
| 表格列 | 昵称、备注、所属企微成员、企业标签、首次添加时间、添加渠道、操作 |
| 流失标记 | 昵称旁的红色 已流失 标签 = 该客户已删除员工（或员工已不可达） |
| 行内操作 | 添加企业标签、移除企业标签、查看客户详情 |
| 空态 | 「暂无客户数据」/「请先选择企微主体」；有筛选时「调整筛选条件后再试」 |
| 失败态 | 错误说明 + 重试（「客户加载失败，请稍后重试」） |
打标签弹窗标题随动作变化：选择要添加的企业标签 / 选择要移除的企业标签；未选标签时提示「请至少选择一个企业标签」，成功提示「已更新 N 位客户的企业标签」，失败「客户标签更新失败，请稍后重试」。
批量标签作用于「关系」而不是「人」
同一个客户被 3 名员工添加，会出现 3 行。批量打标签只修改你勾选的那几行所属的员工-客户关系，需要全量覆盖时请用筛选把该客户的所有关系行都选中。
添加渠道对照
「添加渠道」由企业微信在客户与员工成为好友的那一刻自动判定来源，列表与详情都显示为下面的文案，可用来做来源分析与筛选：
- 主动添加：扫描二维码、搜索手机号、名片分享、群聊、手机通讯录、微信联系人、搜索邮箱；
- 内容与场景添加：视频号添加、通过获客链接添加、通过日程参与人添加、通过会议参与人添加、通过需求回复添加、通过可能的商务伙伴添加；
- 客服与系统添加：安装第三方应用时自动添加的客服人员、通过上门服务客服添加、通过定制开发添加、通过第三方售前客服添加、通过智慧硬件专属客服添加、通过接受微信账号收到的好友申请添加、添加微信好友对应的企业微信；
- 未知来源。
其中界面显示为「内部成员共享」「管理员/负责人分配」的，属于内部转移（客户继承、分配）产生的关系，不代表一次真实获客，做渠道 ROI 时应剔除。
客户详情
点行内详情图标进入 客户详情，顶部 返回客户列表 / 刷新（成功提示「客户详情已刷新」）。
客户基础信息
标题栏说明「客户身份、添加关系与企业标签」，展示：客户名（无名时「未命名客户」）、客户 ID（企业微信分配的唯一编号）、所属企微成员，以及字段：
| 字段 | 说明 |
|---|---|
| 备注名 | 员工在企微侧为该客户设置的备注 |
| 性别 | 客户微信资料性别，未授权时为空 |
| 添加来源 | 即上方「添加渠道对照」里的来源 |
| 添加时间 | 该关系首次建立的时间 |
| 流失时间 | 客户删除员工的时间，存在时同时显示 已流失 标签 |
| 客户描述 | 员工填写的描述内容，可能为空 |
企业标签
小标题「企业标签 · 标签变更将同步到当前所属成员关系」，展示当前标签，右上 重新选择。按钮不可用的几种原因会直接显示在提示里：
| 提示 | 含义与处理 |
|---|---|
| 企业标签正在加载 | 等待本次加载完成 |
| 请先重新加载企业标签 | 标签树加载失败（「企业标签加载失败，请稍后重试」），点 重试 |
| 存在无法安全解析的已有标签 | 已有标签中有些无法对应到标签库（缺数据或同名），为避免误覆盖而禁止重新选择，需先清理标签数据 |
更新成功后提示「客户企业标签已更新」，失败「客户标签更新失败，请稍后重试」。
客户动态
时间线形式展示该客户的状态变更记录：标题「客户动态 · 共 N 条记录」，每条含日期（无时间时「时间未知」）与描述（没有描述时显示「客户状态已更新」）；为空时「暂无客户动态」；加载失败「客户动态加载失败，请稍后重试」+ 重试。
同步与刷新
| 动作 | 是否向企业微信拉取新数据 | 结果提示 |
|---|---|---|
| 同步客户 | 是（后台处理，可能排队） | 成功「同步成功」；失败「客户同步失败，请稍后重试」 |
| 刷新 | 否，只重读系统数据 | 成功「客户数据已刷新」 |
客户数突然少了
先看是不是换了企业微信主体，再看是不是员工删除了客户（今日删除客户指标）或客户已流失。确认无误后点 同步客户 拉一次，而不是反复刷新。
注意事项
- 客户手机号、微信号、会话内容属于敏感信息，本页不展示手机号；截图或导出时请按公司制度处理。
- 列表默认分页加载，不要把当前页的数量当成客户总量，总量看「共 N 名客户」。
- 删除客户、客户转移/继承类高风险操作不在本页执行，需在企业微信侧或按公司流程处理，并保留操作留痕。
- 客户标签变更会影响自动打标与后续群发推送 的人群范围，改前先想清楚影响面。