从文件导入联系人
如果您在电子表格中有一份联系人列表，您可以一次性上传，而无需逐个添加。该应用程序使用一个 3 步向导 — 上传 → 映射列 → 检查 — 它适用于您现有的 CSV 文件，无需先下载模板。
如何导入联系人
- 点击左侧边栏中的 Contacts（联系人），然后点击页面顶部的 Import（导入）。
- 上传。 将您的 CSV 文件拖放到放置区域，或点击该区域进行浏览。无需先下载模板 —— 直接使用您现有的文件即可。
- 映射列。 向导会读取您文件的标题行，并尝试自动将每一列匹配到目标字段：名字、姓氏、电话、电子邮件、标签、备注，或不导入。请检查每一列的猜测结果，并使用旁边的选择器纠正任何错误的匹配。预览表会显示前几行数据，即它们被导入后的样子。
- 电话号码列是必需的 — 如果不映射此列，您将无法继续。
- 映射到标签的列会成为每个联系人上的真实标签。一个单元格中包含多个标签是可以的 — 请使用逗号或分号（
vip; newsletter; hotmart）分隔它们。尚不存在的标签会自动为您创建；已存在的标签会被复用，且忽略大小写。
- 检查。 选择：
- 默认渠道 — WhatsApp Business、WhatsApp Web 或 SMS。这适用于任何尚未指定渠道的已导入联系人。
- 列表 — 从下拉菜单中选择一个现有列表，或输入名称以立即创建一个新列表。您只能二选一，不能同时进行。
- 更新现有联系人 — 默认关闭。关闭时，与您现有联系人匹配（电话号码相同）的行会被视为重复项而跳过：该联系人的任何信息都不会更改，且不会被添加到列表中。开启时，这些行会更新联系人：文件中的名字、电子邮件和备注会覆盖现有内容（空单元格保持当前值不变），行中的任何标签都会被添加，且联系人会被添加到您选择的列表中。这就是您重新导入文件以修复或丰富现有联系人的方式。
- 点击导入 [count]。您将进入结果屏幕，显示已创建的联系人数量、已更新的现有联系人数量（当该选项开启时），以及如果跳过了任何行，还会显示原因细分（无效的电话号码、缺失电话号码、重复项、达到联系人上限等）。
列映射详情
- 电话是唯一必需的列。没有电话号码的行会在导入前被丢弃，并在结果屏幕中单独统计。
- 名字 / 姓氏 / 电子邮件直接映射到联系人的基本字段。
- 备注映射到联系人的备注 / 潜在客户资料字段。
- 标签会创建（或复用）真实标签并将其应用于联系人 — 这与您用于筛选、定位广播和触发 Webhook 的标签相同。在同一个单元格中放入多个标签，并用逗号或分号分隔。在 2026 年 8 月 19 日之前，此列被保存为名为
tags的自定义字段；如果您在此日期之前导入过，请开启更新现有联系人并重新导入同一文件，标签即可正确应用（遗留的tags自定义字段不会造成影响；如果您希望将其从每个联系人中清除，请联系支持团队）。 - 目前没有针对任意自定义字段（如经典版的
custom_<fieldname>列）的列映射 — 请参阅批量加载自定义字段了解当前的变通方法。
提示
- 请仔细检查电话号码是否包含国家/地区代码。如果没有，消息将无法送达 — 且没有可用电话号码的行会被完全跳过。
- 您无需从电话号码中去除空格、连字符或括号 — 导入程序可以兼容常见的格式，但仍需要国家/地区代码。
- 文件完全在您的浏览器中解析，因此向导本身没有固定的上传大小限制 — 但您的总联系人数量仍受限于您的套餐。如果导入会导致超出套餐限制，这些行将被拒绝，并在结果屏幕中显示为
contact_limit_reached。 - 如果具有相同电话号码的联系人已存在，该行默认会被跳过 — 它会在结果屏幕上显示为
duplicate。导入操作永远不会创建重复的联系人。要批量编辑您已有的联系人（修复名字或电子邮件、添加标签、将其放入列表），请在“检查”步骤中开启更新现有联系人并重新导入文件。
常见问题解答
我的 CSV 包含一个来自旧导出的 custom_company 列 —— 它能正确映射吗？
不能自动映射。向导的自动匹配器仅识别 name/phone/email/tags/notes 标题；其他任何内容都会默认为 Don’t import（不导入），因此 custom_company 列不会自动填充 company 自定义字段。请通过 Custom Fields（自定义字段）或 API 在之后添加这些值。
“下载模板”按钮去哪了？ 它已被移除——向导现在可以直接处理您现有的任何 CSV 文件，并允许您在“映射”步骤中修复任何不匹配的列。
我已经导入了联系人 — 如何一次性为他们所有人添加标签或修复字段？ 在“检查”步骤中开启更新现有联系人，然后重新导入相同的文件（或更新后的文件）。与现有电话号码匹配的行会更新该联系人 — 名字、电子邮件、备注、标签和列表 — 而不是被跳过。系统仅使用电话号码进行匹配，因此请保持该列与之前完全一致。
我可以从文件中导入 Instagram 或 Messenger 联系人吗？ 不可以。导入功能仅支持 WhatsApp Business、WhatsApp Web 和短信，因为这些渠道是通过电话号码联系用户的。Instagram 和 Messenger 则是通过社交账号识别用户，因此当有人在这些渠道给您发送消息时，联系人会自动创建。
我可以将联系人导入为“机器人不活跃”状态吗？ 没有针对单行的列设置。请先导入批次，然后对导入的联系人使用批量关闭机器人操作——请参阅将联系人排除在 AI 机器人之外。
后续步骤
- 组织列表与联系人 — 管理并排序您新导入的联系人。
- 从营销活动迁移到广播与代理 — 开始向您导入的列表发送消息。
- 自定义字段、潜在客户资料与备注 — 在导入后填充更丰富的信息。