本篇文章將引導您如何透過 CSV 檔案批次匯入或更新聯絡人資料。隨著 MAAC 升級為全渠道平台,現在您也可以匯入 Email (EDM) 與 WhatsApp 的聯絡人名單。
# 匯入欄位與格式說明
為了確保資料正確匯入,請參考下表準備您的 CSV 檔案。不同渠道可能會有特定的必填欄位。
Line 渠道匯入
| 欄位名稱 | 說明 | 是否必填 | 可更新 | 備註 |
| line_uid | LINE 使用者 UID | 否 | ❌ | LINE 聯絡人主辨識欄位 |
| phone | 聯絡人電話 | 否 | △ |
|
| customer_id | 品牌自定義聯絡人 ID | 否 | ✅ | 建議唯一,用於同步外部資料 |
| name | 顯示名稱 | 否 | ✅ | 有值則覆蓋原值 |
| Email 地址 | 否 | △ |
|
|
| note | 備註欄位 | 否 | ✅ | 有值則覆蓋 |
| tags | 標籤 | 否 | ✅ | 以半形逗號分隔,會合併新增 |
Email (EDM) 渠道匯入
適用於匯入 Email 行銷名單。請注意 EDM 匯入有嚴格的狀態(Status)驗證機制,以保護發信信譽。
| 欄位名稱 | 說明 | 是否必填 | 備註 |
| Email 地址 | 是 | 聯絡人的 email 地址。此欄位為必填,作為 EDM 渠道聯絡人的主要識別欄位。 | |
| messaging_ status |
訂閱狀態 | 是 | 填入聯絡人在品牌網域中的訂閱狀態。值必須為以下其一:「subscribed」, 「unsubscribed」, 「hard_bounce」, 或 「spam_report」 |
| display_name | 顯示名稱 | 否 | 字數不得超過 255 個字元。 |
| gender | 性別 | 否 | 請務必填入以下其中一個值:「female」、「male」或「unknown」。 |
| customer_id | 品牌自定義聯絡人 ID | 否 | 建議唯一,用於同步外部資料 |
| mobile | 電話 | 否 | 電話號碼必須符合地區規範或採用 E.164 格式。例如,臺灣可接受的格式為「0912345678」或「+886912345678」。 |
| birthday | 生日 | 否 | 僅接受 YYYY-MM-DD 格式。 |
| tag | 標籤 | 否 | 以半形逗號分隔,會合併新增 |
| consent_source | 同意來源 | 否 | 聯絡人提供同意的來源(例如:「Website Footer」、「Checkout」)。此欄位將用於未來稽核用途。 |
| consent_at | 同意時間 | 否 | 聯絡人提供同意的精準時間。格式必須為 YYYY-MM-DD hh:mm:ss。此欄位將用於未來稽核用途。 |
📌 匯入 Email 聯絡人後,若您要在自動旅程中實際使用「發送 Email」節點,除了聯絡人狀態需為已訂閱(Subscribed)外,品牌的 Email 渠道也必須為已連線,且至少有一組可用的寄件者設定檔(Sender Profile)。
👉 若匯入完成後仍無法在旅程中發送 Email,請先參考:設定教學|如何啟用 Email 渠道並匯入聯絡人
WhatsApp 渠道匯入
適用於匯入 WhatsApp 聯絡人電話名單。此渠道必須包含狀態欄位,否則無法匯入。
| 欄位名稱 | 說明 | 是否必填 | 備註 |
| WhatsApp_mobile | WhatsApp 電話號碼 | 是 | 此欄位為必填欄位。欄位標題不得刪除或調換順序。電話號碼必須符合地區規範或採用 E.164 格式。 例如,臺灣可接受的格式為「0912345678」或「+886912345678」。 |
| messaging_ status |
訂閱狀態 | 是 | 此欄位為必填欄位。請務必填入以下其中一個值:「opted_in」、「opted_out」或「not_subscribed」。 |
| display_name | 顯示名稱 | 否 | 字數不得超過 255 個字元。 |
| gender | 性別 | 否 | 請務必填入以下其中一個值:「female」、「male」或「unknown」。 |
| customer_id | 品牌自定義聯絡人 ID | 否 | 建議唯一,用於同步外部資料 |
| 電子信箱 | 否 | 電話號碼必須符合地區規範或採用 E.164 格式。例如,臺灣可接受的格式為「0912345678」或「+886912345678」。 | |
| birthday | 生日 | 否 | 僅接受 YYYY-MM-DD 格式。 |
| tag | 標籤 | 否 | 以半形逗號分隔,會合併新增 |
# 如何選擇「辨識欄位」(Key 值)
匯入前,您必須選擇 1 個欄位作為比對依據(Key 值),系統會用來確認是要「更新」還是「新增」聯絡人:
| Key 值 | 說明 | 建議使用情境 |
| line_uid | LINE 使用者 UID | 從 webhook 建立的聯絡人 |
| phone | 聯絡人電話號碼 | 匯入 WhatsApp 名單、電話名單、線下資料 |
| 聯絡人 Email | 匯入 Email 訂閱者名單時使用。 | |
| customer_id | 品牌自定義唯一值 | CRM 系統、API 整合用戶 |
⚠️ 注意:若系統中有多筆聯絡人共用相同 phone,將更新「建立時間較晚」的那筆。為避免誤更新,建議使用 line_uid 或 customer_id。
📌 若您預計將 Email 聯絡人與 LINE 聯絡人整合到同一條全通路自動旅程中,建議同步前往 Customer Data Hub(CDH) 將電子信箱(Email)設為合併金鑰(Unify Key),以減少跨渠道重複溝通。
# 匯出聯絡人時包含自訂欄位
當您在「聯絡人列表」匯出名單時,介面上會多出「自訂欄位」的區塊供您勾選。您可以自由決定這次下載的報表要包含哪些自訂欄位資料(例如:勾選匯出「會員等級」),讓後續的線下分析更方便。
匯出步驟:
- 前往「聯絡人管理」「匯出」
- 在匯出設定中,勾選您需要的「自訂欄位」
- 點擊「匯出」,系統將產生包含自訂欄位數據的 CSV 檔案
匯出的 CSV 檔案中,自訂欄位的標題會自動帶有
cl_custom_ 前綴。若您需要將此檔案修改後重新匯入,請保留此前綴格式,系統才能正確辨識。
# 匯入後的系統行為
| 行為 | 結果 |
| Key 值比對成功 | 更新該聯絡人的資料(僅覆蓋有填寫的欄位) |
| Key 值比對不到 | 建立新聯絡人(若 Key 值為 customer_id 則不會新增) |
| 欄位名稱錯誤 | 略過該欄位 |
| tags 有多個值 | 會合併,不會覆蓋原標籤 |
| 欲更新渠道主鍵(line_uid / email / WhatsApp_mobile / SMS phone) | 系統忽略,不會更新 |
# 更新注意事項
- 空白欄位不覆蓋原資料
-
自訂欄位的 CSV 標題必須以
cl_custom_開頭,後接欄位識別碼,且需與 Admin Center 中的設定完全一致 - 若同時帶入多個辨識欄位,系統依 Key 值為主
- LINE UID / WA mobile / email / phone(SMS)為不可更新欄位
- Email 聯絡人的 email 欄位不會被覆蓋
# 渠道匯入限制
A. Email (EDM) 聯絡人匯入
重要匯入限制
為了遵守國際反垃圾郵件法規並保護網域信譽,MAAC 設有嚴格的 「狀態不可逆」 規則:
🚫 您無法透過 CSV 匯入,將「取消訂閱」或「系統阻擋」的聯絡人改回「已訂閱」。
- 若在 CSV 中嘗試將 Unsubscribed 改為 Subscribed,系統將 忽略該狀態更新,僅更新其他欄位 (如姓名、電話),這是為了防止誤發給已經明確拒絕或無效的信箱,避免您的品牌被列入黑名單。
自動停權機制 (Suspension Policy)
為了維護所有用戶的發信品質,系統設有自動監測機制。若您的發信網域出現以下狀況,系統將會自動暫停您的發信功能:
-
觸發條件 (過去 24 小時內) :
- 硬退信 (Hard Bounce):寄給太多不存在的信箱,次數超過 20 次 且 退信率 > 5%。
- 垃圾郵件舉報 (Spam Report):太多用戶將您的信件標示為垃圾信,次數超過 10 次 且 舉報率 > 0.5%。
-
如何恢復?
- 您必須先使用第三方工具清洗您的 Email 名單,排除無效名單。
- 將清洗結果匯入 MAAC 更新聯絡人狀態。
- 通知您的 CSM 協助申請復權,經人工審核後由後台手動恢復 。
⚠️ Email (EDM) 渠道功能因使用共用 IP,一個異常的寄件者會損害所有客戶。客戶必須僅使用經同意、訂閱的名單。不可使用購買或爬蟲取得的名單。
B. WhatsApp 聯絡人匯入
重要匯入限制:必填狀態與格式
status 欄位為絕對必填。允許值:
opted_in (已同意)、not_subscribed (未訂閱)、opted_out (已退訂)。系統行為:若 CSV 中某筆資料的
status 欄位為空,系統將直接 「略過該筆資料」 (Skip),完全不會進行匯入或更新,。
+886912345678)。若格式不符,系統將無法建立有效的 WhatsApp 聯絡人,導致發送失敗。
Meta 帳號品質與停權機制 (Quality & Suspension)
not_subscribed) 或已退訂 (opted_out) 的用戶,極易導致封鎖或檢舉。這會造成 帳號評分下降、每日額度被降級,嚴重者將導致 WABA 帳號停權,。
# 匯入聯絡人步驟
步驟 1:下載匯入範本
前往 聯絡人管理 點選 匯入 / 更新聯絡人資料 下載系統提供的 CSV 匯入範本
建議先匯出現有聯絡人資料,確認欄位名稱與 Key 值是否一致,避免產生重複聯絡人。
步驟 2:上傳檔案
步驟 3:查看結果
# 匯入後的身份整合與衝突處理 🆕
匯入完成後,系統會在背景進行身份整合,依您設定的合併金鑰(Unify Key)判斷哪些聯絡人屬於同一人並歸戶為同一筆整合聯絡人。整個流程分兩個階段:
- 匯入完成:CSV 名單建立 / 更新完成,您會收到通知(小鈴鐺)。
- 整合完成:背景的身份整合完成歸戶。
由於身份整合在背景進行,「匯入完成」不代表「整合完成」。請稍候片刻,待整合完成後再回到聯絡人列表或整合聯絡人檔案確認歸戶是否正確。
當匯入造成身份衝突
若整合過程中發現多筆可能為同一人的聯絡人帶有不同的 Customer ID,系統會為避免錯誤合併而不自動合併,並標記為身份衝突。此時:
- 當偵測到身份衝突時,聯絡人列表的【匯出】按鈕會出現 ⚠️ 提示,代表衝突報告已可下載。
- 您也可於聯絡人列表的【匯出】>【匯出衝突聯絡人】下載目前仍處於衝突狀態的名單。
修正並重新觸發歸戶:
- 下載衝突名單,確認相關聯絡人是否確實為同一人。
- 修正錯誤的 Customer ID,或補上正確的識別資料。
- 將修正後的名單重新匯入,系統會重新進行身份整合。
若某渠道聯絡人曾被手動「分離」而停用身份整合,重新匯入其正確識別資料同樣會重新觸發歸戶,整合完成後分離註記會消失。詳見 教學|整合聯絡人檔案(Unified Contact Profile)與分離聯絡人。
👉 下載衝突名單與 CSV 欄位說明:操作說明|匯出聯絡人與資料對應表;衝突偵測機制:功能說明|聯絡人欄位說明與辨識邏輯。
# 常見問題(FAQ)
Q:匯入的 phone 若在系統中有多筆重複,會更新哪一筆?
A:系統會更新「建立時間較晚」的那筆聯絡人。若要避免誤更新,建議改用 line_uid 或 customer_id 作為辨識依據。
Q:匯入標籤時,原有標籤會被覆蓋嗎?
A:不會。匯入的標籤會與既有標籤自動合併,系統不會刪除原有標籤。
Q:為什麼某些欄位沒有成功更新?
A:可能原因如下:
該欄位在匯入檔為空白 欄位名稱與後台設定不一致 欄位屬於「渠道主鍵」,不可更新(line_uid、WhatsApp_mobile、email(EDM primary key)、SMS phone) 使用 customer_id 作為 Key 值時,若系統內沒有該 customer_id,將不會新增新聯絡人
Q:匯入資料時,能否同時新增與更新聯絡人?
A:可以。系統會依照您選擇的 Key 值自動判斷每筆資料是更新或新增。但若使用 customer_id 作為 Key 值,系統僅會更新既有聯絡人,不會新增新聯絡人。
Q:匯入後聯絡人為什麼被合併?
A:MAAC 會依據 Profile Unification 規則自動合併資料,只要以下任一欄位符合既有聯絡人,就會合併成同一個 Profile:email、phone、customer_id、line_uid、WhatsApp_mobile、fb_id、ig_id。
Q:為什麼有些聯絡人沒有被自動合併,還出現「身份衝突」?
A:當多筆可能屬於同一人的聯絡人帶有不同的 Customer ID 時,系統會為避免把不同人錯誤合併而不自動合併,並標記為身份衝突。請下載衝突名單,確認是否為同一人,修正 Customer ID 或補上正確識別資料後重新匯入,系統便會重新進行歸戶。
Q:匯入完成後,為什麼歸戶結果還沒更新?
A:身份整合是在背景進行的作業,「匯入完成」通知不代表「整合完成」。請稍候片刻,待背景整合完成後再回到聯絡人列表或整合聯絡人檔案確認歸戶結果。
Q:為什麼 WhatsApp 匯入時某些列被跳過?
A:WA 匯入需要提供兩個必填欄位:WhatsApp_mobile 與 status。若 status 為空(未填寫 opted_in / opted_out / not_subscribed),系統會跳過該筆資料,不進行匯入。
Q:我已經匯入 Email 聯絡人,為什麼仍無法在自動旅程中發送 Email?
A:常見原因有三個:第一,該聯絡人的 messaging_status 不是已訂閱(Subscribed);第二,您的 Email 渠道尚未已連線(Connected);第三,系統中沒有可用的寄件者設定檔(Sender Profile)。匯入聯絡人只完成名單建立,仍需同時滿足渠道與寄件條件,旅程中的「發送 Email」節點才可正常運作。
Q:匯入自訂欄位時,系統顯示找不到欄位,該如何處理?
A:請檢查您的 CSV 檔案標頭 (Header)。系統要求自訂欄位必須帶有 cl_custom_ 前綴,正確格式為 cl_custom_{欄位識別碼}。請至 Admin Center 確認欄位識別碼的拼寫,並確保欄位狀態為「啟用中」而非「已封存」。
Q:匯入的自訂欄位數值格式有什麼要求?
A:不同型別的欄位有不同的格式要求:
- Text(文字):自由輸入文字字串
- Number(數值):僅接受數字(可含小數點)
- Date(日期):僅接受 YYYY-MM-DD 格式
- DateTime(日期與時間):接受 YYYY-MM-DD HH:mm:ss 格式,系統會以 UTC+0 儲存