A simple wrapper for the Nexmo API
$ gem install nexmo
Use the send_message!
for a "fire and forget" approach to sending a message:
require 'nexmo'
nexmo = Nexmo::Client.new('...API KEY...', '...API SECRET...')
nexmo.send_message!({:to => '...NUMBER...', :from => 'Ruby', :text => 'Hello world'})
This method call returns the message id if the message was sent successfully,
or raises an exception if there was an error. For more robust error handling
use the send_message
method instead. This returns the HTTP response wrapped
in a Nexmo::Response
object.
The "json" library is used by default. This is available in the Ruby 1.9 standard library, and as a gem for Ruby 1.8. You can specify an alternate implementation that you wish to use explicitly when constructing a client object. For example, to use multi_json:
require 'nexmo'
require 'multi_json'
nexmo = Nexmo::Client.new('...API KEY...', '...API SECRET...', :json => MultiJson)
Ditto for anything that is compatible with the default implementation.
Remember that phone numbers should be specified in international format.
The Nexmo documentation contains a list of error codes which may be useful if you have problems sending a message.
Please report all bugs/issues via the GitHub issue tracker.