Just add the following to your Gemfile:
gem 'clockworksms'
Full documentation is at http://rubydoc.info/github/mediaburst/clockwork-ruby/master/frames. Alternatively, run yard doc and open doc/index.html.
For more information on the available optional parameters for the API (Clockwork::API), see here.
For more information on the available optional parameters for each SMS (Clockwork::SMS), see here. For more information on the response object returned from each SMS (Clockwork::SMS::Response), see here.
require 'clockwork'
api = Clockwork::API.new( 'API_KEY_GOES_HERE' ) #Be careful not to post your API Keys to public repositories.
message = api.messages.build( :to => '441234123456', :content => 'This is a test message.' )
response = message.deliver
if response.success
puts response.message_id
else
puts response.error_code
puts response.error_description
endrequire 'clockwork'
api = Clockwork::API.new( 'API_KEY_GOES_HERE' ) #Be careful not to post your API Keys to public repositories.
message = api.messages.build
message.to = '441234123456'
message.content = 'This is a test message.'
response = message.deliver
if response.success
puts response.message_id
else
puts response.error_code
puts response.error_description
endYou should not use the Clockwork::Message#deliver method for each message, but instead use the Clockwork::API#deliver method to send multiple messages in the same API request. This will decrease load on the API and ensure your requests are processed significantly faster.
messages = [
{ :to => '441234123456', :content => 'This is a test message.', :client_id => '1' },
{ :to => '441234123456', :content => 'This is a test message 2.', :client_id => '2' },
{ :to => '441234123456', :content => 'This is a test message 3.', :client_id => '3' },
{ :to => '441234123456', :content => 'This is a test message 4.', :client_id => '4' },
{ :to => '441234123456', :content => 'This is a test message 5.', :client_id => '5' },
{ :to => '441234123456', :content => 'This is a test message 6.', :client_id => '6' }
]
require 'clockwork'
api = Clockwork::API.new( 'API_KEY_GOES_HERE' ) #Be careful not to post your API Keys to public repositories.
messages.each do |m|
api.messages.build(m)
end
responses = api.deliver
responses.each do |response|
puts response.message.client_id
if response.success
puts response.message_id
else
puts response.error_code
puts response.error_description
end
endrequire 'clockwork'
api = Clockwork::API.new( 'API_KEY_GOES_HERE' ) #Be careful not to post your API Keys to public repositories.
balance = Clockwork::API.balance
puts balance # => { :account_type => "PAYG", :balance => 575.23, :currency => { :code => "GBP", :symbol => "£" } }If you find a bug please file a Github issue with as much detail as you can or submit a pull request. If you need a bit of help or just fancy a chat drop us an email at [email protected].
This project is licensed under the MIT open-source license.
A copy of this license can be found in LICENSE.
If you have any feedback on this wrapper drop us an email to [email protected].
The project is hosted on GitHub at http://www.github.com/mediaburst/clockwork-ruby.
If you would like to contribute a bug fix or improvement please fork the project and submit a pull request. Please add RSpec tests for your use case.
If we don't respond to your bug report or pull request within a few days please email [email protected] or remind @ClockworkSMS on Twitter, we probably haven't spotted the notification.
First, create a file at spec/spec_authentication_details containing the following:
YOUR_API_KEY_HERE
Substitute your own API key on line 1 of the file and replace the telephone numbers in the spec files with your own.
Then, run rspec.
- Initial release of wrapper [JI]
- API#credit is now deprecated: use API#balance instead.
- Compatability fixes for Ruby 1.8, 2.0 and 2.1 (Tested with 1.8.7-p375, 1.9.3-p547, 2.0.0-p481 and 2.1.2). Thanks to Paul Volpato, Todd Bealmear and Fawad for the pull requests.
- Add some tests for the invalid_char_action and truncate parameters.
- Fix invalid_char_action parameter as it was passing invalid values to the Clockwork API. Thanks to Tom Pesman for the fix.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent