maccman / remail Goto Github PK

Remail is RESTful email for Rails.

Forget configuring SMTP servers and queues, just use Remail. Remail uses Google App Engine to send and receive emails RESTfully.

Remail only support Rails 3.

Google App Engine gives you a free quota of 2000 emails per day or, with the paid version, 7,400,000 emails per day.

• ActionMailer POSTs emails to your Remail App Engine in order to send them
• Remail POSTs received emails back to a configurable URL
• Remail will retry the callback if the endpoint is not available

• Configure and deploy the Remail App Engine
• Install the Remail gem (sudo gem install remail)

Configure ActionMailer and Remail:

config.action_mailer.delivery_method = :remail
config.action_mailer.remail_settings = {
  :app_id  => "remail-appname",
  :api_key => "changeme"
}

The sender address of a message must be the email address of an administrator for the Remail App Engine. If you want to send email on behalf of the application but do not want to use a single administrator's personal Google Account as the sender, you can create a new Google Account for the application using any valid email address, then add the new account as an administrator for the application.

First, configure the callback URL in your Remail App Engine.

Then create a email controller, that looks a bit like this (remember to configure the routes):

    class EmailsController < ApplicationController
      skip_before_filter :verify_authenticity_token
      
      def create
        if request.headers["Authorization"] != your_api_key
          return head(:unauthorized)
        end
        UserMailer.receive(params[:email][:raw])
        head :ok
      end
    end

The API key is passed through in the Authorization header, you should definitely validate that.

You might want to add :email to the filter_parameters configuration - you don't want your logs being clogged up with emails.

Your app can receive email at addresses of the following form: [email protected]

To ensure your email doesn't get caught in spam filters, you should follow the tips in this tutorial I wrote - the important points being setting SPF and MX records.