从 Google Sheets 同步潜在客户

将 Google 表格连接到 ABC Sales AI，每一个新增的行都会自动变成一条潜在客户记录。不需要粘贴任何脚本，也不需要手动复制，只要链接表格、映射列，就完成了。新行会在几秒内导入。

开始之前

请准备好以下内容：

• 一个能打开该电子表格的 Google 账号。
• 一个带有标题行（写着各列标题的那一行）的电子表格。
• 至少有一个电话号码或邮箱列，一行必须有其中之一才能变成潜在客户。
• 一个空白的备用列，用作"状态"列（我们会把每一行的导入结果写在那里）。

1. 连接你的 Google 表格

1. 前往集成 → Google Sheets。
2. 点击连接 Google 并登录。我们只会请求访问你选择的那一个文件，不会访问你的整个 Google Drive。
3. 使用选择器选中你的电子表格。
4. 选择存放潜在客户的工作表标签（例如 Sheet1）。

2. 告诉我们你的表格结构

• 标题行：哪一行是你的列标题。你的数据应从它的下一行开始。
• 状态列：选一个空白列，让我们把导入结果写进去（详见下文）。不要选已经有数据的列。

3. 映射你的列

把每一列映射到潜在客户字段，告诉我们它代表什么：

• 电话：潜在客户的电话号码，用于避免重复。
• 邮箱：潜在客户的邮箱地址。
• 姓名：在收件箱中显示的潜在客户姓名。
• 标签：为潜在客户添加标签。一个单元格里可以放多个，用 , 或 ; 分隔。
• 自定义字段：把单元格的值映射到你的某个自定义字段（例如预约日期）。
• 来源：覆盖默认来源。
• 外部 ID：你自己为这条记录设置的参考 ID。

4. 启用同步

保存并启用该连接。就这样，你的表格已经链接好了。

同步是如何工作的

• 新行几秒内导入。你一添加新行，Google 就会通知我们表格有变动，我们会立刻把它导入。
• 每 30 分钟自动安全检查。后台会重新扫描你的表格，以防某次实时更新被漏掉，确保万无一失。
• 立即同步。你可以随时点击立即同步来马上导入。

状态列：你会看到什么

每次同步后，我们会把结果写进你的状态列。这是正常现象，所以请不要编辑这些单元格。

• Imported（带日期和时间）。已从这一行创建了一条新潜在客户。✅
• Imported …（updated）。这一行匹配到了已有的潜在客户（电话相同），该潜在客户已被更新。
• Pending: add a phone or email to import。这一行还没有电话或邮箱。补上后会在下次同步时导入。
• Error: …。这一行有内容无法处理，原因会显示在单元格里（通常是某个值不符合自定义字段的要求，例如无效日期）。修正单元格后会自动重试。

更新已导入的行

同步只处理新行。如果你编辑了已经导入过的行，潜在客户不会跟着改变，因为状态单元格里仍然写着"Imported"。

要重新导入已编辑的行，请删除该行状态单元格里的文字。下次同步会把它当作新行处理，并更新对应的潜在客户。

避免重复

我们按电话号码匹配。如果新行的电话与已有潜在客户相同，我们会更新那条潜在客户，而不是创建重复记录。

须知

• 大批量导入会分批进行。每次同步最多导入 5,000 个新行。如果你粘贴了大量积压数据，剩余的行会在后续同步中自动导入，已导入的行不计入上限。
• 保持表格共享。如果你取消共享、改名、移动或删除已链接的文件，我们会失去访问权限，连接会被关闭。你需要重新连接才能恢复同步。
• 自定义字段会被校验。如果某一列映射到自定义字段，其值必须符合该字段的类型（例如日期字段需要有效日期），否则该行会显示 Error。

故障排查

新行没有导入。

1. 确认连接已启用。
2. 确认表格仍与已连接的 Google 账号共享（且没有被改名、移动或删除）。
3. 检查新行是否有电话或邮箱。
4. 查看这些行的状态单元格，是否显示 Error？阅读其中的信息。
5. 点击立即同步。（如果马上就成功了，说明只是漏掉了一次实时更新，30 分钟的自动检查同样会补上。）

某行显示"Pending"。它没有电话或邮箱，补上其中一项即可。

某行显示"Error: …"。阅读单元格里的信息，通常是某个值不符合所映射字段的要求（例如错误的日期）。修正单元格后，下次同步会自动重试。

我编辑了一行，但潜在客户没有更新。清空该行的状态单元格以重新导入（见"更新已导入的行"）。

我收到了重复的潜在客户。检查电话号码格式是否一致，并带有国家代码。

同步完全停止了。已链接的表格可能被取消共享、移动或删除，这会关闭连接。请重新连接表格。