# Lịch sử email, số liệu và nhật ký

Biết chuyện gì đã xảy ra với từng email, xem tỉ lệ tới hộp thư, mở, click, bị trả lại và báo spam, và xem các lệnh gọi API từ website của bạn.

Hạ Tầng có ba góc nhìn về email của bạn. **Email** trả lời "lá thư này đã ra sao?", **Số liệu** trả lời "email của chúng ta nhìn chung có tốt không?", còn **Logs** cho thấy website hay ứng dụng của bạn đã yêu cầu Hạ Tầng làm gì, hữu ích khi email không hề được gửi đi.

## Email: lịch sử từng lá thư

**Email → Email** liệt kê mọi email doanh nghiệp đã gửi, mới nhất ở trên: từ website hay ứng dụng, qua SMTP relay, chiến dịch email và automation. Tìm theo người nhận, tiêu đề hoặc người gửi, và lọc theo trạng thái và nguồn (**API**, **SMTP**, **Chiến dịch email**).

| Trạng thái | Ý nghĩa |
|---|---|
| **Trong hàng đợi** | Đã nhận, sắp được gửi |
| **Đã lên lịch** | Đang chờ tới giờ đã hẹn |
| **Đã gửi** | Đã chuyển cho dịch vụ chuyển phát, đang chờ máy chủ nhận trả lời |
| **Đã gửi đến** | Máy chủ nhận đã chấp nhận thư |
| **Gửi chậm** | Máy chủ nhận tạm thời chưa nhận thư; hệ thống sẽ thử gửi lại |
| **Bị trả lại** | Bị từ chối hẳn, hoặc mọi người nhận đều nằm trong danh sách chặn |
| **Bị báo spam** | Người nhận đã báo thư là spam |
| **Đã huỷ** | Email hẹn giờ bị huỷ trước khi gửi |
| **Thất bại** | Không gửi được |

Mở một email để xem nội dung (HTML, văn bản và mã nguồn), trạng thái của từng người nhận, và mọi sự kiện kèm thời gian. Khi tên miền bật theo dõi mở hoặc nhấp, phần **Tương tác** hiện số lượt mở duy nhất và tổng, cùng số lượt nhấp trên từng link.

