# 从文件导入联系人

如果您在电子表格中有一份联系人列表，您可以一次性上传，而无需逐个添加。该应用程序使用一个 3 步向导 — **上传 → 映射列 → 检查** — 它适用于您现有的 CSV 文件，无需先下载模板。


---

## 如何导入联系人

1. 点击左侧边栏中的 **Contacts**（联系人），然后点击页面顶部的 **Import**（导入）。
2. **上传。** 将您的 CSV 文件拖放到放置区域，或点击该区域进行浏览。无需先下载模板 —— 直接使用您现有的文件即可。


3. **映射列。** 向导会读取您文件的标题行，并尝试自动将每一列匹配到目标字段：**名字、姓氏、电话、电子邮件、标签、备注**，或**不导入**。请检查每一列的猜测结果，并使用旁边的选择器纠正任何错误的匹配。预览表会显示前几行数据，即它们被导入后的样子。
   * **电话号码列是必需的** — 如果不映射此列，您将无法继续。
   * 映射到**标签**的列会成为每个联系人上的真实标签。一个单元格中包含多个标签是可以的 — 请使用逗号或分号（`vip; newsletter; hotmart`）分隔它们。尚不存在的标签会自动为您创建；已存在的标签会被复用，且忽略大小写。


4. **检查。** 选择：
   * **默认渠道** — WhatsApp Business、WhatsApp Web 或 SMS。这适用于任何尚未指定渠道的已导入联系人。
   * **列表** — 从下拉菜单中选择一个现有列表，或输入名称以立即创建一个新列表。您只能二选一，不能同时进行。
   * **更新现有联系人** — 默认关闭。关闭时，与您现有联系人匹配（电话号码相同）的行会被视为重复项而跳过：该联系人的任何信息都不会更改，且**不会**被添加到列表中。开启时，这些行会**更新**联系人：文件中的名字、电子邮件和备注会覆盖现有内容（空单元格保持当前值不变），行中的任何标签都会被添加，且联系人会被添加到您选择的列表中。这就是您重新导入文件以修复或丰富现有联系人的方式。


5. 点击**导入 [count]**。您将进入结果屏幕，显示已创建的联系人数量、已更新的现有联系人数量（当该选项开启时），以及如果跳过了任何行，还会显示原因细分（无效的电话号码、缺失电话号码、重复项、达到联系人上限等）。

---

## 列映射详情

* **电话**是唯一必需的列。没有电话号码的行会在导入前被丢弃，并在结果屏幕中单独统计。
* **名字 / 姓氏 / 电子邮件**直接映射到联系人的基本字段。
* **备注**映射到联系人的[备注 / 潜在客户资料](custom-contact-fields.md#notes-lead-profile)字段。
* **标签**会创建（或复用）真实标签并将其应用于联系人 — 这与您用于筛选、定位广播和触发 Webhook 的标签相同。在同一个单元格中放入多个标签，并用逗号或分号分隔。在 2026 年 8 月 19 日之前，此列被保存为名为 `tags` 的自定义字段；如果您在此日期之前导入过，请开启**更新现有联系人**并重新导入同一文件，标签即可正确应用（遗留的 `tags` 自定义字段不会造成影响；如果您希望将其从每个联系人中清除，请联系支持团队）。
* 目前没有针对任意自定义字段（如经典版的 `custom_<fieldname>` 列）的列映射 — 请参阅[批量加载自定义字段](custom-contact-fields.md#bulk-loading-custom-fields)了解当前的变通方法。

---

## 提示

- 请仔细检查电话号码是否包含国家/地区代码。如果没有，消息将无法送达 — 且没有可用电话号码的行会被完全跳过。
- 您无需从电话号码中去除空格、连字符或括号 — 导入程序可以兼容常见的格式，但仍需要国家/地区代码。
- 文件完全在您的浏览器中解析，因此向导本身没有固定的上传大小限制 — 但您的总联系人数量仍受限于您的套餐。如果导入会导致超出套餐限制，这些行将被拒绝，并在结果屏幕中显示为 `contact_limit_reached`。
- 如果具有相同电话号码的联系人已存在，该行默认会被跳过 — 它会在结果屏幕上显示为 `duplicate`。导入操作永远不会创建重复的联系人。要批量编辑您已有的联系人（修复名字或电子邮件、添加标签、将其放入列表），请在“检查”步骤中开启**更新现有联系人**并重新导入文件。

---

## 常见问题解答

**我的 CSV 包含一个来自旧导出的 `custom_company` 列 —— 它能正确映射吗？**
不能自动映射。向导的自动匹配器仅识别 name/phone/email/tags/notes 标题；其他任何内容都会默认为 **Don't import**（不导入），因此 `custom_company` 列不会自动填充 `company` 自定义字段。请通过 [Custom Fields](custom-contact-fields.md)（自定义字段）或 API 在之后添加这些值。

**“下载模板”按钮去哪了？**
它已被移除——向导现在可以直接处理您现有的任何 CSV 文件，并允许您在“映射”步骤中修复任何不匹配的列。

**我已经导入了联系人 — 如何一次性为他们所有人添加标签或修复字段？**
在“检查”步骤中开启**更新现有联系人**，然后重新导入相同的文件（或更新后的文件）。与现有电话号码匹配的行会更新该联系人 — 名字、电子邮件、备注、标签和列表 — 而不是被跳过。系统仅使用电话号码进行匹配，因此请保持该列与之前完全一致。

**我可以从文件中导入 Instagram 或 Messenger 联系人吗？**
不可以。导入功能仅支持 WhatsApp Business、WhatsApp Web 和短信，因为这些渠道是通过电话号码联系用户的。Instagram 和 Messenger 则是通过社交账号识别用户，因此当有人在这些渠道给您发送消息时，联系人会自动创建。

**我可以将联系人导入为“机器人不活跃”状态吗？**
没有针对单行的列设置。请先导入批次，然后对导入的联系人使用批量**关闭机器人**操作——请参阅[将联系人排除在 AI 机器人之外](excluding-contacts-from-bot.md)。

---

## 后续步骤

- [组织列表与联系人](list-and-contact-management.md) — 管理并排序您新导入的联系人。
- [从营销活动迁移到广播与代理](../moving-from-campaigns.md) — 开始向您导入的列表发送消息。
- [自定义字段、潜在客户资料与备注](custom-contact-fields.md) — 在导入后填充更丰富的信息。