# 功能總覽
MAAC 支援品牌以多種方式建立與更新聯絡人，並依照指定的「Key 值」比對既有資料，自動判斷是新增聯絡人或更新現有欄位。此篇將說明：
- 聯絡人欄位支援的內容與格式
- Key 值（辨識依據）的比對邏輯
- 各欄位的更新行為
- 不同渠道的不可更新欄位（LINE UID、WA Mobile、Email…）
- Email / WhatsApp 聯絡人狀態、可觸及性與不可逆更新規則
- 已綁定聯絡人的定義與應用
- 常見錯誤與更新失敗原因
- 身份衝突偵測：當 Customer ID 不一致時，系統如何避免錯誤合併
- 系統自動維護欄位（如
last_message_time）的用途與更新邏輯
# 辨識邏輯說明
匯入或建立聯絡人資料時，您需選擇一個 Key 值作為辨識依據。
- 若 Key 值比對成功 → 更新既有聯絡人
- 若無法比對 → 建立新聯絡人 Profile / 不進行聯絡人更新
| Key 值 | 適用對象 | 辨識邏輯 | 備註 |
|---|---|---|---|
| line_uid | LINE 聯絡人 | 依 LINE UID 完整比對 | LINE UID 為不可修改欄位 |
| customer_id | 跨渠道聯絡人 | 比對品牌自定義唯一識別碼 | 僅能更新渠道聯絡人基本資料 |
| phone |
WhatsApp 聯絡人 SMS 聯絡人 或具有 phone 欄位的聯絡人 |
比對電話號碼 | |
| EDM 聯絡人 | 依 Email 完整比對 | EDM Email 為不可修改欄位 |
重要：各渠道聯絡人的發送關鍵 key 值皆不可更新：
- LINE 聯絡人：LINE UID
- WhatsApp 聯絡人：WhatsApp mobile
- Email 聯絡人：Email
- 其他聯絡人：phone
如 CSV 提供此欄位值，系統會忽略，不會更新。
📌 建議匯入前先匯出一次資料，確認 key 值是否一致，以避免新增重複聯絡人。
身份衝突偵測（Customer ID 不一致）🆕
Customer ID 會因是否設為合併金鑰而有不同行為：
- 已設為合併金鑰（Unify Key）：Customer ID 會參與身份整合，並在不一致時觸發下述的衝突保護。
- 未設為合併金鑰：Customer ID 僅作為一般聯絡人欄位，會直接被更新／同步為最新值，系統不會進行身份衝突偵測。
在上述前提下，當系統比對到多筆可能屬於同一人的聯絡人（例如以 Email 或電話歸戶為同一人），但這些聯絡人帶有不同的 Customer ID 時，為避免把不同人錯誤合併，系統會不自動合併這些聯絡人，並將其標記為「身份衝突」。
- 比對 Customer ID 時會忽略英文大小寫與前後空白。
- 發生衝突時，相關聯絡人會各自維持為獨立聯絡人，不會被合併為同一筆。
- 您可在整合聯絡人檔案上看到衝突提示，也可從聯絡人列表的【匯出】下載衝突名單進行清理。
如何修正衝突：
- 確認這些聯絡人是否確實為同一人。
- 修正錯誤的 Customer ID，或補上正確的識別資料。
- 重新匯入這些聯絡人，讓系統重新進行身份整合（整合於背景進行，完成後再回頭確認結果）。
👉 下載衝突名單請參考：操作說明｜匯出聯絡人與資料對應表；修正後重新匯入請參考：設定教學｜匯入與更新聯絡人資料。
整合聯絡人的欄位顯示 🆕
當同一人的多筆渠道聯絡人歸戶為一筆整合聯絡人後，整合聯絡人檔案上顯示的欄位（如顯示名稱、生日、性別、自訂欄位、標籤）會由名下各渠道聯絡人的資料彙整呈現，同一個欄位以最近一次更新的值為準。
電話、Email 這類各渠道專屬的識別資料則維持在各渠道層級，不會因為歸戶而互相覆寫其他渠道聯絡人的值。
👉 整合聯絡人檔案各區塊的完整說明，請參考：教學｜整合聯絡人檔案（Unified Contact Profile）與分離聯絡人。
# Email 聯絡人訂閱狀態邏輯
Email 聯絡人除了以 email 作為主鍵辨識外，是否能在自動旅程或其他 Email 功能中被正常發送，還需同時判讀 訂閱狀態 messaging_status。
| 狀態顯示 | 定義 | 是否可寄送 |
|---|---|---|
| 已訂閱（Subscribed） | 聯絡人同意接收 Email，且信箱狀態正常。 | 是 |
| 取消訂閱（Unsubscribed） | 聯絡人已主動點擊取消訂閱，不應再寄送 Email。 | 否 |
⚠️ Email 狀態取消訂閱後具備「不可逆」限制：您無法透過 CSV 匯入，將「取消訂閱」或「系統阻擋」的聯絡人改回「已訂閱」。若 CSV 中嘗試重設，系統會忽略該狀態更新。
＊ 但您可以透過 CSV 匯入將「已訂閱」聯絡人變更為「取消訂閱」聯絡人，以達到清洗名單的效果
👉 詳細匯入規範請參考：設定教學｜如何啟用 Email 渠道並匯入聯絡人 與 設定教學｜匯入與更新聯絡人資料
# 聯絡人欄位支援總覽
基礎欄位
| 欄位名稱 | 說明 | 可匯入 | 可更新 | 備註 |
|---|---|---|---|---|
| phone | 電話 | ✅ | 可 | 作為辨識 Key，避免多筆共用 |
| customer_id | 品牌自定義識別碼 | ✅ | 可 | 建議 CRM 使用 |
| 信箱 | ✅ | 不可更新 （Email 聯絡人 key 值） |
Email 聯絡人識別；請搭配訂閱狀態判讀 | |
| name | 顯示名稱 | ✅ | 可 | 有值即覆蓋 |
| note | 備註 | ✅ | 可 | 有值即覆蓋 |
| tags | 聯絡人標籤 | ✅ | 可 | 標籤會合併，不覆蓋 |
📌 除上述基礎欄位外，品牌可另行建立「自訂欄位 (Custom Fields)」，詳見下方 自訂欄位段落
渠道聯絡人發送 Key 值（不可更新）
| 欄位 | 所屬渠道 | 規則 |
|---|---|---|
| line_uid | LINE | LINE 綁定的唯一識別，不可更新 |
| WhatsApp_mobile |
匯入 WA 聯絡人時用作主鍵，不可更新
|
|
| EDM | 匯入 Email 聯絡人時用作主鍵，不可更新；是否可發送需另看訂閱狀態 | |
| phone（SMS） | SMS | SMS 聯絡人主鍵，可作為 Key，但不可被 customer_id 更新覆蓋 |
系統自動維護欄位
以下欄位由系統自動寫入與更新，品牌無法手動修改，也無法透過 CSV 匯入或 API 覆寫。
| 欄位名稱 | 說明 | 資料型別 | 寫入 / 清除時機 | 用途與備註 |
|---|---|---|---|---|
last_message_time（最後發訊時間） |
記錄聯絡人最後一次在各渠道（LINE / WhatsApp）發送訊息的時間 | DateTime（UTC） |
寫入：每次聯絡人發送訊息時自動更新
|
用於自動旅程「第一則訊息」觸發判定 — 當此欄位為空值（NULL）時，系統判定該次發訊為「首次發話」。 📌 此欄位為系統自動維護，品牌無法手動修改。 |
當聯絡人於 LINE unfollow 或 WhatsApp opt-out 後，
last_message_time 會被清除。若該聯絡人日後重新追蹤（LINE re-follow）或重新訂閱（WhatsApp re-opt-in），其首次發送的訊息將再度被視為「第一則訊息」，可重新觸發對應的自動旅程。👉 詳細自動旅程觸發邏輯請參考：功能說明｜全渠道自動旅程
# 自訂欄位 (Custom Fields)
除了上述基礎欄位外，品牌可透過 Admin Center 自行建立「自訂欄位 (Custom Fields)」，將 CRM 結構化資料整合至 MAAC 聯絡人中。
📕 請先閱讀：教學｜MAAC × CAAC 跨產品自訂欄位設定（Admin Center 建立與管理欄位）
支援的資料型別
| 資料型別 | 說明 | 適用情境 |
|---|---|---|
| Text（文字） | 自由輸入文字 | 會員等級、偏好商品類別 |
| Number（數值） | 數值格式，支援大小比較 | 紅利點數、消費次數、消費金額 |
| Date（日期） | 僅日期 (YYYY-MM-DD)，不含時間 | 生日、入會紀念日、合約到期日 |
| DateTime（日期與時間） | 精確到時分秒，底層以 UTC+0 儲存，介面自動轉為組織時區 | 預約到期時間、限時優惠券失效時間 |
查看與手動編輯自訂欄位
進入任一位聯絡人頁面，您可以找到「自訂欄位」區塊。點擊「🔒編輯」即可手動更新自訂欄位數值，按下「儲存」即可同步到 CDH 當中。
- 欄位順序將依建立時間排序
- 若欄位於 Admin Center 被封存，將不會顯示於 MAAC 介面中
自訂欄位的修改方式
系統支援四種修改方式，確保您的名單隨時保持最新狀態：
| 更新方式 | 運作說明 |
|---|---|
| 自動同步 (API) | 若企業已串接外部 CRM，資料會隨時自動更新，確保看到的是最新狀態。詳情可參考此 API 文件。 |
| CSV 大量匯入 | 適合行銷人員每月結算、或將線下活動名單批次上傳更新。👉 設定教學｜匯入與更新聯絡人資料 |
| 手動編輯 | 您可在聯絡人頁面直接修改欄位內容（如上方「查看與手動編輯」段落所述）。 |
| 自動旅程自動更新（Journey 自動更新） | 您可在自動旅程中透過「更新屬性」動作節點，自動寫入或清除自訂欄位數值。👉 功能說明｜自動旅程 |
若您在 Admin Center 將某個自訂欄位「封存 (Archive)」，該欄位將從 MAAC 聯絡人介面中隱藏，且系統將停止讀取與寫入。解除封存後，歷史資料會完整恢復。
👉 更多自訂欄位在旅程與聯絡人中的應用，請參考：教學｜在 MAAC 使用跨產品自訂欄位 (Custom Fields)
# 欄位更新行為與注意事項
| 行為 | 系統處理方式 |
| 有新值 | 覆蓋原值 |
| 欄位為空 | 略過，不覆蓋 |
| 多筆標籤 | 合併，不清除原標籤 |
| CSV 欄位名稱錯誤 | 略過該欄位 |
| 更新不可更新欄位（如 line_uid、email、WA mobile） | 會被忽略 |
| 更新 Email 聯絡人狀態為已訂閱（原狀態為取消訂閱 / 系統阻擋） | 系統忽略該狀態更新；僅更新其他可更新欄位 |
嘗試透過 CSV 或 API 修改系統自動維護欄位（如 last_message_time） |
系統忽略；該欄位僅由系統自動寫入與清除 |
# 什麼是「已綁定聯絡人」？
在 MAAC 中，若聯絡人資料中包含 customer_id 欄位，即代表該聯絡人為「已綁定聯絡人」。這表示該聯絡人已與品牌自有系統（如會員系統、CRM）完成識別綁定，能作為進一步整合與個人化應用的對象。
應用場景：
圖文選單個人化
針對已綁定聯絡人顯示專屬內容，例如：未綁定顯示「加入會員」、已綁定顯示「查詢訂單」、「會員點數」。自動回應差異化訊息
可在自動回應中設定條件，對已綁定聯絡人發送不同訊息，例如 VIP 專屬優惠、生日祝福等。整合會員系統資料
API 或 Webhook 回傳時，可透過customer_id進行資料串接，確保身份一致性。
📌 小提醒
若您的品牌有會員制度、忠誠度計畫，或希望實現更進一步的個人化推播與行銷自動化，建議優先綁定 customer_id。
📌 若您已啟用 Email 渠道，亦建議前往 Customer Data Hub（CDH） 將電子信箱（Email）設為合併金鑰（Unify Key）。如此可讓 LINE 與 Email 聯絡人更準確歸戶，避免跨渠道旅程重複觸發或重複溝通。
# 常見問題（FAQ）
Q1：我應該選哪個欄位作為辨識依據？
A：請依照匯入資料來源選擇最具代表性的 Key 值：
- LINE webhook → 使用 line_uid
- CRM 系統資料 → 使用 customer_id
- 電話名單 → 使用 phone，但請確認無重複 phone
Q2：我用 phone 作為 key 值匯入資料，會更新哪一筆聯絡人？
A：若系統中有多筆聯絡人使用相同 phone，系統會更新建立時間較晚的那筆。
建議改用 line_uid 或 customer_id 以避免誤更新。
Q3：external_member_id 可以用來匯入或更新嗎？
A：不行。該欄位僅供匯出查詢 UID 對應關係，無法作為匯入欄位。
Q4：last_message_time 欄位可以手動修改嗎？
A：不可以。last_message_time 為系統自動維護欄位，每次聯絡人在 LINE 或 WhatsApp 發送訊息時由系統自動更新，品牌無法透過 CSV 匯入、API 或手動編輯方式修改此欄位。此欄位主要用於自動旅程中的「第一則訊息」觸發判定。