Envío de Correos en Rails con ActionMailer y Background Jobs

¿Cómo enviar correos en Rails utilizando ActionMailer?

El envío de correos electrónicos es una funcionalidad esencial en muchas aplicaciones web, y Rails facilita este proceso con ActionMailer. Integrar esta herramienta te permitirá no solo mejorar la interacción con tus usuarios, sino también automatizar procesos cruciales, como el envío de reportes personalizados. ¿Cómo empezar entonces a utilizar ActionMailer en un entorno Rails?

¿Qué es ActionMailer?

ActionMailer es un componente de Rails diseñado para gestionar la creación y el envío de correos electrónicos desde tu aplicación. Ofrece una sintaxis clara y herramientas útiles que simplifican este proceso.

¿Cómo configurar un Mailer en Rails?

Para crear un Mailer, debes usar el generador de Rails. Utiliza el comando:

rails g mailer PostReport

Este comando genera una clase que hereda de ApplicationMailer, donde definirás los correos que deseas enviar.

¿Cómo definir un método para enviar correo?

Dentro del Mailer, necesitas un método donde definir los correos. A este método puedes llamarlo como prefieras y añadir los parámetros necesarios:

class PostReportMailer < ApplicationMailer
  def post_report(user, post, report)
    @user = user
    @post = post
    @report = report
    mail(to: @user.email, subject: "Reporte del post #{@post.id}")
  end
end

Aquí, se establece la dirección de correo del destinatario y el asunto del correo.

¿Cómo crear una vista para el correo?

Aunque Rails genera vistas junto con el Mailer, en aplicaciones Rails API únicamente, no se crean automáticamente. Crea un archivo en app/views/post_report_mailer/ con el mismo nombre que tu método y la extensión .txt.erb.

Estado del Reporte: <%= @report.status %>
Detalles del Post:
Título: <%= @post.title %>
ID: <%= @post.id %> 

Este archivo utiliza variables de instancia definidas en el Mailer.

¿Cómo enviar el correo?

Para enviar el correo, puedes optar por los métodos deliver_now o deliver_later. Si estás operando en un job en background, deliver_now es suficiente ya que el correo se enviará de inmediato:

PostReportMailer.post_report(@user, @post, @report).deliver_now

¿Cómo probar los correos en desarrollo?

Resulta crucial verificar el funcionamiento de tus configuraciones de correo antes de implementarlas. Aquí es donde la gema LetterOpener entra en acción. Esta herramienta abre los correos en el navegador, simulando su envío:

1. Añádela en tu Gemfile:

   group :development do
     gem 'letter_opener'
   end
   

2. Instala la gema y configura en config/environments/development.rb:

   config.action_mailer.delivery_method = :letter_opener
   

3. Prueba el envío corriendo la consola de Rails y ejecutando tus métodos de envío de correo.

¿Cómo integrar el envío con Active Job?

Puedes usar Active Job para gestionar tareas en segundo plano, como el envío de correos. Para ello, asocia el envío de correos con el job en cuestión:

class PostReportJob < ApplicationJob
  queue_as :default

  def perform(user_id, post_id)
    user = User.find(user_id)
    post = Post.find(post_id)
    report = generate_report(post)
    PostReportMailer.post_report(user, post, report).deliver_later
  end
end

Para probarlo, encola el job:

PostReportJob.perform_later(user.id, post.id)

Rails se encargará de gestionar la cola e iniciar el envío en el momento preciso.

¡Así de sencillo es comenzar a enviar correos con Rails! Explora todas las funcionalidades que ActionMailer tiene para ofrecer. Con práctica, automatizar el envío de correos se convertirá en una tarea rápida y eficiente.