使用 Google Sheets 导入潜在客户与自定义日期

本指南将带您完成 Google Sheets 与 ABC Sales AI 的集成，重点讲解如何正确同步生日等自定义日期字段。

阶段 1：准备 ABC Sales AI

在动手写任何代码之前，先在 ABC Sales AI 中设置好数据的目的地。

1. 登录您的账户：app.abcsalesbot.com。
2. 前往自定义字段（Custom Fields）。
3. 创建一个新字段。名称输入 birthday，类型选择日期（Date）。
4. 从主菜单进入集成（Integrations）。
5. 选择 Google Sheets 集成（Google Sheets Integration），点击复制（Copy）按钮，将集成代码复制到剪贴板。

阶段 2：设置您的 Google Sheet

您的 Google Sheet 需要按精确格式设置，脚本才能正确读取数据。

1. 打开一个新的或现有的 Google Sheet。
2. 将屏幕底部的工作表标签重命名为您想要的名称（例如 birthday）。
3. 在第 1 行创建完全一致的列标题：name、phone、email 和 birthday。
4. 选中整个生日列进行格式设置。API 要求严格的日期格式（YYYY-MM-DD）。
5. 在顶部菜单中，点击格式（Format） > 数字（Number） > 自定义日期和时间（Custom date and time）。
6. 选择或输入 yyyy-mm-dd（显示效果如 2003-12-01），然后点击应用（Apply）。

阶段 3：配置 Google Apps Script

现在，粘贴并修改代码，将 Sheet 连接到 ABC Sales AI。

1. 在您的 Google Sheet 中，点击扩展程序（Extensions） > Apps Script。
2. 删除编辑器中已有的所有代码，粘贴您从 ABC Sales AI 复制的代码。
3. 更新脚本顶部的 SHEET_NAME 变量，使其与您底部的工作表标签完全一致（例如 const SHEET_NAME = "birthday";）。
4. 确保您的 REQUIRED_FIELDS 与列标题完全一致。
5. 在 CUSTOM_FIELDS 下，将 <EDIT_THIS_VALUE> 替换为 "birthday"，以映射生日列。

阶段 4：重要的代码修改

您需要做四处关键调整，确保日期与自动化能被正确读取，而不会抛出“Invalid payload”错误。按 Ctrl + F（Mac 上为 Cmd + F）查找并替换以下代码块。

调整 1：修复 lastRow 变量

• 查找： var lastRow = e.range ? e.range.getRow() : sheet.getLastRow();
• 替换为： var lastRow = (e && e.range) ? e.range.getRow() : sheet.getLastRow();

调整 2：修复日期格式（第 1 处）

• 查找： var rowData = sheet.getRange(lastRow, 1, 1, sheet.getLastColumn()).getValues()[0];
• 替换为： var rowData = sheet.getRange(lastRow, 1, 1, sheet.getLastColumn()).getDisplayValues()[0];

调整 3：修复日期格式（第 2 处）

• 查找： var rowData = sheet.getRange(row, 1, 1, sheet.getLastColumn()).getValues()[0];
• 替换为： var rowData = sheet.getRange(row, 1, 1, sheet.getLastColumn()).getDisplayValues()[0];

调整 4：修复自动化“Null”问题

仅当您的 AUTOMATION_SUBSCRIBE 为 null 时才需要做此调整。如果自动化保持为 null，系统会拒绝这次同步。您必须替换负责准备这些数据的函数。

1. 查找以 function prepareDataForSalesbot(rowData, indices) { 开头的那一行。
2. 选中从该行开始，一直到最后一个 sendDataToSalesbot 函数之前的 return data; } 为止的内容。
3. 删除选中的部分，并用下面这段完整代码替换。

阶段 5：授权并添加触发器

最后，授予脚本运行权限，并设置触发器，让它在您添加新潜在客户时自动运行。

1. 点击编辑器顶部的保存（Save）图标（软盘图标），然后点击运行（Run）。
2. 系统会弹出“Authorization Required”（需要授权）提示。点击审核权限（Review permissions），选择您的 Google 账户。
3. Google 会显示一个警告页面。点击底部灰色的高级（Advanced）文字，再点击 Go to Untitled project (unsafe)，然后点击允许（Allow）。
4. 前往左侧菜单，点击触发器（Triggers）图标（形似时钟）。
5. 点击右下角的 + 添加触发器（+ Add Trigger）。将函数设置为 handleNewData，事件类型设置为编辑时（On edit）。点击保存（Save）。
6. 再次点击 + 添加触发器（+ Add Trigger）。将函数设置为 handleNewData，事件类型设置为更改时（On change）。点击保存（Save）。

设置完成！今后，每当您在这份 Google Sheet 中添加新的潜在客户及其生日时，都会自动同步到 ABC Sales AI。

重要使用提醒

请特别注意电话列中电话号码的输入方式：

• 马来西亚： 必须以 60 开头（例如 60123456789）。
• 新加坡： 直接输入标准的 8 位数号码即可（例如 81234567）。脚本会自动处理。
• 其他所有国家： 必须在开头包含完整的 + 国家区号（例如英国用 +44...）。