Persetujuan, Log & pengiriman
Kirim email lewat SMTP
Hubungkan Supabase Auth, WordPress, atau aplikasi SMTP apa pun ke Banger agar email dikirim dari domain Anda dan muncul di Log.
Dalam panduan ini 8 bagian
Relay SMTP Banger memungkinkan aplikasi yang hanya bisa mengirim lewat SMTP, seperti Supabase Auth, Auth0, WordPress, atau pengirim email framework Anda, mengirim melalui Banger. Aplikasi masuk dengan kunci API Banger, dan setiap pesan dikirim dari domain sendiri serta muncul di Log.
Sebelum memulai
Anda membutuhkan dua hal:
- Jalur Produk. Alamat From harus berada pada domain atau subdomain dengan jalur Produk siap. Buka Domain › Tambah jalur, pilih Produk, dan tambahkan data DNS yang ditampilkan. Lihat Tambahkan domain Anda. Jalur Email (kotak surat tim) atau Kampanye tidak bisa mengirim email aplikasi, sehingga email aplikasi tidak memengaruhi reputasi kotak masuk tim.
- Kunci API yang bisa mengirim. Buka Kunci API › Buat kunci API, beri nama sesuai aplikasi (misalnya “Supabase Auth”), pilih hanya
mail:send, lalu pilih Buat kunci. Salin segera: kunci ditampilkan sekali.
Anda juga bisa membuka Kunci API dari Pengaturan › Pengembang › Kelola kunci API.
Pengaturan SMTP
Kotak SMTP pada halaman Kunci API menampilkan pengaturan ini, dengan tombol salin untuk host.
| Pengaturan | Nilai |
|---|---|
| Host | submit.bangermail.com |
| Port | 465 (TLS) atau 587 (STARTTLS) |
| Port jika yang di atas diblokir | 2465 (TLS) atau 2587 (STARTTLS) |
| Nama pengguna | banger (nilai apa pun boleh; kunci mengidentifikasi ruang kerja Anda) |
| Kata sandi | Kunci API Anda |
| Enkripsi | TLS 1.2 atau lebih baru. Login hanya ditawarkan setelah TLS dimulai. |
| Autentikasi | PLAIN atau LOGIN |
Jika aplikasi meminta “SSL” atau “TLS”, gunakan port 465. Jika meminta “STARTTLS”, gunakan 587.
Hubungkan Supabase Auth
- Di Supabase, buka Authentication › Emails › SMTP Settings dan aktifkan SMTP khusus.
- Email pengirim: alamat pada jalur Produk Anda, seperti
noreply@app.example.com. - Nama pengirim: nama produk Anda. Banger mempertahankan persis tulisannya.
- Host
submit.bangermail.com, Port465, Nama penggunabanger, Kata sandi kunci API Anda. - Simpan, lalu kirim magic link ke diri sendiri dari Authentication › Users.
Aplikasi lain bekerja dengan cara yang sama: tempel pengaturan di atas ke pengaturan SMTP atau emailnya. Contoh kode ada di dokumentasi SMTP untuk pengembang.
Periksa hasilnya
Buka Log. Setiap pesan yang dikirim aplikasi muncul dengan SMTP sebagai sumber dan status pengirimannya. Banger juga mencatat semua upaya yang ditolak, beserta perbaikannya.
Aplikasi menerima 250 2.0.0 Queued as … saat Banger menerima pesan.
Yang dilakukan Banger pada setiap pesan
- Mengirim sesuai tulisan aplikasi, dengan nama From Anda, ditandatangani menggunakan kunci DKIM domain.
- Menghapus
BccdanReturn-Path, serta menambahkanReply-Toberisi alamat From jika belum ada. - Melewati penerima yang disupresi dan mengirim ke sisanya.
- Memperlakukan percobaan ulang pesan yang sama sebagai pengiriman yang sama, sehingga timeout tidak membuatnya terkirim dua kali.
- Menghitung setiap pesan dalam kuota paket, seperti pengiriman lain.
Setiap pesan bisa berukuran hingga 10 MiB dengan hingga 50 penerima.
Saat pesan ditolak
Setiap penolakan menyebutkan alasan dan menyertakan referensi, (ref …), yang cocok dengan entri di Log. Kode yang dimulai dengan 4 bersifat sementara; aplikasi bisa mencoba lagi nanti.
| Balasan | Yang harus dilakukan |
|---|---|
535 5.7.8 | Kata sandi bukan kunci API yang berfungsi. Pastikan belum dicabut dan memiliki mail:send. |
421 4.7.0 | Tiga login gagal pada satu koneksi membuatnya ditutup. Perbaiki kunci sebelum mencoba lagi. |
454 4.7.0 | Terlalu banyak login gagal dari jaringan Anda. Perbaiki kunci, lalu tunggu hingga satu jam. |
550 5.7.1 | Domain From tidak memiliki jalur Produk siap (balasan menyebutkan kekurangannya), penerima disupresi, atau pengiriman dijeda. Lihat Keterkiriman dan jeda pengiriman. |
553 5.1.3 | Alamat penerima tidak valid. |
552 5.3.4 | Pesan lebih besar dari 10 MiB. |
554 5.6.0 | Format pesan salah, seperti dua header From atau From dengan beberapa alamat. |
451 4.7.0 | Kuota pengiriman atau batas harian habis. Diperbarui pada periode atau hari berikutnya, atau sekarang dengan peningkatan paket. |
451 4.3.0 | Banger belum bisa menerima pesan sekarang. Aplikasi harus mencoba lagi. |
Jaga keamanan kunci
- Berikan kunci tersendiri untuk setiap aplikasi, hanya dengan
mail:send. Kata sandi SMTP yang bocor tidak bisa membaca ruang kerja Anda. - Untuk mengganti, buat kunci baru, perbarui aplikasi, lalu Cabut yang lama. Aplikasi yang masih menggunakannya ditolak pada login berikutnya.
- Banger hanya menyimpan hash setiap kunci dan mencatat login ditolak di Log.
Coba dengan AI Anda
Buat kunci API yang hanya bisa mengirim email, periksa jalur Produk saya sudah siap, dan berikan pengaturan SMTP untuk ditempel di Supabase.