The SMS Gateway gem provides a simple and extensible interface for various SMS Gateways. It is loosely oriented on Action Mailer. The gem allows you to create an SMS and deliver it synchronously or asynchronously. So far it ships with the following adapters:
-
smsglobal.com
-
smstrade.de
You install the gem in your rails app by adding it your Gemfile:
gem "sms_gateway"
After that you run the bundle:install task and then invoke the gem’s generator:
rails g sms_gateway:install
which installs an initializer and a yml file that you will need to configure before sending out an SMS.
To deliver SMS asynchronously this gem makes use of resque, a popular queing system basd on the key-value data store redis. You need to have a working resque and redis setup if you want to use the aynchronous sending feature. For more information on resque visit github.com/defunkt/resque .
Similar to action mailer you create a message object first:
m = SmsGateway::Sms.new(:from => '493088888888, :to => '49309999999',
:text => 'my sms must not be longer than 160 characters.')
And then deliver it with:
m.deliver
This will block until the the HTTP call is complete. As with email it’s better practice to enqueue the call:
m.deliver_later
This will be non-blocking and is the recommended way of sending an SMS. This requires a resque worker, though, to get actually sent (see the resque documentation):
rake resque:work
So far the gem is pretty limited. Ideas for following version are:
-
more and better unit tests
-
more sms gateway apis
-
decoupling of resque
-
error handling
GPLv3. Copyright 2011 Kai Rubarth.