本文將說明如何透過 MAAC 平台匯出聯絡人名單，以及如何使用資料對照欄位進行資料整理或準備匯入更新。
# 匯出聯絡人名單
操作路徑：
聯絡人管理 > 聯絡人 > 右上角「更多操作」 > 匯出聯絡人
匯出格式：
匯出檔為
.csv格式每次最多可匯出 100,000 筆聯絡人資料（依合約方案而定）
匯出選項
點擊聯絡人頁面右上角的【匯出】，可依需求選擇匯出範圍：
- 匯出所有聯絡人
- 匯出可觸及聯絡人
- 匯出不可觸及聯絡人
- 匯出衝突聯絡人 — 下載目前處於身份衝突狀態的聯絡人名單（欄位與操作見下方「匯出衝突聯絡人名單」）
📌 匯出範圍會依照聯絡人列表當下的篩選條件。若您先以渠道篩選【SMS】，匯出的內容即為 SMS 聯絡人。
可匯出欄位範例：
| 欄位名稱 | 說明 |
|---|---|
| external_member_id | 外部平台識別碼：可能為 LINE UID、Facebook ID、Instagram ID；SMS 聯絡人則為該筆聯絡人的電話號碼 |
| name | 顯示名稱 |
| phone | 聯絡人電話 |
| 電子信箱 | |
| tags | 聯絡人標籤（以逗號分隔） |
| customer_id | 品牌自定義聯絡人 ID |
| note | 備註欄位 |
| create_time | 建立時間 |
| last_update_time | 最後更新時間 |
| 所有自訂欄位 | 若有建立自訂欄位，將一併顯示 |
# 匯出衝突聯絡人名單
當系統偵測到聯絡人之間存在 Customer ID 不一致的身份衝突時，【匯出】按鈕會出現提示標記，選單中也會提供【匯出衝突聯絡人】。若目前沒有任何衝突，則無需處理。
衝突名單 CSV 欄位
【匯出衝突聯絡人】下載的 CSV 內容為「目前仍處於衝突狀態」的所有聯絡人，包含下列欄位：
| 欄位 | 說明 |
|---|---|
| unified_contact_id（UCID） | 整合聯絡人 ID |
| platform_type | 渠道平台類型（例如 line） |
| platform_name | 渠道平台名稱（例如官方帳號名稱） |
| external_member_id | 外部平台識別碼 |
| customer_id | 品牌自定義的顧客識別碼 |
| display_name | 聯絡人顯示名稱 |
| phone | 聯絡人電話 |
| 電子信箱 | |
| conflict_reason | 衝突原因（例如 customer_id_multiple） |
| conflict_cid | 偵測到衝突的其他 Customer ID（與本筆 customer_id 不一致、導致未自動合併的 Customer ID） |
👉 取得名單後，請修正錯誤的 Customer ID 或補上正確識別資料，再重新匯入：設定教學｜匯入與更新聯絡人資料。衝突偵測機制請參考：功能說明｜聯絡人欄位說明與辨識邏輯。
# 如何使用匯出資料對應匯入欄位
匯出檔案可作為日後更新聯絡人資料的參考依據與匯入模板來源。請注意以下事項：
1. external_member_id 對應欄位說明：
| external_member_id 類型 | 可對應匯入 Key 值 | 備註 |
|---|---|---|
| LINE UID | line_uid |
建議使用該欄位更新 LINE 聯絡人 |
| Facebook ID | 不支援 | Facebook 聯絡人暫不支援匯入 |
| Instagram ID | 不支援 | Instagram 聯絡人暫不支援匯入 |
| 電話號碼（SMS 聯絡人） | mobile | 請於匯入流程選擇 SMS 渠道，可新增或更新 SMS 聯絡人 |
2. 如何整理成匯入格式：
請使用匯出資料，保留下列欄位並依需求編輯內容，再另存為 .csv 檔，即可用於更新聯絡人：
line_uid（或 phone / customer_id）
name / email / phone / note / tags
自訂欄位（欄位名稱需與後台設定一致）
⚠️ 若您使用 phone 為辨識欄位，系統將更新建立時間較晚的聯絡人（SMS 聯絡人以電話號碼為唯一識別，同一個號碼不會有多筆 SMS 聯絡人）
⚠️ 匯入欄位請避免留空，空白欄位不會覆蓋原資料
# 常見問題 FAQ
Q1：為什麼匯出檔中沒有我建立的自訂欄位？
A：請確認該欄位是否已套用至聯絡人資料，若沒有內容則不會顯示於匯出結果。
Q2：external_member_id 是不是就是 line_uid？
A：不一定。external_member_id 為統一欄位，實際內容會依來源平台而異（LINE 為 line_uid，Facebook 為 fb_id，Instagram 為 ig_id，SMS 為電話號碼）。
如需進一步說明，請參考：設定教學｜匯入與更新聯絡人資料