> For the complete documentation index, see [llms.txt](https://docs.chatalog.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatalog.ai/zh-hk/contact-setup/contact/import-export-add-contact.md).
# 匯入、匯出及新增聯絡人
您可以透過在 **聯絡人 > 動作** 頁面上的三個主要操作來管理目錄中的聯絡人：
1. 新增聯絡人
2. 匯入聯絡人 (CSV)
3. 匯出聯絡人 (CSV)
## 新增單個聯絡人
如只需要新增單個聯絡人，點擊"新增"鍵後只需填上姓名和連同區號等電話號碼即可新增。
## 匯入聯絡人
點擊「匯入聯絡人」按鈕後，您首先需要下載 .csv 範本檔案進行編輯。請在文件中填寫姓名和聯絡人號碼兩列。
電話號碼需要連同國際區號填寫，例如國際區號是852，電話是12345678，則需填上85212345678。儲存聯絡人列表檔案後，您可以將 .csv 檔案拖曳到上傳區域區域。點擊「匯入」以等待上傳完成。
如果您匯入的聯絡人列表包含一些現有的電話號碼，則名字、姓氏、電子郵件和自訂欄位將會更新。當您匯入並更新具有相同電話號碼的現有聯絡人資訊時，系統不會建立額外的聯絡人。
***
透過 CSV 檔案匯入聯絡人時，您可以設定 **標籤策略** 與 **自訂資料策略**，以控制系統如何處理現有聯絡人的資料。
這可協助您決定是否要覆蓋、合併或保留既有資訊。
### 標籤策略
選擇 CSV 檔案中的標籤，如何應用至系統中已存在的聯絡人。
#### 1. 替換現有標籤
**功能說明：**
* 移除聯絡人目前所有標籤。
* 僅保留匯入檔案中提供的標籤。
**適用情境：**
* 需要重新整理或重建標籤架構。
* 希望以匯入檔案作為最新標籤依據。
* 需要移除舊有或錯誤標籤。
**範例：**
* 原有標籤：`VIP`、`批發客戶`
* CSV 標籤：`零售`
* 匯入結果：`零售`（VIP、批發客戶將被移除）
***
#### 2. 添加到現有標籤
**功能說明：**
* 保留現有標籤。
* 將 CSV 中的標籤新增至聯絡人。
* 系統不會產生重複標籤。
**適用情境：**
* 進行行銷分群標記。
* 不希望影響既有標籤歷史。
* 逐步補充標籤資料。
**範例：**
* 原有標籤：`VIP`
* CSV 標籤：`夏季活動`
* 匯入結果：`VIP`、`夏季活動`
### 自訂資料策略
自訂資料將依以下邏輯處理：
**預設規則：**
* 保留現有自訂欄位資料。
* 若 CSV 中提供該欄位的值，則更新該欄位。
您可設定當匯入檔案中的資料為空時，系統應如何處理。
***
#### 當匯入值為空時：
**1.忽略 — 保留目前的數值**
**功能說明：**
* 若 CSV 欄位為空白，系統將保留原有資料。
* 不會進行任何變更。
**適用情境：**
* 僅更新部分欄位資料。
* 匯入檔案資料不完整。
* 避免誤刪重要資訊。
**範例：**
* 原有電話：`+852 91234567`
* CSV 電話欄位：空白
* 匯入結果：電話維持不變
***
**2.移除舊數值 — 清除現有的數值**
**功能說明：**
* 若 CSV 欄位為空白，系統將清除原有資料。
* 該自訂欄位將變為空白。
**適用情境：**
* 進行資料清理。
* 明確希望移除過時資訊。
* 以 CSV 作為唯一資料來源。
**範例：**
* 原有公司名稱：`ABC Ltd`
* CSV 公司名稱欄位：空白
* 匯入結果：公司名稱將被清除
## 匯出聯絡人
如果您要匯出所有聯絡人，只需點擊 **動作 > 匯出聯絡人(CSV)** 即可。
如果您只想匯出帶有特定標籤或在特定時間範圍內添加標籤的聯絡人，請按照以下步驟操作：
首先，點擊 「篩選」 展開下拉選單，以便您選擇要篩選的標籤和設置標籤添加的時間範圍。接著，聯絡人列表將會重新整理，只顯示具有所選標籤的聯絡人。然後，點擊 **動作 > 匯出聯絡人(CSV)**。下載的檔案將會是已篩選的聯絡人列表。