0.0
No commit activity in last 3 years
No release in over 3 years
Mandrill webhook integration for Rails.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 3.1

Runtime

 Project Readme

Gem Version

MandrillEvent

MandrillEvent is built on the ActiveSupport::Notifications API. Define subscribers to handle specific event types. Subscribers can be a block or an object that responds to #call.

Installation

Add it to your Gemfile

# Gemfile
gem 'mandrill_event'

And then execute:

$ bundle

Usage

Mount the engine in your routes

# config/routes.rb
  mount MandrillEvent::Engine => '/mandrill'

Setup the initializer

# config/initializers/mandrill_event.rb
MandrillEvent.configure do |events|
  events.subscribe 'reject', RejectHandler
end

Subscriber responds to call

# app/mandrill_handlers/reject_handler.rb
class RejectHandler
  def self.call(event)
    # your code here
  end
end

Configure Mandrill webhooks to use your endpoint

At the Mandrill website, create a webhook that points to your server with the path /mandrill/events. A service like Ngrok or Ultrahook can be really useful in creating a tunnel to your local server and inspecting the request payloads.

Thanks

MandrillEvent takes inspiration from is a direct rip-off of the stripe_event gem, which takes it's inspiration from Webmachine, which is inspired by Erlang. It's turtles all the way down.

TODO:

  • Get it on Travis
  • Write docs with RDoc/YARD
  • More test coverage
  • Incoming webhook requests are authenticated
  • Get it on Coveralls
  • Get it on Code Climate

Contributing

  1. Fork it ( https://github.com/[my-github-username]/mandrill_event/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request