truesenses

= truesenses

A implementation of the truesenses HTTP/HTTPS API for sending SMS. Register at truesenses.com and buy some credits.

== Install gem install truesenses

== Notes Not all API methods are implemented (i.e. delivery reports) Multiple recipients are not supported (to allow for better error reports)

== How to use

require 'rubygems' require 'truesenses'

include Truesenses

you need a config which specifies at least username/password

config = Config.new(:username => 'ABCDE', :password => 'defgh', :prototcol => :http, :deliver => false)

or

config = Config.load(File.join(RAILS_ROOT, 'config', 'truesenses.yml'), RAILS_ENV)

then you can create the gateway object

gateway = SMSGateway.new(config)

you can query the remaining credits

gateway.credits_left

or send text messages (of course...)

all response codes but 01 will trigger an exception

id = gateway.send_text_message('Your message', '[phone]', :origin => 'ABCD')

== Note on Patches/Pull Requests

• Fork the project.
• Make your feature addition or bug fix.
• Add tests for it. This is important so I don't break it in a future version unintentionally.
• Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
• Send me a pull request. Bonus points for topic branches.

== Copyright

Copyright (c) 2010 simplificator. See LICENSE for details.