Devise slack notifactions gem

devise, notifications, slack
gem install devise_slack_notifiable -v 0.2.0



Devise slack notifications gem. It posts message after registration and confirmation (if Devise confirmations strategy is enabled).

Gem Version codecov ruby


Add this line to your application's Gemfile:

gem 'devise_slack_notifiable'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install devise_slack_notifiable


1. Slack

Prepare Slack Webhook - it should look like

Not sure how to do that? Check out slack documentation.

2. Application

After preparing Slack Webhook create initializer - config/initializers/devise_slack_notifiable.rb:

DeviseSlackNotifiable.configure do |config|
  # Enabled state
  #   By default integration is disabled. You need to enable it manually on desired environments.
  #   For example production only:
  #     config.enabled = Rails.env.production?
  #   Default: false
  config.enabled = true

  # Slack Webhook URL
  #   Required when integration enabled.
  #   It's recommended to use rails credentials instead of raw url (
  # Default: nil
  config.slack_webhook = 'YOUR_SLACK_WEBHOOK_URL'

  # Confirmation message state
  #   If You want You can disable sending confirmation message:
  #     config.confirmation_message_enabled
  #   Default: true

  # Context fields
  #   To all messages sent there is context attached that adds entity fields.
  #   If You want to customize fields:
  #     config.context_fields = [:id, :email, :first_name, :last_name]
  #   Default: [:id, :email]

After creating initializer add :slack_notifiable to the devise call in your model (we’re assuming here you already have a User model with some Devise modules):

class User < ActiveRecord::Base
  devise :database_authenticatable, :confirmable, :slack_notifiable

And you are ready to go!


Messages overview:

Registration notification Confirmation notification



If You want to add more fields to context check out configuration in initializer - it's based on context_fields.

Example with context extended by first and last name (as on screenshots):

config.context_fields = [:id, :email, :first_name, :last_name]

Sending own messages

You can send own messages with this context for anywhere You want inside rails application:

# Let's assume that customer with id 1 asked for sales contact
user = User.find(1)
formatter = ->(entity) { "Customer #{} asked for sales contact!" }

notifier =
notifier.send_message(user, formatter)

Message formatting

You can customize messages by initializer:

config.registration_message_formatter = lambda { |entity|
                                          "Yeah πŸŽ‰! Looks like we have new #{entity.model_name.human}! 😊"
config.confirmation_message_formatter = lambda { |entity|
                                          "#{entity.model_name.human} have just confirmed his account πŸ₯‚"


After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.


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

Code of Conduct

Everyone interacting in the DeviseSlackNotifiable project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.