Email Không Đến: Hướng Dẫn Debug Cho Lập Trình Viên

Vấn đề thất bại im lặng

Bạn gửi email qua API. Trả về 200 OK. Dashboard hiển thị 'sent.' Nhưng người dùng nói không nhận được. Đây là vấn đề email khó chịu nhất vì không có lỗi để debug. Email rời server thành công, được nhà cung cấp chấp nhận, và sau đó... biến mất.

Bước 1: Kiểm tra trạng thái gửi (không chỉ trạng thái API)

'Sent' không có nghĩa 'delivered.' Khi API trả về 200, email được chấp nhận để gửi — không phải đã đến inbox. Pipeline: queued → sending → sent → delivered (hoặc bounced/failed). Bạn cần kiểm tra trạng thái cuối, không chỉ chấp nhận ban đầu. Trong AISend, trang chi tiết email hiển thị timeline sự kiện đầy đủ.

// Kiểm tra trạng thái gửi
const { id } = await aisend.emails.send({ from, to, subject, html });

const email = await aisend.emails.get(id);
console.log(email.status);
// "queued" | "sent" | "delivered" | "bounced" | "failed"

Bước 2: Kiểm tra bounce và complaint

Nếu trạng thái là 'bounced', server nhận đã từ chối email. Hard bounce: địa chỉ không tồn tại — xóa ngay. Soft bounce: vấn đề tạm thời — thử lại một lần. 'Complained': người nhận đánh dấu spam — tín hiệu danh tiếng nghiêm trọng. Kiểm tra AISend dashboard cho bounce và complaint events.

Bước 3: Kiểm tra xác thực và spam scoring

Nếu email hiển thị 'delivered' nhưng người dùng không tìm thấy, gần như chắc chắn trong spam. Yêu cầu người dùng kiểm tra spam/junk. Nếu ĐÚNG trong spam: gửi email thử đến Gmail, mở, nhấn ba chấm, chọn 'Hiển thị bản gốc' — tìm 'spf=pass', 'dkim=pass', 'dmarc=pass'.

Bước 4: Kiểm tra danh tiếng người gửi

ISP duy trì điểm danh tiếng cho tên miền và IP. Danh tiếng thấp = spam. Kiểm tra với Google Postmaster Tools và Microsoft SNDS. AISend định tuyến qua nhiều nhà cung cấp — nếu danh tiếng một nhà cung cấp giảm, email tự động chuyển qua nhà cung cấp khỏe mạnh hơn.

Checklist debug (dùng mỗi lần)

1. Kiểm tra API response — email được chấp nhận? 2. Kiểm tra trạng thái gửi — queued, sent, hay delivered? 3. Kiểm tra bounce — server nhận từ chối? 4. Kiểm tra spam folder. 5. Kiểm tra xác thực — SPF, DKIM, DMARC pass? 6. Kiểm tra nội dung — có kích hoạt spam? 7. Kiểm tra danh tiếng — tên miền có trong blacklist? AISend dashboard hiển thị bước 1-5 trong một view.