使用 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...）。