Gửi qua SMTP relay
Kế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.
Cập nhật ngày
Trong bài này
Nhiều công cụ gửi được email nhưng không gọi được API: WordPress và WooCommerce, phần mềm kế toán, phần mềm bán hàng, form liên hệ trên website, máy scan. Trỏ chúng tới SMTP relay của Hạ Tầng là email được gửi từ tên miền đã xác minh của bạn, với cùng cơ chế chuyển phát, theo dõi và nhật ký như mọi email khác. Mỗi thư hiện ở Email → Email kèm trạng thái.
Trước khi bắt đầu
- Một tên miền gửi đã xác minh. Relay chỉ nhận địa chỉ người gửi thuộc tên miền đã xác minh trong doanh nghiệp của bạn. Xem Thêm và xác minh tên miền gửi.
- Một API key có quyền Gửi. Key này chính là mật khẩu SMTP. Tạo key cần quyền Developer trong doanh nghiệp; xem API key.
Thông số kết nối
| Thông số | Giá trị |
|---|---|
| Máy chủ SMTP (host) | smtp.hatang.dev |
| Cổng | 5870 |
| Mã hoá | STARTTLS (một số ứng dụng gọi là "TLS") |
| Tên đăng nhập | hatang |
| Mật khẩu | API key của bạn (bắt đầu bằng ht_) |
| Xác thực | Bật (PLAIN hoặc LOGIN) |
Host, cổng, tên đăng nhập và Mã hoá (STARTTLS) cũng có ở Email → Cài đặt email → Thông tin kết nối, kèm khối cấu hình để sao chép. Trong mã nguồn, STARTTLS nghĩa là secure: false (SMTP_SECURE=false): kết nối vẫn được mã hoá, chỉ là bắt đầu bằng kết nối thường.
Relay từ chối đăng nhập khi kết nối chưa được mã hoá, nên API key của bạn không bao giờ đi qua mạng ở dạng đọc được.
Tạo key
- Mở Email → API Keys và bấm Tạo key.
- Đặt tên theo ứng dụng sẽ dùng key, ví dụ
Website WordPress. - Trong Key này có thể làm gì, chỉ tích Gửi của Email. Key chỉ có quyền gửi thì dù bị lộ cũng không đọc được danh sách liên hệ hay sửa tên miền của bạn.
- Nếu muốn, giới hạn Tên miền gửi ở đúng tên miền ứng dụng này dùng.
- Bấm Tạo key và sao chép key ngay: key sẽ không hiển thị lại.
Mỗi ứng dụng nên có key riêng, để khi cần thu hồi một key thì các ứng dụng khác không bị ảnh hưởng.
WordPress với WP Mail SMTP
-
Cài plugin WP Mail SMTP rồi mở WP Mail SMTP → Settings.
-
Đặt From Email là một địa chỉ thuộc tên miền đã xác minh, ví dụ
[email protected], và bật Force From Email. -
Ở Mailer, chọn Other SMTP.
-
Điền:
Ô Giá trị SMTP Host smtp.hatang.devEncryption TLS (trong WP Mail SMTP đây chính là STARTTLS) SMTP Port 5870Auto TLS Bật Authentication Bật SMTP Username hatangSMTP Password API key của bạn -
Lưu, rồi gửi thử ở WP Mail SMTP → Tools → Email Test.
Vài giây sau, thư thử hiện ở Email → Email. Từ đó email đơn hàng của WooCommerce cũng đi qua Hạ Tầng.
Ứng dụng khác
Tìm phần cài đặt "SMTP", "thư đi" hoặc "máy chủ thư" và nhập các giá trị trong bảng trên. Những điểm cần kiểm tra:
- Địa chỉ người gửi: luôn là địa chỉ thuộc tên miền đã xác minh. Ứng dụng gửi bằng
wordpress@tenhostinghayroot@localhostsẽ bị từ chối cho tới khi bạn đổi địa chỉ. - Mã hoá: STARTTLS hoặc "TLS", không dùng SSL.
- Người nhận: luôn có ít nhất một địa chỉ ở ô To. Nếu thư chỉ có người nhận Bcc, Hạ Tầng chuyển người đầu tiên sang To, và những người còn lại sẽ thấy địa chỉ đó.
Lập trình viên có sẵn cấu hình cho Laravel, Django, Rails, Spring Boot, Nodemailer, PHPMailer và Postfix trong hướng dẫn SMTP ở trang dành cho lập trình viên.
Giới hạn
| Giới hạn | Giá trị |
|---|---|
| Người nhận mỗi thư | 50 |
| Dung lượng thư | 40 MB |
| Đăng nhập sai | Sau 10 lần đăng nhập sai từ một địa chỉ IP, địa chỉ đó bị từ chối đăng nhập trong 15 phút |
| Hạn mức hằng ngày | Dùng chung với mọi email khác bạn gửi: mỗi thư tính là một email. Xem Cài đặt email |
Khi không gửi được
| Ứng dụng báo | Nguyên nhân | Cách xử lý |
|---|---|---|
| Quá thời gian kết nối | Sai cổng, hoặc chọn SSL/implicit TLS | Dùng cổng 5870 với STARTTLS |
535 xác thực thất bại |
Mật khẩu không phải API key hợp lệ, hoặc key đã bị thu hồi | Dán lại key, hoặc tạo key mới |
421 quá nhiều lần xác thực sai |
10 lần đăng nhập sai từ địa chỉ máy chủ của bạn | Sửa mật khẩu, chờ 15 phút rồi thử lại |
550 kèm "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 này | Xác minh tên miền, hoặc đổi địa chỉ người gửi |
550 kèm "does not have the email:send scope" |
Key không có quyền Gửi | Tạo key có quyền Gửi |
550 vì đang tạm dừng gửi |
Có người đã tạm dừng gửi ở Cài đặt email | Bấm Tiếp tục gửi khi đã an toàn |
452 quá nhiều người nhận |
Một thư có hơn 50 người nhận | Tách thành nhiều thư |
451 lỗi tạm thời |
Sự cố tạm thời, ví dụ đã dùng hết hạn mức trong ngày | Thử lại sau; các máy chủ thư tự thử lại |
Mọi thư relay đã nhận đều có trong Email → Email với nguồn SMTP. Nếu không thấy thư ở đó, ứng dụng chưa hề kết nối được tới Hạ Tầng: xem nhật ký của ứng dụng để tìm một trong các mã lỗi ở trên.
Bước tiếp theo
Bài viết này có giúp ích cho bạn không?
Bài viết liên quan
- Thêm và xác minh tên miền gửiThêm tên miền dùng để gửi email, khai báo các bản ghi DKIM, SPF, return path và DMARC, rồi xác minh để email vào hộp thư chính.
- 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.
- API keyTạo khoá để phần mềm của lập trình viên dùng Hạ Tầng, chỉ cấp cho mỗi khoá đúng quyền nó cần, và thu hồi ngay khoá bị lộ.
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 →