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.
Cập nhật ngày
Trong bài này
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.
"Khách không nhận được email"
- Tìm địa chỉ của khách ở Email → Email.
- 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.
- 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. Nếu không, nhiều khả năng địa chỉ bị gõ sai.
- Đã 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ạ.
- 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.

| 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.

- 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.
Bài viết này có giúp ích cho bạn không?
Bài viết liên quan
- Giữ email không vào thư rácVì sao email rơi vào thư rác hay tab Quảng cáo và cách khắc phục, với SPF, DKIM, DMARC, khởi động từ từ trên tên miền mới, danh sách sạch và các chỉ số cần theo dõi.
- Danh sách chặn và thư bị trả lạiVì sao Hạ Tầng ngừng gửi tới một số địa chỉ (trả lại cứng, báo spam, huỷ đăng ký, chặn thủ công), chuyện gì xảy ra khi bạn vẫn gửi, và khi nào nên gỡ chặn.
- Gửi qua SMTP relayKết nối WordPress, phần mềm bán hàng hoặc bất kỳ ứng dụng nào gửi email qua SMTP với Hạ Tầng bằng smtp.hatang.dev, cổng 5870 và một API key.
Chưa tìm thấy điều bạn cần?
Đội ngũ của chúng tôi trả lời qua chat, bằng tiếng Việt hoặc tiếng Anh.
Bạn đang tích hợp API hoặc SDK? Xem tài liệu cho lập trình viên →