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

# 上传联系人

> 联系人导入所需的 CSV 格式、校验规则和标签设置

## 本页可以帮助你做什么

导入联系人 CSV，让它们可以用于后续活动。你会了解必填列、格式校验、大小限制，以及如何在上传时统一打标签。

## 开始前

* 你需要一个 Nudgen 账号
* 准备一份至少包含 `email` 列的 CSV 文件
* 联系人数量不能超过当前套餐限制，详情可看[账单概览](/cn/billing/overview)

## 第一步：准备 CSV

CSV 至少需要以下列：

| 列名      | 是否必填 | 说明               |
| ------- | ---- | ---------------- |
| `email` | 是    | 有效的邮箱地址。建议保持唯一。  |
| `name`  | 否    | 联系人显示名称，用于个性化内容。 |

你也可以添加额外列，例如 `company`、`segment`。这些字段会被加密存储，可用于标签或后续分组逻辑。

## 第二步：确认格式

* **编码**：建议使用 UTF-8
* **分隔符**：使用英文逗号 `,`
* **表头行**：第一行必须是列名，`email` 和 `name` 不区分大小写
* **重复邮箱**：同一文件中的重复项会被合并；如果系统里已存在相同邮箱，原联系人会被更新

<Warning>
  无效邮箱地址，例如缺少 `@` 或格式错误的值，会被自动跳过。导入完成后，请查看上传摘要，确认成功导入和被跳过的行数。
</Warning>

## 第三步：上传到 Nudgen

1. 打开侧边栏中的 **联系人**
2. 点击 **上传 CSV**
3. 选择文件
4. 选择要统一应用给本次导入联系人的标签，例如 `inactive` 或 `re-engage`
5. 检查预览后确认上传

## 大小限制

* **文件大小**：以页面显示的上限为准，通常为数 MB。列表越大，处理时间也会越长。
* **每个工作区的联系人上限**：取决于你的套餐。超出上限时，上传会被拒绝。

当前限制请参考[账单概览](/cn/billing/overview)和实时[定价页面](https://nudgen.net/pricing)。

## 上传后会发生什么

* 联系人会出现在列表中，并默认显示为脱敏邮箱，例如 `j***@g***.com`
* 你可以在[创建活动](/cn/campaigns/create)时用标签进行分组投放
* 如有需要，你也可以在[联系人概览](/cn/contacts/overview)中临时显示真实信息

## 常见问题

<AccordionGroup>
  <Accordion title="有些行被跳过了">
    请检查这些行的 `email` 是否有效。空行或格式错误的邮箱地址不会被导入。
  </Accordion>

  <Accordion title="上传失败：超出套餐限制">
    你的联系人数量已经超出套餐上限。可以先升级套餐，或删除部分已有联系人后再上传。
  </Accordion>

  <Accordion title="系统没有识别列名">
    请确认首行包含 `email`（或 `Email`）。其他列可以是任意名称，但 `email` 必须存在。
  </Accordion>
</AccordionGroup>

## 相关文档

<CardGroup cols={2}>
  <Card title="联系人概览" icon="users" href="/cn/contacts/overview">
    了解加密、脱敏显示和分组方式。
  </Card>

  <Card title="创建活动" icon="paper-plane" href="/cn/campaigns/create">
    选择受众并发起活动。
  </Card>
</CardGroup>