DirectSms
DirectSms is a wrapper for using the api offered by directsms.com.au. The complete documentation can be downloaded here: http://www.directsms.com.au/api/HTTP_API.pdf
Installation & Usage
Add this line to your application's Gemfile:
gem 'direct_sms'
And then execute:
$ bundle
Or install it yourself as:
$ gem install direct_sms
To start using DirectSms, you'll need a username and a password. If you read the directsms docs, they support passing a connectionid as well. This is not supported for now.
Getting your remaining balance
To get your account's balance, simply:
sms = DirectSms::Message.new(username, password)
response = sms.balance
response.body # -> credits: 300.00
Sending an SMS
To send an sms, you need to set the ff. attributes:
-
message - The content of your sms message
-
type - Only accepts two values; "1-way" & "2-way"
-
to - The recipient/s of the message
-
message_id - A unique identifier for the message. Used for tracking the reply of the receiver.
-
sender_id - Used for 1-way sms sending
sms = DirectSms::Message.new(username, password) sms.message = "Hello, world!" sms.type = "2-way" # -> enables the receiver to reply sms.to = "+639919302930" # -> to send to multiple recipients, use "," as delimiter. sms.messageid = "<id>" sms.send_message
Errors
If you've found any errors on the documentation as well as the code, feel free to contact me on my email.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request