从文件导入联系人 #

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

如何导入联系人 #

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

3. 映射列。 向导会读取您文件的标题行，并尝试将每一列自动匹配到目标字段：名字、姓氏、电话、电子邮件、标签、备注、您的任何自定义字段，或者不导入。请检查每一列的猜测结果，并使用旁边的选择器更正任何错误的匹配。预览表会显示前几行数据导入后的确切样子。
   • 如果某一列的标题与您的某个自定义字段名称相同，它会自动匹配到该字段。大小写和重音符号不影响匹配，因此 CPF 列可以找到名为 cpf 的字段。您也可以手动为任何列选择任何自定义字段。
   • 如果某一列尚不是您的自定义字段，它可以变为自定义字段：在选择器中选择 新建自定义字段：，该字段将在您导入时创建。
   • 如果某个自定义字段具有类型（数字、复选框、下拉菜单），而该列中的某些值不符合该类型，向导会在导入前警告您受影响的行数。这些行将被整体跳过，包括姓名和电子邮件。点击警告上的 将 切换为文本 可一步更改字段类型，或者您可以修复这些值，或将该列设置为 不导入。
   • 电话号码列是必需的 —— 如果不映射该列，您将无法继续。
   • 映射到 标签 的列会成为每个联系人上的真实标签。一个单元格中包含多个标签是可以的 —— 请使用逗号或分号 (vip; newsletter; hotmart) 分隔它们。尚不存在的标签会自动为您创建；已存在的标签会被复用，且不区分大小写。

4. 检查。 选择：
   • 默认渠道 — WhatsApp Business、WhatsApp Web 或 SMS。这适用于任何尚未指定渠道的导入联系人。
   • 列表 — 从下拉菜单中选择一个现有列表，或输入名称以立即创建一个新列表。您只能二选一，不能同时进行。如果您在“联系人”页面显示某个列表时打开导入功能，该列表将自动为您选中；如果您不需要，请清除它。
   • 更新现有联系人 — 默认关闭。关闭时，与您现有联系人匹配（电话号码相同）的行将作为重复项跳过：该联系人的任何信息都不会更改，但如果您选择了列表，您现有的联系人仍会加入该列表。开启时，这些行将更新联系人：文件中的姓名、电子邮件和备注将覆盖现有内容（空单元格将保留当前值），行中的任何标签都将被添加，并且联系人将被添加到您选择的列表中。这就是您重新导入文件以修复或丰富现有联系人的方式。

5. 点击 导入 [count]。您将进入结果屏幕，显示创建了多少联系人、更新了多少现有联系人（当该选项开启时）、您已有的多少联系人被添加到了您选择的列表中，以及如果跳过了某些行，还会显示跳过的原因（无效电话号码、缺少电话号码、重复、达到联系人上限等）。如果 更新现有联系人 选项处于关闭状态，且某些行与您已有的联系人匹配，结果屏幕会提示这一点，并提供 更新这些联系人 选项：只需点击一次即可在开启该开关的情况下重新发送这些行，因此您无需再次导入文件。

列映射详情 #

• 电话是唯一必填的列。没有电话号码的行会在导入前被丢弃，并在结果屏幕中单独统计。
• 名字 / 姓氏 / 电子邮件直接映射到联系人的基本字段。
• 备注映射到联系人的备注 / 潜在客户资料字段。
• 标签会创建（或复用）实际的标签并将其应用于联系人——这与您用于筛选、定位广播以及触发 Webhook 的标签相同。在同一个单元格中用逗号或分号分隔多个标签。在 2026 年 8 月 19 日之前，此列被保存为名为 tags 的自定义字段；如果您在此日期之前导入过，请开启更新现有联系人并重新导入同一文件，标签即可正确应用（残留的 tags 自定义字段不会造成任何影响；如果您希望将其从所有联系人中清除，请联系支持团队）。
• 自定义字段——您的每个自定义字段都有其对应的目标。系统会自动为您选择与字段名称匹配的标题；值会按照文件中的原样保存到联系人中（数字、日期、复选框或下拉菜单字段会转换可识别的格式，如 19,99、01/02/1990 或 yes）。选择新建自定义字段可根据列创建字段。开启更新现有联系人后，文件中的自定义字段值也会更新您已有的联系人；空单元格则不会更改当前值。
• 包含带有圆点、连字符或前导零的标识符（如 CPF、税号、邮政编码）的列应放入文本字段。在数字字段中，这些值无法匹配，该行将被跳过。

提示 #

• 请仔细检查电话号码是否包含国家/地区代码。如果没有，消息将无法送达 — 且没有可用电话号码的行将被完全跳过。
• 您无需从电话号码中删除空格、破折号或括号 — 导入程序可以兼容常见的格式，但仍需要国家/地区代码。
• 文件完全在您的浏览器中解析，因此向导本身没有固定的上传大小限制 — 但您的联系人总数仍受限于您的套餐。如果导入会导致您超出套餐限制，这些行将被拒绝，并显示在结果屏幕的 contact_limit_reached 中。
• 如果具有相同电话号码的联系人已存在，该行默认会被跳过 — 它会显示在结果屏幕的 duplicate 中。导入操作永远不会创建重复的联系人。为这些行选择列表仍然有效：您已有的联系人会被添加到列表中，并在结果屏幕上单独计数，因此重新导入同一个文件是向列表中填充已有账户联系人的方法。若要同时刷新他们的字段（修复姓名或电子邮件、添加标签），请在“检查”步骤中开启 更新现有联系人 并重新导入文件。

常见问题解答 #

我的 CSV 文件中有一个来自旧导出的 custom_company 列 — 它能正确映射吗？ 不能自动映射，因为标题不完全是 company。请在该列的选择器中选择 自定义字段：company，它就会导入到 company 字段中。在上传前将标题重命名为 company，向导就会为您自动匹配。

有些行被跳过，提示“自定义字段值不符合该字段类型” —— 为什么？ 该列被映射到了一个有类型的自定义字段（例如“数字”），而这些行中包含其他内容，例如在“数字”字段中包含 001.576.401-08。请在“映射列”步骤中点击警告上的 将 切换为文本（或在“自定义字段”下更改类型），并在开启 更新现有联系人 的情况下再次导入文件。

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

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

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

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

后续步骤 #

• 组织列表与联系人 — 管理并排序您新导入的联系人。
• 从营销活动迁移到广播与代理 — 开始向您导入的列表发送消息。
• 自定义字段、潜在客户资料与备注 — 在导入后填充更丰富的信息。