Envío de Correos con ActionMailer en Rails

Contenido del curso

Introducción

Entorno de desarollo

Nuestra primera aplicación

Proyecto del curso: primeros pasos

Proyecto del curso: usuarios

Proyecto del curso: interacciones

Cierre

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0013:25

Envío de Correos con ActionMailer en Rails

Curso de Introducción a Ruby on Rails

Clase 31 de 36

Clase 31 / 36

Recursos

¿Qué es el ActionMailer en Rails?

En el mundo de Ruby on Rails, el ActionMailer es un módulo esencial que te permite enviar correos electrónicos a los usuarios de manera automática. Esta herramienta es fundamental para notificar a los participantes cuando, por ejemplo, se ha creado una nueva tarea en nuestra aplicación. Antes de empezar a utilizar ActionMailer, es importante que repases los datos necesarios y tengas tu entorno de desarrollo listo para seguir adelante.

¿Cómo crear un Mailer en Rails?

Para comenzar a enviar correos electrónicos, primero debemos generar un Mailer. Utilizaremos el conocido generador de Rails, rails generate, parametrizado con mailer. Esto generará la estructura de directorios y archivos necesaria para la creación del email. En este caso, llamaremos al sistema de emails ParticipantMailer. Al usar el comando, se crean varios directorios y archivos, entre ellos, el archivo principal ParticipantMailer, donde desarrollaremos la lógica del envío del correo.

rails generate mailer ParticipantMailer

¿Cómo editar el archivo del Mailer?

Dentro del archivo ParticipantMailer, podemos crear métodos como si fueran acciones de un controlador. Dichos métodos están asociados a vistas que renderizarán el email. Vamos a crear un método llamado new_tasks_email que, mediante variables, transmitirá información a la vista.

class ParticipantMailer < ApplicationMailer
  def new_tasks_email(user, task)
    @user = user
    @task = task
    mail(to: @user.email, subject: 'Nueva tarea asignada')
  end
end

¿Cómo invocar el Mailer desde el modelo de tarea?

Es fundamental llamar al Mailer una vez que una nueva tarea ha sido creada. Para lograr esto, utilizamos un callback after_create en el modelo Task. Este callback llamará al método de envío de correo electrónico que hemos definido.

class Task < ApplicationRecord
  after_create :send_email

  private

  def send_email
    participants = self.participants + [self.owner]
    participants.each do |user|
      ParticipantMailer.with(user: user, task: self).new_tasks_email.deliver_later
    end
  end
end

¿Cómo crear una vista para el email?

La vista del correo es la estructura HTML que se enviará a los usuarios. Utilizamos el archivo new_tasks_email.html.haml para definir el contenido del correo.

%h1 Hola, #{@user.email}
%p Tienes una nueva tarea:
%ul
  %li= "Nombre: #{@task.name}"
  %li= "Descripción: #{@task.description}"
  %li= "Categoría: #{@task.category.name}"
  %li= "Ver tarea en el siguiente enlace: #{link_to 'Ver tarea', task_path(@task)}"

Previsualización de correos con Letter Opener

Para comprobar y previsualizar los correos sin necesidad de enviar mensajes reales, utilizamos la gema letter_opener. Esta gema permite abrir los correos en el navegador, otorgando un entorno seguro para pruebas y ajustes.

Configuración de Letter Opener

Agrega letter_opener al grupo de desarrollo en tu Gemfile:

group :development do
  gem 'letter_opener'
end

Configura el entorno de desarrollo en config/environments/development.rb:

Rails.application.configure do
  config.action_mailer.delivery_method = :letter_opener
  config.action_mailer.perform_deliveries = true
  config.action_mailer.raise_delivery_errors = true
  config.action_mailer.default_url_options = { host: 'localhost', port: 3000 }
end

Asegúrate de instalar la gema y reiniciar el servidor:

bundle install
rails server

