Gửi email qua tài khoản SendGrid của riêng bạn

Quý vị 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 mình.

Tài liệu 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 quý vị

Cài đặt (Settings) → Xác thực người gửi (Sender Authentication) → Xác thực tên miền của quý vị (Authenticate Your Domain).

Chọn nhà lưu trữ DNS của quý vị từ danh sách và trả lời Có (Yes) cho "Quý vị có muốn gắn thương hiệu cho các liên kết đối với tên miền này không?" — việc gắn thương hiệu liên kết sẽ viết lại các liên kết được theo dõi thành tên miền của chính quý vị thay vì sendgrid.net, và một khách hàng di chuột qua liên kết trong hóa đơn của quý vị sẽ nhìn thấy tên của quý vị.

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 mà quý vị gửi từ đó.

2. Công bố các bản ghi CNAME

SendGrid cung cấp cho quý vị ba hoặc năm bản ghi CNAME. Hãy thêm tất cả các bản ghi đó.

| Loại | Máy chủ | Mục đích | | --- | --- | --- | | CNAME | em1234.yourdomain.com | Tên miền đường dẫn trả về (báo trả) | | CNAME | s1._domainkey.yourdomain.com | Khóa DKIM 1 | | CNAME | s2._domainkey.yourdomain.com | Khóa DKIM 2 |

⭐ SendGrid sử dụng các bản ghi CNAME thay vì bản ghi TXT là có chủ đích, và điều đó thực sự tốt hơn: các giá trị khóa thực tế nằm ở SendGrid, vì vậy họ có thể xoay vòng các khóa ký của mình mà quý vị không cần phải chạm lại vào DNS của mình.

⚠️ Nếu nhà cung cấp DNS của quý vị là Cloudflare, hãy đặt các bản ghi này thành Chỉ DNS (DNS only) (đám mây màu xám), không bật proxy. Bản ghi 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 Xác minh (Verify) trong SendGrid. Hãy chờ tối đa một giờ.

3. Tạo khóa API

Cài đặt (Settings) → Khóa API (API Keys) → Tạo khóa API (Create API Key).

Chọn Truy cập bị hạn chế (Restricted Access) và chỉ cấp quyền Gửi thư (Mail Send) → Toàn quyền truy cập (Full Access). Không chọn bất kỳ mục nào khác.

⛔ Không sử dụng khóa Toàn quyền truy cập (Full Access). Khóa Toàn quyền truy cập có thể đọc danh sách liên hệ của quý vị, thay đổi cài đặt tài khoản của quý vị và tạo thêm khóa; điều duy nhất chúng ta cần làm là gửi một thông điệp. Nếu bản sao khóa của quý vị từng bị lộ, sự khác biệt giữa hai khóa đó chính là sự khác biệt giữa một số email không mong muốn và một tài khoản bị xâm phạm.

⚠️ Khóa chỉ được hiển thị một lần. Hãy sao chép khóa trước khi quý vị rời khỏi trang — SendGrid không thể hiển thị lại khóa cho quý vị, mà chỉ có thể thay thế khóa đó.

4. Kết nối khóa đó trong Zinn®

Mở mục Gửi email (Email sending) trong bảng điều khiển của quý vị:

• Nhà cung cấp (Provider) — SendGrid
• Gửi từ tên miền này (Send from this domain) — mail.yourdomain.com (một tên miền, không phải một địa chỉ)
• Khóa API SendGrid (SendGrid API key) — khóa từ bước 3

SendGrid không cần bất kỳ cài đặt nào khác từ quý vị.

5. Gửi thư kiểm tra và nhập mã

Nhấn Gửi thông điệp kiểm tra (Send test message) tới một hộp thư đến trên một tên miền khác, đọc mã từ đó và nhập mã vào.

Khi tính năng không hoạt động

403 Bị cấm (403 Forbidden) — khóa API của quý vị không có quyền Gửi thư (Mail Send). Đây là lỗi phổ biến nhất với khoảng cách lớn: một khóa Truy cập bị hạn chế (Restricted Access) được tạo ra mà không có phạm vi nào được tích chọn sẽ xác thực hoàn hảo và không được phép làm gì cả.

"Địa chỉ gửi không khớp với Danh tính người gửi đã được xác minh" ("The from address does not match a verified Sender Identity") — quá trình xác thực tên miền của quý vị chưa chuyển sang màu xanh lá cây hoặc tên miền trong mục Gửi từ tên miền này (Send from this domain) không phải là tên miền quý vị đã xác thực. SendGrid kiểm tra chính xác tên miền: việc xác thực mail.yourdomain.com không cho phép gửi từ yourdomain.com.

Đã chấp nhận nhưng không bao giờ được phân phối — hãy xem mục Hoạt động (Activity) trong SendGrid. Một tài khoản hoàn toàn mới đôi khi bị giữ lại để xem xét trong ngày đầu tiên hoặc khoảng thời gian đó, và các thông điệp nằm ở đó thay vì bị báo trả.

Tài khoản của quý vị đã 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ị báo trả. Hãy đảm bảo danh sách khách hàng của quý vị sạch sẽ trước khi quý vị chuyển đổi.