Sendcorex
Tutorial

Enviar email com Ruby on Rails via SMTP

Action Mailer, configurado uma vez num initializer, enviado de qualquer lugar do app.

Pela equipe Sendcorex·Atualizado em 21 de set. de 2026·7 min de leitura

Configurar o Action Mailer

Em config/environments/production.rb (ou num initializer):

config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address: 'smtp.sendcorex.com',
  port: 587,
  user_name: ENV['SENDCOREX_API_KEY'],
  password: ENV['SENDCOREX_API_KEY'],
  authentication: 'plain',
  enable_starttls_auto: true,
}
config.action_mailer.default_url_options = { host: 'yourdomain.com' }

Gerar e enviar um mailer

rails generate mailer Welcome
class WelcomeMailer < ApplicationMailer
  default from: 'Your App <hello@yourdomain.com>'

  def welcome_email(user)
    @user = user
    mail(to: @user.email, subject: 'Welcome!')
  end
end

# from anywhere in your app
WelcomeMailer.welcome_email(user).deliver_later

Use deliver_later com um adaptador de fila (Sidekiq, Solid Queue) em vez de deliver_now para que uma conexão SMTP lenta nunca trave uma requisição web.

Erros comuns

SintomaSolução
Net::SMTPAuthenticationErrorConfirme que a variável de ambiente está carregada e é usada tanto em user_name quanto em password.
O email nunca sai da filaConfira se o seu adaptador de fila (por exemplo, Sidekiq) está mesmo rodando nesse ambiente.

Envie seu primeiro email em minutos

Crie uma conta grátis, verifique seu domínio e cole o código acima.

Sem cartão de crédito