implementing the http/https API for truesenes.com
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
test
.document
.gitignore
LICENSE
README.rdoc
Rakefile
VERSION
sample.yml
truesenses.gemspec

README.rdoc

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', '+41987654321', :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 © 2010 simplificator. See LICENSE for details.