> [!NOTE]
> **Đã gửi đến** nghĩa là máy chủ thư của khách đã nhận email. Thư hiện ở hộp thư chính, thư rác hay tab Quảng cáo của Gmail là do nhà cung cấp hộp thư quyết định. Xem [Giữ email không vào thư rác](https://hatang.dev/vi/help/email/deliverability).

### "Khách không nhận được email"

1. Tìm địa chỉ của khách ở **Email → Email**.
2. Không có email nào: website hay ứng dụng chưa hề gửi. Xem phần **Logs** bên dưới, hoặc cài đặt SMTP relay trong ứng dụng.
3. **Bị trả lại**: mở email và đọc lý do. Nếu người nhận hiện **Bị chặn**, địa chỉ đang nằm trong danh sách chặn; xem [Danh sách chặn và thư bị trả lại](https://hatang.dev/vi/help/email/suppressions-and-bounces). Nếu không, nhiều khả năng địa chỉ bị gõ sai.
4. **Đã gửi đến**: thư đã tới máy chủ thư của khách. Nhờ khách xem thư mục spam và tab Quảng cáo, và thêm địa chỉ của bạn vào danh bạ.
5. **Gửi chậm**: máy chủ của khách đang tạm từ chối; Hạ Tầng tiếp tục thử lại.

## Số liệu: email của bạn hoạt động thế nào

**Email → Số liệu** hiện **7 ngày**, **14 ngày** hoặc **30 ngày** gần nhất, cho mọi tên miền hoặc một tên miền. Ngày tính theo giờ Việt Nam.

![Số liệu hai tuần: lượng thư mỗi ngày và biểu đồ bị trả lại, báo spam](https://hatang.dev/help/img/vi/email/metrics.webp)

| Chỉ số | Cách tính |
|---|---|
| **Đã gửi** | Số người nhận Hạ Tầng đã gửi tới, không tính người bị chặn và thư đã huỷ |
| **Tỉ lệ tới hộp thư** | Số thư tới nơi trên số đã gửi |
| **Tỉ lệ mở** | Số người mở ít nhất một lần, trên số thư tới nơi |
| **Tỉ lệ click** | Số người nhấp ít nhất một lần, trên số thư tới nơi |
| **Tỉ lệ bị trả lại** | Số thư bị trả lại trên số đã gửi, tính cả người nhận bị bỏ qua vì nằm trong danh sách chặn |
| **Tỉ lệ báo spam** | Số lần bị báo spam trên số thư tới nơi |

Biểu đồ bị trả lại có đường đứt ở mức **4%**, biểu đồ báo spam ở mức **0,08%**. Vượt các mức này, Gmail và Yahoo bắt đầu chặn bớt email của bạn hoặc cho vào thư rác. Nếu vượt ngưỡng, hãy dừng lại tìm nguyên nhân trước lần gửi lớn tiếp theo.

Tỉ lệ mở chỉ là ước tính. Apple Mail Privacy Protection và một số trình quét bảo mật tự tải ảnh dù không ai đọc, làm tỉ lệ mở cao lên; ứng dụng chặn ảnh làm tỉ lệ thấp đi. Hãy so sánh tỉ lệ mở giữa các email của chính bạn thay vì với doanh nghiệp khác. Lượt mở và lượt nhấp chỉ được ghi nhận khi tên miền gửi đã bật **Theo dõi mở** và **Theo dõi nhấp** (**Email → Tên miền**, rồi chọn tên miền).

## Logs: website của bạn đã yêu cầu gì

**Email → Logs** ghi lại mọi lệnh gọi tới API của Hạ Tầng bằng API key của doanh nghiệp trong **30 ngày** gần nhất, mới nhất ở trên: endpoint, kết quả, thời gian xử lý, key nào đã gọi và công cụ nào (SDK và phiên bản). Xem logs cần quyền **Developer** trong doanh nghiệp.

![Nhật ký API với một lệnh gửi bị từ chối (403) và một template không tồn tại (404)](https://hatang.dev/help/img/vi/email/logs.webp)

- Lọc theo trạng thái, phương thức, API key, đường dẫn hoặc user agent. **Mọi trạng thái** gồm cả lệnh thành công; lọc theo lỗi giúp tìm vấn đề nhanh.
- Mở một lệnh gọi để xem nội dung đã gửi và Hạ Tầng đã trả lời gì. Mật khẩu, token và API key trong đó được thay bằng `[redacted]`, tệp đính kèm được thay bằng dung lượng.
- Với lệnh gọi lỗi, nút **Chép để hỏi AI** sao chép request, response và link tài liệu, sẵn sàng dán vào trợ lý AI hoặc gửi cho lập trình viên.
- Thao tác từ chính dashboard không được ghi, thư gửi qua SMTP relay cũng không: hãy tìm chúng ở **Email**.

Các mã trả lời thường gặp:

| Mã | Ý nghĩa |
|---|---|
| `200` hoặc `202` | Đã xong |
| `401` | API key sai, đã bị thu hồi, hoặc không được dùng cho tên miền này |
| `403` "domain is not verified" | Địa chỉ người gửi không thuộc tên miền đã xác minh của doanh nghiệp, hoặc việc gửi đang tạm dừng |
| `404` | Template, contact hoặc email được yêu cầu không tồn tại |
| `422` | Request thiếu hoặc sai một trường; thông báo nói rõ trường nào |
| `429` | Gọi quá nhiều cùng lúc; website nên thử lại sau một chút |

Lập trình viên có thể lấy cùng các số liệu qua API, và tra mọi mã lỗi, trong [hướng dẫn số liệu và nhật ký ở trang dành cho lập trình viên](https://hatang.dev/vi/docs/guides/email/metrics-and-logs).