Ahora, puedes crear una nueva tarea desde la interfaz de tu aplicación y verificar que los correos se generen correctamente en el navegador, gracias a letter_opener. Esto no solo facilita la vista previa, sino también la detección de errores y pruebas de estilo en tus correos electrónicos.

¡Sigue adelante, profundiza en tus conocimientos de Rails y descubre todo lo que ActionMailer puede ofrecerte!

Manuel Sandoya

Hace 6 años

Para los que usan WSL, lamentablemente la gema letter opener no funciona por lo que se explica aquí.
En las recomendaciones de la gema se menciona dos alternativas, en mi caso utilicé MailCatcher. Para configurar esta opción seguí los siguientes pasos:

Instalé la gema de MailCatcher (básicamente es un servidor de SMTP)

$ gem install mailcatcher

Luego, en config/enviroments/development.rb agregué las siguientes líneas (estas en total reemplazo a las que se muestran en esta clase)

config.action_mailer.default_url_options = { host: 'localhost:3000' }
config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = { :address => 'localhost', :port => 1025 }

Inicié MailCatcher con el comando

$ mailcatcher

Una vez iniciado Mailcatcher, ya se puede ingresar a este servidor por medio de localhost:1080. En la interfaz que se muestra al ingresar es donde veremos los correos que se enviarán al crear una nueva tarea.

Johan Tique

Profesor

Hace 6 años

Excelente recomendación!

Manuel Alejandro González Cabello

Hace 5 años

Gracias por la recomendación!

Introducción

Curso Completo de Ruby on Rails: Introducción y Proyecto Práctico

Historia y Evolución de Ruby y Ruby on Rails

Entorno de desarollo

Módulos Esenciales de Ruby on Rails

Instalación de Ruby on Rails en Ubuntu 20.04 LTS

Instalación de Ruby on Rails en macOS y Windows 10

Nuestra primera aplicación

Arquitectura MVC y Flujo de Peticiones en Rails

Creación y Configuración de Aplicaciones Web con Ruby on Rails

Creación de Rutas y Controladores en Ruby on Rails

Creación de Modelos y Migraciones en Ruby on Rails

Gestión de Credenciales Seguras en Ruby on Rails

Gestión de Assets y Layouts en Rails: Asset Pipeline y Webpacker

Uso del Generador Scaffold en Ruby on Rails

Migraciones y Consistencia de Modelos en Rails

Migración de Plantillas ERB a Haml en Ruby on Rails

Creación de Formularios Dinámicos con SimpleForm y Haml en Rails

Internacionalización de Aplicaciones Rails con i18n y i18n-tasks

Debugging en Ruby on Rails: Uso de Bybug y Pry

Proyecto del curso: primeros pasos

Desarrollo de un Sistema de Gestión de Tareas con Ruby on Rails

Diseño de Modelos de Datos para un Organizador de Tareas

Creación de Scaffolds y Modelos en Rails con SimpleFrame y Bootstrap

Internacionalización de Formularios en Rails con i18n y SimpleForm

Validaciones de Modelos en Ruby on Rails

Proyecto del curso: usuarios

Autenticación de Usuarios con Devise en Rails

Migración de Llave Foránea: Enlazar Tarea con Usuario en Rails

Integración Visual y Estructural en Rails: Usuario, Tarea y Participante

Manejo de Formularios Anidados con Cocoon en Rails

Formularios Dinámicos en Rails con Cocoon y Validaciones de Unicidad

Permisos y Accesos con KanKan en Aplicaciones Rails

Proyecto del curso: interacciones

Callbacks en Controladores y Modelos en Rails

Automatización de Inserción de Datos en Rails con db:seed

Envío de Correos con ActionMailer en Rails

Creación de notas dinámicas en tareas con Ruby on Rails

Inserciones Dinámicas de Notas con AJAX y SJR en Rails

Mejora de Interfaces con Bootstrap en Aplicaciones Rails

Cierre

Despliegue de Aplicaciones en Heroku con Ruby on Rails

Desarrollo de Aplicaciones Web con Ruby on Rails

Envío de Correos con ActionMailer en Rails