Gửi email qua SMTP

SMTP relay của Banger cho phép ứng dụng chỉ gửi qua SMTP, như Supabase Auth, Auth0, WordPress hoặc bộ gửi thư của framework, gửi qua Banger. Ứng dụng đăng nhập bằng khóa API Banger, mọi thư gửi từ tên miền riêng và xuất hiện trong Nhật ký.

Trước khi bắt đầu

Bạn cần hai thứ:

1. Luồng Sản phẩm. Địa chỉ From phải trên tên miền hoặc tên miền phụ có luồng Sản phẩm sẵn sàng. Mở Tên miền › Thêm luồng, chọn Sản phẩm và thêm bản ghi DNS được liệt kê. Xem Thêm tên miền. Luồng Thư (hộp thư nhóm) hoặc Chiến dịch không thể gửi email ứng dụng, nên thư ứng dụng không ảnh hưởng uy tín hộp thư nhóm.
2. Khóa API được gửi. Mở Khóa API › Tạo khóa API, đặt tên theo ứng dụng (ví dụ “Supabase Auth”), chỉ chọn mail:send rồi Tạo khóa. Sao chép ngay: khóa chỉ hiển thị một lần.

Bạn cũng có thể đến Khóa API từ Cài đặt › Nhà phát triển › Quản lý khóa API.

Cài đặt SMTP

Ô SMTP trên trang Khóa API hiển thị các cài đặt này, kèm nút sao chép host.

Nếu ứng dụng hỏi “SSL” hoặc “TLS”, dùng cổng 465. Nếu hỏi “STARTTLS”, dùng 587.

Kết nối Supabase Auth

1. Trong Supabase, mở Authentication › Emails › SMTP Settings và bật SMTP tùy chỉnh.
2. Email người gửi: địa chỉ trên luồng Sản phẩm, như noreply@app.example.com.
3. Tên người gửi: tên sản phẩm. Banger giữ nguyên như đã viết.
4. Host submit.bangermail.com, Port 465, Username banger, Password là khóa API.
5. Lưu rồi gửi magic link cho chính bạn từ Authentication › Users.

Ứng dụng khác làm tương tự: dán cài đặt trên vào phần SMTP hoặc thư. Ví dụ mã trong tài liệu SMTP cho nhà phát triển.

Kiểm tra thành công

Mở Nhật ký. Mỗi thư ứng dụng gửi xuất hiện với nguồn SMTP và trạng thái giao. Banger cũng ghi mọi lần thử bị từ chối cùng cách sửa.

Ứng dụng nhận 250 2.0.0 Queued as … khi Banger chấp nhận thư.

Banger làm gì với từng thư

• Gửi đúng nội dung ứng dụng viết, với tên From, ký bằng khóa DKIM tên miền.
• Xóa Bcc và Return-Path, thêm Reply-To trỏ đến địa chỉ From khi chưa có.
• Bỏ qua người nhận bị chặn gửi và gửi cho người còn lại.
• Coi việc thử lại cùng thư là cùng lần gửi, nên timeout không gây gửi hai lần.
• Tính mỗi thư vào gói như mọi lần gửi khác.

Mỗi thư tối đa 10 MiB và tối đa 50 người nhận.

Khi thư bị từ chối

Mỗi lần từ chối nêu lý do và mã tham chiếu (ref …) khớp mục trong Nhật ký. Mã bắt đầu bằng 4 là tạm thời; ứng dụng có thể thử lại sau.

Giữ khóa an toàn

• Cấp khóa riêng cho mỗi ứng dụng, chỉ có mail:send. Nếu mật khẩu SMTP lộ, nó không thể đọc không gian làm việc.
• Để đổi khóa, tạo khóa mới, cập nhật ứng dụng rồi Thu hồi khóa cũ. Ứng dụng còn dùng khóa cũ bị từ chối ở lần đăng nhập kế tiếp.
• Banger chỉ lưu hàm băm của khóa và ghi đăng nhập bị từ chối trong Nhật ký.

Thử với AI

Tạo khóa API chỉ được gửi thư, kiểm tra luồng Sản phẩm đã sẵn sàng và cho tôi cài đặt SMTP để dán vào Supabase.