# Contact và danh sách nhận

Thêm người nhận email từng người, từ file CSV hoặc từ CRM, lưu thuộc tính riêng cho từng người và giữ đúng sự đồng ý của họ.

Một **contact** là một địa chỉ email mà doanh nghiệp gửi email marketing tới, kèm họ tên, các thuộc tính riêng của bạn (thành phố, hạng thành viên, số đơn đã mua…) và trạng thái đồng ý nhận thư. Mỗi địa chỉ chỉ có một contact trong doanh nghiệp, và một contact có thể thuộc nhiều segment. Mọi thứ nằm ở **Email → Danh sách nhận**, trong các tab **Contacts**, **Segments**, **Topics**, **Thuộc tính** và **Danh sách chặn**.

Xem contact cần quyền **Xem** trong module Email; thêm, nhập và sửa contact cần quyền **Quản lý**.

![Danh sách contact](https://hatang.dev/help/img/vi/email/contacts.webp)

## Thêm contact

### Thêm từng người

1. Mở **Email → Danh sách nhận**.
2. Trong khung **Thêm liên hệ**, nhập địa chỉ email, **Tên** và **Họ**.
3. Nếu muốn, chọn segment để thêm contact vào.
4. Bấm **Thêm**.

Thêm một địa chỉ đã có sẽ cập nhật contact đó chứ không tạo contact thứ hai.

### Nhập từ file CSV

1. Chuẩn bị file CSV có dòng đầu là tên cột. Hạ Tầng đọc cột `email` (bắt buộc), `first_name`, `last_name`, `unsubscribed` và khoá của từng thuộc tính bạn đã tạo, theo thứ tự bất kỳ. Cột khác được bỏ qua.
2. Trong khung **Nhập CSV**, chọn file hoặc dán nội dung file, và nếu muốn thì chọn một segment để đưa tất cả vào.
3. Bấm **Nhập**.

Kết quả cho biết đã nhập bao nhiêu contact và bỏ qua bao nhiêu dòng (dòng không có địa chỉ hợp lệ). Địa chỉ đã có được cập nhật chứ không bị nhân đôi.

```text
email,first_name,last_name,city,tier
thuha@example.com,Hà,Nguyễn,Hà Nội,Vàng
quan.tran@example.com,Quân,Trần,TP. Hồ Chí Minh,Bạc
```

> [!WARNING]
> Chỉ nhập những người đã đồng ý nhận email của bạn: khách đã tích ô nhận bản tin, đăng ký tại cửa hàng, hoặc mới mua hàng gần đây. Danh sách mua lại hay thu thập trên mạng mang theo thư trả lại và báo spam, khiến toàn bộ email của bạn, kể cả xác nhận đơn hàng, nhanh chóng rơi vào thư rác.

Ở cột `unsubscribed`, giá trị `true`, `1`, `yes` hoặc `có` đánh dấu contact đã huỷ nhận mọi email; dùng cột này để mang theo danh sách huỷ đăng ký từ công cụ email cũ.

### Từ CRM

Nếu dùng module Khách hàng của Hạ Tầng, **Khách hàng → Đồng bộ sang Email** sao chép các khách có email thành contact. Việc đồng bộ không bao giờ đăng ký lại cho người đã huỷ đăng ký.

### Từ website

Lập trình viên có thể tạo hoặc cập nhật contact qua API mỗi khi có người đăng ký. Xem [hướng dẫn contact ở trang dành cho lập trình viên](https://hatang.dev/vi/docs/guides/email/audiences).

## Thuộc tính tuỳ chỉnh

Thuộc tính là các trường riêng của bạn trên contact, dùng để cá nhân hoá email và chọn ai nhận gì.

1. Mở tab **Thuộc tính**.
2. Nhập **Khoá** (chữ, số và `_`, ví dụ `city`), chọn **Loại** (`string` hoặc `number`) và điền **Fallback** nếu cần.
3. Bấm **Thêm thuộc tính**.

Dùng thuộc tính trong template hoặc chiến dịch email bằng `{{{contact.city}}}`. Contact chưa có giá trị sẽ nhận giá trị fallback, nên câu "Xin chào khách ở {{{contact.city}}}" không bao giờ bị trống. Thuộc tính phải được tạo trước khi nhập hay gán cho contact. Xoá thuộc tính sẽ xoá giá trị đó khỏi mọi contact.

## Làm việc với một contact

Bấm vào một địa chỉ trong danh sách để mở contact. Tại đây bạn có thể:

- sửa họ tên và giá trị thuộc tính ở **Thông tin**,
- xem và đổi các segment contact đang thuộc,
- xem lựa chọn của contact cho từng topic (hoặc mặc định của topic nếu họ chưa chọn),
- xem mọi email đã gửi tới contact kèm trạng thái,
- **Huỷ đăng ký** hoặc **Cho nhận lại**.

Muốn thêm nhiều contact vào một segment cùng lúc, tích chọn chúng trong danh sách rồi dùng **Thêm vào segment** ở dòng **Contact đã chọn**.

## Contact đã huỷ đăng ký

Contact bấm "huỷ nhận mọi email", hoặc được bạn huỷ đăng ký, hiện là **Đã huỷ đăng ký** và:

- không nhận chiến dịch email hay email automation nữa,
- được thêm vào danh sách chặn với lý do **huỷ đăng ký**, nên cả email xác nhận đơn hàng và mọi email khác tới địa chỉ đó cũng bị chặn.

Nếu người đó muốn nhận lại email, mở contact và bấm **Cho nhận lại**. Thao tác này cũng xoá địa chỉ khỏi danh sách chặn. Người chỉ muốn nhận ít thư hơn nên bỏ một topic thay vì huỷ tất cả; xem [Segment và topic](https://hatang.dev/vi/help/email/segments-and-topics).

## Thói quen tốt

- Dùng một danh sách contact cho cả doanh nghiệp, và chia nhóm bằng segment. Xoá segment không bao giờ xoá contact.
- Điền tên người nhận: "Chào chị Hà" được mở nhiều hơn "Chào bạn".
- Bỏ hoặc ngừng gửi cho người đã nhiều tháng không mở email nào. Họ kéo giảm tỉ lệ tương tác và uy tín của bạn với Gmail và các nhà cung cấp khác. Xem [Giữ email không vào thư rác](https://hatang.dev/vi/help/email/deliverability).