Brevo::Extras

A Rails engine that provides a clean abstraction layer for sending transactional emails via the Brevo API, with built-in safety features to prevent accidental email delivery in development and test environments.

• Abstract base class for creating email sender classes
• Asynchronous delivery via Active Job
• Automatic retry on API errors with polynomial backoff
• Sandbox mode - prevents actual email delivery (enabled by default)
• Safe mode - filters recipients by allowed domains (enabled by default in local environments)
• Template-based emails with parameters
• Reply-to address support

Add this line to your application's Gemfile:

gem "brevo-extras"

And then execute:

$ bundle

The engine is configured through environment variables:

You also need to configure the Brevo API key as required by the brevo gem.

Subclass Brevo::Extras::Base and implement the #call method:

class WelcomeEmail < Brevo::Extras::Base
  def call
    send_email(
      template_id: 1,
      to: [{ email: params[:email], name: params[:name] }]
    )
  end
end

WelcomeEmail.call(email: "user@example.com", name: "John")

The email is enqueued as an Active Job and delivered asynchronously.

send_email(
  template_id: 1,
  to: [{ email: params[:email], name: params[:name] }],
  reply_to: { email: "support@example.com" }
)

Parameters passed to .call are forwarded to the Brevo template as params:

# These params will be available in your Brevo template
OrderConfirmation.call(
  email: "user@example.com",
  order_id: "12345",
  total: "$99.00"
)

The DeliveryJob automatically retries on Brevo::ApiError with polynomial backoff, up to 5 attempts.

bin/rails test

bin/rubocop

The gem is available as open source under the terms of the MIT License.