Slacked

This is a super simple Slack integration for Rails. A use case for this would be to post a notification in Slack when a new User is created or a certain action has been taken in your application.

Are there other gems that provide similar functionality? Yes. Do some of them provide more flexibility? Yes. The point of this was to make installing and integrating a 30 second process.

Getting Started

Add this line to your application's Gemfile:

gem 'slacked'

And then execute:

$ bundle

Then run the installer:

$ bundle exec rails g slacked:install

This will create a .env file in the root of the rails appication. Specify the Webhook Url and the message to be sent.

SLACK_WEBHOOK= "WEBHOOK_URL"
SLACK_DEFAULT_MESSAGE= "TEST"

Usage

Set the SLACK_WEBOOK env variable with the value of the webhook which you want to send the messages. If you want to send a unique message in your application like 'Application is running' you can set the SLACK_DEFAULT_MESSAGE and call the message methods without sending an argument.

To send a sync message to slack use the method:

Slacked.post "This is a test post"

or

Slacked.post

The last example will use the SLACK_DEFAULT_MESSAGE value

To send an async message to slack use the method:

Slacked.post_async "This is a test post"

or

Slacked.post_async

The last example will use the SLACK_DEFAULT_MESSAGE value

Example

class Post < ActiveRecord::Base
  after_create :slacked

  private

  def slacked
    Slacked.post 'post created!'
  end
end

Contributors

• Sean H.
• Kaio Magalhães

License

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