Rab. Nov 18th, 2026
Meja developer dengan laptop menampilkan kode template email Rails dan catatan tulisan tangan

Action Mailer adalah komponen Rails yang mengurus pengiriman email dari aplikasi kamu, mulai dari reset password, konfirmasi pendaftaran, sampai invoice transaksional. Panduan action mailer ruby on rails ini membahas cara menyiapkan konfigurasi SMTP, membuat mailer pertama, mengirim email HTML dan teks biasa, serta mengujinya tanpa risiko mengirim email sungguhan ke pengguna.

Menyiapkan Konfigurasi SMTP di Rails

Konfigurasi email di Rails ada di config/environments/. Untuk development, Rails sudah menyiapkan letter_opener atau mode :test yang menahan email agar tidak benar-benar dikirim. Di production kamu perlu mengisi detail SMTP penyedia layanan.

# config/environments/production.rb
config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address: ENV["SMTP_ADDRESS"],
  port: 587,
  user_name: ENV["SMTP_USERNAME"],
  password: ENV["SMTP_PASSWORD"],
  authentication: "plain",
  enable_starttls_auto: true
}
config.action_mailer.default_url_options = { host: "contoh.com", protocol: "https" }

Jangan pernah menulis kredensial langsung di file konfigurasi. Simpan di environment variable atau Rails credentials supaya tidak ikut masuk ke repository. Nilai default_url_options wajib diisi karena link di dalam email perlu URL absolut, bukan path relatif.

Membuat Mailer Pertama

Generator Rails menyiapkan kerangka mailer beserta view-nya.

bin/rails generate mailer UserMailer welcome

Perintah itu membuat app/mailers/user_mailer.rb dan dua view: welcome.html.erb serta welcome.text.erb. Isi method-nya seperti ini:

class UserMailer < ApplicationMailer
  def welcome(user)
    @user = user
    mail(to: user.email, subject: "Selamat datang di aplikasi kami")
  end
end

Panggil dari controller atau service object dengan UserMailer.welcome(@user).deliver_later. Method deliver_later menitipkan pengiriman ke Active Job sehingga request HTTP tidak tertahan menunggu server SMTP merespons. Untuk kasus yang memang harus segera terkirim dan kamu tidak memakai background job, gunakan deliver_now.

Format Email: HTML dan Teks Biasa

Kirim dua versi view sekaligus supaya klien email yang memblokir HTML tetap bisa membaca isi pesan. Rails otomatis memilih versi yang sesuai berdasarkan konten yang tersedia. Di dalam template HTML, gunakan helper link_to seperti biasa, tapi pastikan semua URL memakai _url bukan _path.

Styling email punya aturan sendiri. Banyak klien email tidak membaca file CSS eksternal, jadi tulis style secara inline di tag HTML. Lebar maksimal 600 piksel dan layout tabel masih jadi pilihan paling aman untuk kompatibilitas.

Menguji Email Tanpa Mengirim ke Pengguna

Di development, tambahkan gem letter_opener supaya email terbuka di browser alih-alih terkirim. Di test, Rails sudah memakai :test sebagai delivery method default, dan email tersimpan di ActionMailer::Base.deliveries.

Menulis test untuk mailer tidak jauh berbeda dengan test controller. Kalau kamu baru mulai dengan testing di Rails, panduan lengkap testing Ruby on Rails untuk pemula menjelaskan struktur test yang bisa langsung kamu pakai untuk mailer.

require "test_helper"

class UserMailerTest < ActionMailer::TestCase
  test "welcome" do
    user = users(:satu)
    email = UserMailer.welcome(user)
    assert_emails 1 do
      email.deliver_now
    end
    assert_equal ["[email protected]"], email.to
    assert_match "Selamat datang", email.subject
  end
end

Masalah yang Sering Muncul Saat Kirim Email

Email yang masuk folder spam biasanya bukan karena kode Rails-nya salah. Beberapa penyebab umum:

  • Domain pengirim tidak punya record SPF, DKIM, atau DMARC yang valid.
  • Alamat from berbeda dengan domain yang dipakai server SMTP.
  • Rasio gambar terlalu tinggi dibanding teks, sehingga filter spam curiga.
  • Link di dalam email mengarah ke domain yang berbeda jauh dari domain pengirim.

