> For the complete documentation index, see [llms.txt](https://hifunnel.gitbook.io/hifunnel-help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hifunnel.gitbook.io/hifunnel-help-center/documentation/documentation-vi/khach-hang-and-danh-ba/manage-your-contacts/how-to-import-contacts-into-hifunnel.md).

# Hướng dẫn Nhập Danh sách Khách hàng (Import Contacts) vào Hifunnel

Hướng dẫn nhập danh sách khách hàng hàng loạt vào Hifunnel bằng file CSV, sao chép dữ liệu hoặc thêm khách hàng lẻ với tính năng khớp cột tự động.

Công cụ **Import Contacts** của Hifunnel giúp bạn dễ dàng chuyển đổi và tải danh sách khách hàng lên hệ thống bằng file định dạng `.CSV`, sao chép dữ liệu từ Google Sheets/Excel, hoặc thêm thủ công từng khách hàng riêng lẻ.

***

## Yêu cầu File CSV & Quy tắc Tối ưu

Trước khi tải danh sách khách hàng lên, hãy chuẩn bị file `.CSV` để hệ thống tự động khớp cột chính xác:

* **Trường bắt buộc**: Bắt buộc có ít nhất 1 cột chứa địa chỉ **Email**.
* **Các cột nên có**: Email Address, Họ và Tên (Cột đơn), Số điện thoại, Thẻ Tag phân loại và Trường tùy chỉnh.
* **Gộp cột Họ và Tên**: Hifunnel sử dụng 1 cột Tên duy nhất. Nếu file CSV của bạn đang tách làm 2 cột "Họ" và "Tên", hãy sử dụng hàm gộp `=CONCATENATE(A2," ",B2)` trên Google Sheets/Excel trước khi xuất file.
* **Giới hạn Tag**: Bạn có thể gắn tối đa 100 thẻ Tag và 50 trường dữ liệu tùy chỉnh cho mỗi lượt Import.

{% hint style="warning" %}
**Tuân thủ Quy định Bảo mật & Chống SPAM:** Chỉ nhập danh sách khách hàng đã đồng ý nhận email từ doanh nghiệp của bạn. Việc tải lên danh sách email thu thập trái phép hoặc không rõ nguồn gốc có thể ảnh hưởng xấu đến uy tín gửi email (Deliverability) của tên miền.
{% endhint %}

***

## Hướng dẫn các bước Import Khách hàng bằng File CSV

{% stepper %}
{% step %}

#### Bước 1: Mở trình quản lý Contacts

Từ **Dashboard Hifunnel**, nhấp chọn mục **Contacts** trên thanh menu chính bên trái.
{% endstep %}

{% step %}

#### Bước 2: Bật công cụ Import

Nhấp vào nút **+ Import Contacts** (hoặc **Add Contacts**) ở góc trên bên phải trang.
{% endstep %}

{% step %}

#### Bước 3: Chọn phương thức Import

Chọn **Upload CSV File** (hoặc chọn **Copy/Paste** nếu bạn muốn dán trực tiếp các dòng từ bảng tính Excel).
{% endstep %}

{% step %}

#### Bước 4: Khớp các cột dữ liệu (Column Mapping)

Kiểm tra bảng khớp cột thông minh của Hifunnel:

* Khớp tiêu đề cột trong file CSV với các trường tương ứng trên Hifunnel (Email, Họ tên, Số điện thoại, Thẻ Tag).
* Chọn **Create New Custom Field** nếu muốn tạo trường dữ liệu tùy chỉnh mới.
* Chọn **Skip Column** để bỏ qua cột không muốn nhập.
  {% endstep %}

{% step %}

#### Bước 5: Cấu hình Hành động hàng loạt (Bulk Actions)

Thiết lập các hành động tự động áp dụng cho toàn bộ danh sách mới nhập:

* **Grant Offer**: Tự động cấp quyền truy cập khóa học/sản phẩm số ngay khi nhập xong.
* **Apply Tags**: Gắn thẻ phân loại (ví dụ: `Hoc-vien-K1`, `Lead-Webinar`).
* **Marketing Opt-In**: Tích chọn đăng ký nhận tin tiếp thị cho khách hàng hợp lệ.
  {% endstep %}

{% step %}

#### Bước 6: Xác nhận và Tiến hành Import

Nhấp **Confirm & Import**. Hifunnel sẽ xử lý danh sách và gửi một email báo cáo tổng kết về tài khoản của bạn ngay khi hoàn tất.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Cơ chế xử lý Khách hàng Trùng lặp (Duplicates):** Hifunnel tự động nhận diện và chống trùng lặp dựa trên địa chỉ Email. Nếu khách hàng đã tồn tại trên hệ thống, Hifunnel sẽ cập nhật thêm thẻ Tag hoặc quyền truy cập mới mà không tạo ra bản ghi bị lặp.
{% endhint %}