# Nhận email trên tên miền của bạn

Bật nhận email cho một tên miền để thư gửi tới mọi địa chỉ trên đó được lưu trong Hạ Tầng và chuyển tới hệ thống của bạn, và biết khi nào nên dùng hộp thư hỗ trợ thay thế.

Bật nhận email để một tên miền vừa gửi vừa nhận được thư. Mọi thư gửi tới bất kỳ địa chỉ nào trên tên miền đó, như `orders@inbound.mochuong.vn` hay `hoadon@inbound.mochuong.vn`, được Hạ Tầng lưu trong 30 ngày và báo cho hệ thống của bạn qua webhook `email.received`. Tính năng này hợp với thư tự động: hoá đơn nhà cung cấp cần xử lý, thư trả lời cần đọc, form gửi về qua email.

> [!TIP]
> Nếu đội ngũ của bạn cần đọc và trả lời email của khách, hãy kết nối email vào Hộp thư: xem [Email hỗ trợ](https://hatang.dev/vi/help/channels/email-channel). Nhân viên trả lời ngay trong Hạ Tầng như mọi kênh khác, và bạn không cần lập trình viên.
>
> Tên miền đã bật nhận email? Thêm địa chỉ hỗ trợ trên tên miền đó (ví dụ `cskh@`) làm kênh email hỗ trợ: email tới đúng địa chỉ đó vào thẳng Hộp thư mà không cần chuyển tiếp, các địa chỉ còn lại vẫn nằm ở đây.

Bật hoặc tắt nhận email cần quyền **Quản lý** trong module Email.

## Chọn tên miền

Bản ghi MX của tên miền quyết định mọi thư của tên miền đó đi đâu. Bật nhận email nghĩa là trỏ MX về Hạ Tầng, vì vậy:

- **Đừng** dùng tên miền có hộp thư đang chạy trên Google Workspace, Microsoft 365, Mắt Bão Mail hay dịch vụ khác: thư sẽ không về đó nữa. Hạ Tầng từ chối bật nhận email khi tên miền đã có bản ghi MX trỏ đi nơi khác.
- **Nên** dùng một tên miền phụ riêng như `inbound.mochuong.vn`. Thêm tên miền phụ ở **Email → Tên miền** và xác minh như một tên miền gửi. Xem [Thêm và xác minh tên miền gửi](https://hatang.dev/vi/help/email/add-domain).

Tên miền đang được một hộp thư hỗ trợ trong module **Hỗ trợ khách hàng** dùng để nhận thư cũng không dùng được cho việc này.

## Bật nhận email

1. Mở **Email → Tên miền** và bấm vào tên miền.
2. Trong khung **Nhận thư**, bấm **Bật**.
3. Bảng bản ghi có thêm dòng **Nhận thư**: một bản ghi MX trên chính tên miền, ưu tiên `10`, trỏ tới máy chủ hiện trên trang. Thêm bản ghi này ở nhà cung cấp DNS. Xem [Thêm bản ghi DNS ở nhà cung cấp tên miền](https://hatang.dev/vi/help/email/dns-by-provider).
4. Bấm **Kiểm tra lại DNS**. Khi bản ghi nhận thư đã xác minh, thư gửi tới tên miền bắt đầu về.

Bản ghi nhận thư không ảnh hưởng tới việc gửi: tên miền vẫn gửi bình thường kể cả khi bản ghi này còn đang chờ.

## Xem thư đã nhận

Thư nhận được nằm ở **Email → Email**, tab **Nhận về**, mới nhất ở trên. Mở một thư để đọc, kèm người gửi, người nhận, header và tệp đính kèm. Link **Xem thư đến** trên trang tên miền cũng dẫn tới đó.

Những điều cần biết:

- Thư gửi tới **mọi** địa chỉ trên tên miền đều được nhận; không cần tạo trước danh sách hộp thư.
- Thư bị dịch vụ nhận thư đánh dấu spam vẫn được lưu và gắn nhãn **Spam**, nhưng không kích hoạt webhook, giống một thư mục thư rác. Thư có virus bị loại bỏ.
- Thư và tệp đính kèm được giữ **30 ngày** rồi xoá. Hãy sao chép những gì cần giữ lâu hơn.

## Chuyển thư tới hệ thống của bạn

Để xử lý tự động từng thư, thêm webhook nghe sự kiện `email.received`:

1. Mở **Email → Webhooks** và bấm **Thêm endpoint**.
2. Nhập địa chỉ endpoint của bạn và tích `email.received`.

Webhook mang theo phần tóm tắt (người gửi, người nhận, tiêu đề, danh sách tệp đính kèm). Lập trình viên lấy nội dung và tệp đính kèm qua API; xem [hướng dẫn nhận email ở trang dành cho lập trình viên](https://hatang.dev/vi/docs/guides/email/receiving). Các công cụ no-code như Make, Zapier hay n8n cũng nhận được webhook này; xem [Webhook](https://hatang.dev/vi/help/integrations/webhooks).

## Tắt nhận email

Bấm **Tắt** trong khung **Nhận thư**, rồi xoá bản ghi MX ở nhà cung cấp DNS. Thư đã nhận vẫn xem được cho tới khi hết 30 ngày.

## Xử lý sự cố

| Hiện tượng | Nguyên nhân | Cách xử lý |
|---|---|---|
| **Bật** báo lỗi "already receives mail at…" | MX của tên miền đang trỏ tới dịch vụ thư khác | Dùng tên miền phụ như `inbound.tenmiencuaban` |
| **Bật** báo lỗi "A support mailbox in Chat already receives…" | Một hộp thư hỗ trợ trong module **Hỗ trợ khách hàng** đang dùng tên miền này | Dùng tên miền phụ khác, hoặc giữ tên miền đó cho Hộp thư |
| Không có thư nào về | Thiếu bản ghi MX nhận thư hoặc bản ghi chưa xác minh | Xem dòng **Nhận thư** trên trang tên miền và bấm **Kiểm tra lại DNS** |
| Thư có trong danh sách nhưng hệ thống của bạn không nhận được | Thư bị đánh dấu spam, hoặc endpoint webhook bị lỗi | Xem nhãn **Spam** trên thư, và các lượt gửi ở **Email → Webhooks** |