從 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: …」。閱讀儲存格裡的訊息，通常是某個值不符合所對應欄位的要求（例如錯誤的日期）。修正儲存格後，下次同步會自動重試。

我編輯了一列，但潛在客戶沒有更新。清空該列的狀態儲存格以重新匯入（見「更新已匯入的列」）。

我收到了重複的潛在客戶。檢查電話號碼格式是否一致，並帶有國碼。

同步完全停止了。已連結的試算表可能被取消共用、移動或刪除，這會關閉連接。請重新連接試算表。