Bạn sẽ cần một tài khoản SendGrid (Twilio SendGrid) và quyền truy cập vào DNS của tên miền của bạn.
Tài liệu hướng dẫn riêng của SendGrid: Xác thực người gửi · Khóa API · Đăng ký
1. Xác thực tên miền của bạn
Settings → Sender Authentication → Authenticate Your Domain.
Chọn nhà cung cấp DNS của bạn từ danh sách, và trả lời Yes cho câu hỏi "Would you like to also brand the links for this domain?" — việc gắn thương hiệu cho liên kết (link branding) sẽ viết lại các liên kết được theo dõi thành tên miền của riêng bạn thay vì sendgrid.net, và một khách hàng khi di chuột qua liên kết trong hóa đơn của bạn sẽ thấy tên của bạn.
Nhập một tên miền phụ (subdomain) chẳng hạn như mail.yourdomain.com khi được hỏi về tên miền bạn dùng để gửi.
2. Xuất bản các bản ghi CNAME
SendGrid cung cấp cho bạn ba hoặc năm bản ghi CNAME. Hãy thêm tất cả các bản ghi này.
| Loại | Máy chủ (Host) | Mục đích |
|---|
CNAME | em1234.yourdomain.com | Tên miền Return-path (bounce) |
CNAME | s1._domainkey.yourdomain.com | Khóa DKIM 1 |
CNAME | s2._domainkey.yourdomain.com | Khóa DKIM 2 |
⭐ SendGrid chủ ý sử dụng CNAME thay vì các bản ghi TXT, và điều này thực sự tốt hơn: các giá trị khóa thực tế nằm tại SendGrid, do đó họ có thể xoay vòng các khóa ký mà bạn không cần phải chạm vào DNS của mình lần nữa.
⚠️ Nếu nhà cung cấp DNS của bạn là Cloudflare, hãy đặt các bản ghi này thành DNS only (đám mây màu xám), không bật proxy. Một CNAME được bật proxy sẽ phân giải thành các địa chỉ của Cloudflare và quá trình kiểm tra của SendGrid sẽ thất bại.
Nhấn Verify trong SendGrid. Vui lòng đợi tối đa một giờ.
3. Tạo một khóa API
Settings → API Keys → Create API Key.
Chọn Restricted Access và chỉ cấp quyền Mail Send → Full Access. Không cấp bất kỳ quyền nào khác.
⛔ Không sử dụng khóa Full Access. Một khóa Full Access có thể đọc danh bạ của bạn, thay đổi cài đặt tài khoản của bạn và tạo thêm nhiều khóa; điều duy nhất chúng tôi cần làm là gửi một thư. Nếu bản sao khóa của bạn tại hệ thống của chúng tôi bị lộ, sự khác biệt giữa hai loại khóa này là sự khác biệt giữa một vài email không mong muốn và một tài khoản bị xâm phạm hoàn toàn.
⚠️ Khóa chỉ được hiển thị một lần duy nhất. Hãy sao chép khóa trước khi bạn rời khỏi trang — SendGrid không thể hiển thị lại cho bạn, mà chỉ có thể thay thế nó.
4. Kết nối khóa trong Zinn®
Mở Gửi email trong bảng điều khiển của bạn:
- Nhà cung cấp — SendGrid
- Gửi từ tên miền này —
mail.yourdomain.com (một tên miền, không phải một địa chỉ email)
- Khóa API SendGrid — khóa lấy từ bước 3
SendGrid không cần bất kỳ cài đặt nào khác từ bạn.
5. Gửi thư thử nghiệm và nhập mã
Nhấn Gửi thư thử nghiệm tới một hộp thư đến thuộc tên miền khác, đọc mã trong thư đó và nhập mã vào.
Khi hệ thống không hoạt động
403 Forbidden — khóa API của bạn không có quyền Mail Send. Đây là lỗi phổ biến nhất vượt trội: một khóa Restricted Access được tạo mà không tích chọn bất kỳ phạm vi quyền nào vẫn xác thực hoàn hảo nhưng không được phép thực hiện bất kỳ thao tác nào.
"The from address does not match a verified Sender Identity" — quá trình xác thực tên miền của bạn vẫn chưa chuyển sang màu xanh lá, hoặc tên miền trong Gửi từ tên miền này không phải là tên miền bạn đã xác thực. SendGrid kiểm tra chính xác từng tên miền: việc xác thực mail.yourdomain.com không đồng nghĩa với việc cho phép gửi từ yourdomain.com.
Đã chấp nhận nhưng không bao giờ được gửi đi (Accepted but never delivered) — hãy xem mục Activity trong SendGrid. Một tài khoản hoàn toàn mới đôi khi bị tạm giữ để xem xét trong khoảng ngày đầu tiên, và các thư sẽ nằm chờ ở đó thay vì bị trả về (bounce).
Tài khoản của bạn bị tạm ngưng sau một vài lần gửi — SendGrid rất nghiêm ngặt đối với các tài khoản mới gửi đến các địa chỉ bị trả về (bounce). Hãy đảm bảo danh sách khách hàng của bạn hoàn toàn sạch sẽ trước khi chuyển đổi.