Atur juga config.action_mailer.default_options untuk mengisi from dan reply_to secara global. Kalau aplikasi kamu juga memanggil API dari sisi klien untuk memicu notifikasi, pastikan penanganan responsnya rapi. Ada pembahasan soal cara menampilkan data dari AJAX jQuery ke HTML yang relevan saat kamu menampilkan status pengiriman email tanpa reload halaman.

Kapan Perlu Memakai Mailer Terpisah

Pisahkan mailer berdasarkan domain fungsi, bukan berdasarkan siapa penerimanya. Contohnya UserMailer untuk urusan akun, OrderMailer untuk transaksi, dan NotificationMailer untuk pesan sistem. Pemisahan ini membuat view mudah dicari saat ada permintaan ubah template dari tim marketing. Untuk cetak biru struktur kode yang lebih rapi, kebiasaan menulis kode Rails yang menjaga proyek tetap awet bisa jadi acuan, lihat kebiasaan ngoding Ruby on Rails yang bikin proyek awet.

Saat menambahkan fitur email, sering kali kamu juga perlu menyentuh form dan validasinya, misalnya form pendaftaran yang memicu email selamat datang. Panduan tips praktis menulis validasi form di Rails membantu memastikan data yang masuk ke mailer sudah bersih.

Menjaga Pengiriman Email Tetap Terpantau

Catat setiap kegagalan pengiriman. Bungkus pemanggilan deliver_later dengan rescue di background job supaya error SMTP tidak hilang diam-diam. Beberapa penyedia layanan email memberi webhook untuk status bounce dan spam complaint, manfaatkan itu untuk menonaktifkan alamat yang sudah tidak valid.

Untuk kebutuhan informasi seputar perkembangan teknologi dan berita industri, situs seperti indowarta rutin memuat tulisan dari penulis berpengalaman dengan sumber yang bisa ditelusuri, sehingga cocok jadi bahan referensi tambahan saat kamu memantau tren di sekitar ekosistem web.

Kalau kamu mempekerjakan developer dari luar tim, pastikan sejak awal ada kesepakatan soal siapa yang mengurus kredensial SMTP dan template email. Ini bagian kecil tapi sering jadi sumber kebingungan di akhir proyek.

Email transaksional yang gagal terkirim diam-diam lebih berbahaya daripada email yang error secara terang-terangan, karena pengguna tidak tahu apa yang harus mereka lakukan.

Ringkasan

Action Mailer menyatukan pembuatan template, pengiriman, dan pengujian email dalam satu tempat. Kunci pemakaian yang nyaman: simpan kredensial SMTP di environment variable, kirim lewat deliver_later, sediakan view HTML dan teks biasa, lalu uji dengan assert_emails. Perhatikan juga pengaturan domain pengirim supaya email tidak berakhir di folder spam.

Pertanyaan yang Sering Diajukan

Apa beda deliver_now dan deliver_later di Action Mailer?

deliver_now mengirim email saat itu juga di dalam proses yang sedang berjalan. deliver_later menitipkan pengiriman ke Active Job sehingga proses web tidak perlu menunggu server SMTP. Untuk request dari pengguna, deliver_later hampir selalu jadi pilihan yang lebih aman.

Kenapa email dari aplikasi Rails saya masuk folder spam?

Penyebab paling sering ada di sisi domain pengirim, bukan kode. Pastikan record SPF, DKIM, dan DMARC sudah benar, alamat from memakai domain yang sama dengan server SMTP, dan isi email tidak didominasi gambar. Cek juga reputasi IP server email yang kamu pakai.

Apakah perlu membuat mailer terpisah untuk setiap jenis email?

Tidak harus satu mailer per email. Kelompokkan berdasarkan domain fungsi, misalnya akun pengguna, transaksi, dan notifikasi sistem. Yang penting konsisten supaya template mudah ditemukan ketika ada perubahan dari tim lain.

Related Post