> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 客户管理：个人资料、导入与配置

> 在 AgencyHandy 中创建和导入客户档案、跟踪订单和发票、管理门户访问权限，并使用类别对客户进行分类。

AgencyHandy CRM 的客户部分是您管理所有已通过潜在客户阶段的组织或个人的集中枢纽。在这里，您可以手动或批量创建客户档案，保持联系信息的及时更新，跟踪近期订单和发票，将客户分入自定义类别，并监控门户访问情况——所有操作均在一个列表视图中完成。

<Note>
  您需要**超级管理员**或**管理员**角色才能创建、编辑、导入或配置客户档案。经理可以查看客户详情和活动日志。
</Note>

## 创建客户档案

当您引入新客户时，AgencyHandy 会为其创建一个门户账户，并发送安全的登录邀请。

<Steps>
  <Step title="导航至客户">
    登录您的 AgencyHandy 账户，然后点击左侧边栏中的 **CRM**，选择**客户**标签页。
  </Step>

  <Step title="打开创建表单">
    点击右上角的 **+ 创建客户**，将弹出一个表单。
  </Step>

  <Step title="输入客户信息">
    填写客户的详细信息：

    * **名 / 姓**（*必填*）
    * **邮箱**（*必填——用于发送门户邀请*）
    * **公司名称**
    * **电话号码**
    * **国家、州/省、城市、邮政编码**
    * **类别**——如适用，分配一个现有的配置类别
  </Step>

  <Step title="保存档案">
    点击**创建**。档案将立即添加到您的客户列表中。
  </Step>
</Steps>

<Note>
  创建档案后，客户将收到一封包含安全登录 URL 的邮件。点击该 URL 即可激活其门户账户并首次登录。
</Note>

## 从 CSV 导入客户

如果您正在从其他平台迁移，或拥有现有客户的电子表格，可以一次性批量导入。

<Steps>
  <Step title="点击导入">
    在客户列表中，点击右上角的**导入**按钮。
  </Step>

  <Step title="上传 CSV 文件">
    将文件拖放到上传区域，或点击浏览并选择文件。AgencyHandy 接受包含以下字段的 CSV 文件：

    * 客户姓名（*必填*）
    * 邮箱（*必填*）
    * 公司名称
    * 国家
    * 州/省
    * 城市
    * 邮政编码
  </Step>

  <Step title="映射列">
    AgencyHandy 会自动检测与其字段名称匹配的列名。对于未匹配的列，请使用下拉菜单手动将其映射到正确的系统字段。
  </Step>

  <Step title="预览并确认">
    查看预览表格，在数据保存之前检查是否存在格式问题。
  </Step>

  <Step title="完成导入">
    点击**保存**。所有记录成功导入后，将显示确认消息。
  </Step>
</Steps>

<Tip>
  如果您的电子表格列标题与 AgencyHandy 的字段名称完全匹配（例如"email"、"company name"），映射器将自动填充——无需手动匹配。
</Tip>

## 导出客户

将客户数据库导出为 CSV 或 Excel，以便备份或与相关方共享。

<Steps>
  <Step title="点击导出">
    在客户列表中，点击右上角的**导出**按钮。
  </Step>

  <Step title="自定义导出内容">
    选择要包含的列——选择**所有列**进行完整导出，或选择特定字段，例如姓名、联系方式、公司或地址。
  </Step>

  <Step title="选择格式">
    根据您的使用需求选择 **CSV** 或 **XLSX**。
  </Step>

  <Step title="下载文件">
    点击**导出**。文件生成后将下载到您的设备。请妥善保管，以保护客户数据。
  </Step>
</Steps>

## 编辑客户档案

<Steps>
  <Step title="选择客户">
    在客户列表中，勾选您要更新的客户旁边的复选框，或直接点击其姓名打开档案。
  </Step>

  <Step title="进入编辑模式">
    点击客户档案右上角的**编辑**按钮，将弹出编辑表单。
  </Step>

  <Step title="更新信息">
    修改任意字段——姓名、邮箱、电话、地址、公司或类别。
  </Step>

  <Step title="保存更改">
    点击**更新**。确认消息将提示档案已成功保存。
  </Step>
</Steps>

## 搜索、排序和筛选

客户列表提供多种工具，帮助您快速找到目标客户：

