# 导入、导出及新增联系人

您可以通过在“**联络人”>“动作**”页面上的三个主要操作来管理目录中的联系人：

1. 新增联络人 
2. 汇入联络人 (CSV) 
3. 汇出联络人 (CSV) 

<figure><img src="/files/MOLVAcln27UZCInapscX" alt=""><figcaption></figcaption></figure>

## 新增单个联络人

<figure><img src="/files/ZiGT7x3YVE4y3b4Hd4nO" alt="" width="232"><figcaption></figcaption></figure>

如只需要新增单个联系人，点击"新增"键后只需填上姓名和加上区号等电话号码即可新增。

## 导入联系人

<figure><img src="/files/qyvfP9oas52a7hHocqfP" alt="" width="375"><figcaption></figcaption></figure>

点击导入键后，你首先需要下载模板文件参考导入联络人的格式，请在文件中填写姓名和联络人号码两列。

电话号码需要连同国际区号填写，例如国际区号是852，电话是12345678，则需填上85212345678。保存联络人列表后，你便可以把该 csv 文档拖曳到上传的区域。你可以选择为联络人列表命名，也可以留空，留空的话清单名称会附有日期和上传时间。最后点击导入并等候上传完成即可。

如果您导入的联络人列表中包含一些已存在的电话号码，则名字、姓氏、电子邮件和自定义字段将会被更新。在导入并更新已存在相同电话号码的联络人信息时，不会创建额外的联络人。

***

通过 CSV 文件导入联系人时，您可以设置 **标签策略** 与 **自定义字段策略**，以控制系统如何处理现有联系人的数据。

这可以帮助您决定是覆盖、合并还是保留已有信息。

<figure><img src="/files/htGeASYhFzB1mONxvHLd" alt="" width="375"><figcaption></figcaption></figure>

### 标签策略

选择 CSV 文件中的标签如何应用到已存在的联系人。

#### 1.替换现有标签

**功能说明：**

* 移除联系人当前的所有标签。
* 仅保留导入文件中提供的标签。

**适用场景：**

* 需要重新整理标签结构。
* 希望以导入文件为最新标签标准。
* 需要清除旧标签。

**示例：**

* 原有标签：`VIP`、`批发客户`
* CSV 标签：`零售`
* 导入结果：`零售`（VIP、批发客户将被移除）

***

#### 2.添加到现有标签

**功能说明：**

* 保留现有标签。
* 将 CSV 中的标签添加到联系人。
* 系统不会创建重复标签。

**适用场景：**

* 进行营销分群标记。
* 不影响历史标签。
* 逐步补充标签数据。

**示例：**

* 原有标签：`VIP`
* CSV 标签：`夏季活动`
* 导入结果：`VIP`、`夏季活动`

### 自定义字段策略

自定义字段将按照以下规则处理：

**默认规则：**

* 保留现有字段数据。
* 若 CSV 中提供该字段的值，则更新该字段。

您可以设置当导入文件中的字段为空时，系统如何处理。

***

#### 当导入值为空时：

**1.忽略 — 保留当前的数值**

**功能说明：**

* 如果 CSV 字段为空，系统将保留现有数据。
* 不进行任何修改。

**适用场景：**

* 仅更新部分字段。
* 导入文件数据不完整。
* 避免误删除重要数据。

**示例：**

* 原有电话：`+852 91234567`
* CSV 电话字段：空
* 导入结果：电话保持不变

***

**2.移除旧数值 — 清除现有的数值**

**功能说明：**

* 如果 CSV 字段为空，系统将清除现有数据。
* 该字段将变为空。

**适用场景：**

* 进行数据清理。
* 需要明确删除过期信息。
* 将 CSV 作为唯一数据来源。

**示例：**

* 原有公司名称：`ABC Ltd`
* CSV 公司名称字段：空
* 导入结果：公司名称被清除

## 导出联系人

如果您要导出所有联络人，只需点击 **动作>汇出联络人(CSV)** 即可。

<figure><img src="/files/90vP3DT7utpSXaMr8lBR" alt="" width="349"><figcaption></figcaption></figure>

如果您只想导出带有特定标签或在特定时间范围内添加标签的联系人，请按照以下步骤操作：

<figure><img src="/files/1lWY6Vk8LyFNZSR0JoHv" alt=""><figcaption></figcaption></figure>

首先，点击 **「筛选」** 展开下拉菜单，选择要筛选的标签和设定标签添加的时间范围。联系人列表将刷新，仅显示带有所选标签的联系人。然后，点击 **动作>汇出联络人(CSV)** 。下载的文件将是筛选后的联系人列表。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chatalog.ai/zh-cn/contact-setup/contact/import-export-add-contact.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.