<CardGroup cols={2}>
  <Card title="按姓名搜索" icon="magnifying-glass">
    在搜索栏中输入客户姓名，即可立即筛选列表。
  </Card>

  <Card title="按公司筛选" icon="building">
    将列表缩小至与特定公司关联的客户。
  </Card>

  <Card title="按邮箱筛选" icon="envelope">
    在知道客户邮箱但不记得姓名时快速定位。
  </Card>

  <Card title="按状态筛选" icon="circle-check">
    仅显示活跃、停用或已邀请的客户。
  </Card>

  <Card title="按字母排序" icon="arrow-down-a-z">
    按姓名将完整客户列表进行 A–Z 或 Z–A 排序，便于快速查找。
  </Card>

  <Card title="按类别筛选" icon="tag">
    仅显示分配到特定配置类别的客户。
  </Card>
</CardGroup>

## 跟踪客户活动

在每位客户的档案中，您将看到多个标签页，为您呈现该客户与您机构互动情况的实时概览：

<Accordion title="近期订单">
  查看客户下达的所有订单历史，包括服务名称、套餐、状态和日期。无需离开 CRM，即可快速了解其购买历史。
</Accordion>

<Accordion title="近期工单">
  查看客户提交的所有支持或服务工单。使用此视图优先处理响应，确保没有请求被遗漏。
</Accordion>

<Accordion title="近期发票">
  访问为客户生成的所有发票记录，包括付款状态。帮助您在一处监控未付余额和发票历史。
</Accordion>

## 客户配置（类别）

客户配置允许您创建带颜色的类别，对客户列表进行分类——例如：*高优先级*、*长期合同*或*暂停*。类别将作为客户列表的筛选选项出现，让您可以立即筛选出目标群体。

<Steps>
  <Step title="打开配置">
    在客户部分，点击**配置**按钮。
  </Step>

  <Step title="创建新类别">
    点击 **+ 创建类别**。
  </Step>

  <Step title="输入类别详情">
    * **类别名称**——唯一的描述性标签（例如：*企业客户*）
    * **简短描述**——简要说明该类别的用途
    * **颜色**——选择一种易于识别的独特颜色
  </Step>

  <Step title="保存类别">
    点击**创建**。该类别现在可在编辑客户档案时进行分配。
  </Step>

  <Step title="将客户分配到类别">
    打开任意客户档案，点击**编辑**，选择**类别**字段，然后选择相关类别。点击**更新**保存。
  </Step>
</Steps>

<Tip>
  在各类别中使用一致的颜色规范——例如，红色表示高优先级客户，绿色表示已完全引入的账户——使列表一目了然。
</Tip>

## 客户活动日志

活动日志记录客户门户账户的每一次登录和退出事件，为您提供清晰的参与度审计记录。

**查看日志的方法：**

1. 前往**客户**，打开特定客户的档案。
2. 点击档案顶部导航栏中的**活动日志**标签页。
3. 查看按时间顺序排列的身份验证事件列表。

**日志显示以下内容：**

* 每次**登录**的精确日期和时间戳
* 每次**退出**的精确日期和时间戳
* 所有身份验证事件的完整历史记录

日志实时更新，无法编辑或删除。客户无法访问自己的活动日志——它仅供管理员和合规审查使用。

<Note>
  目前，活动日志仅记录身份验证事件（登录和退出）。在门户中执行的操作（例如查看订单）暂时不在此处记录。
</Note>

## 向客户发送邮件

您可以直接从客户档案发送邮件，无需离开 AgencyHandy。打开客户档案，使用**邮件**选项撰写消息。**收件人**字段将预填为客户的邮箱地址。

## 客户模拟登录

管理员可以模拟客户账户，看到客户在其门户中看到的完全相同内容——这在排查访问问题或在支持通话中引导客户操作时非常有用。在客户档案内查找**模拟登录**选项。

<Warning>
  模拟登录仅供支持目的使用。模拟客户期间执行的任何操作均代表客户完成，并将反映在其账户中。
</Warning>

## 公司账户（B2B）

如果您的客户是企业而非个人，可以在任意客户档案上设置**公司名称**，将联系人归属于同一组织。客户列表可按公司筛选，便于一次查看某个账户的所有联系人。
