A tiny, zero dependency helper for sending text messages with Twilio. Just enough of a wrapper to abstract away Twilio's REST API for sending messages, without anything else.
Twilio's full Ruby library does a lot, and has a large memory footprint to go with it—too large for just sending a message. It's also more difficult to mock and verify in tests than I'd like.
Using Twilio's REST API directly is fine, but can be cumbersome.
You should consider using Twilito if the only thing you need to do is send text messages and you don't want to worry about making HTTP requests to Twilio yourself.
If you use more of Twilio, consider twilio-ruby or interact with the REST API in another way.
Twilito should work on Ruby 2.4 and up.
Install the gem
# All of these arguments are required, but can be defaulted (see below) result = .( to: '+15555555555', from: '+15554444444', content: 'This is my content', account_sid: '...', # Twilio Credentials auth_token: '...' ) # Returns Twilito::Result struct result.success? # => boolean result.errors # =>  or error messages result.sid #=> Twilio SID for Message (SM[...]) result.response # => Raw response (instance of Net::HTTPResponse) result.data # => Hash of response data (parsed from JSON)
Use send_sms! to raise on error instead
begin .( to: '+15555555555', from: '+12333', body: 'This is my content', account_sid: '...', auth_token: '...' ) rescue :: => e e. # => 'Error from Twilio API' e.response # => Raw response (instance of Net::HTTPResponse) end
Every argument can be defaulted
# In an initializer or something like that: . do |config| # Store your secrets elsewhere config.account_sid = ENV['TWILIO_ACCOUNT_SID'] config.auth_token = ENV['TWILIO_AUTH_TOKEN'] config.from = '+16145555555' end
# Later, in your code: .(to: '+15555555555', body: 'Foo')
Everything can be defaulted, including the message body, so that a bare
Twilio.send_sms! can work in your code
# Use the optional media_url argument, which is sent # to Twilio as MediaUrl result = .( to: '+15555555555', content: 'This is my content', media_url: 'https://example.com/image.png', )
Testing your code
TODO: Add examples of mocking and/or test helpers for asserting your code sends an SMS
Contribute Feedback, Ideas, and Bug Reports
- Create or comment on an issue
- Find an open issue or create one
- Fork this repo and open a PR
- Write unit tests for your change
- Open a PR to make the README better, or help with contribution guidelines, etc.
- There is currently an open issue for adding RDoc/YARD documentation
Did Twilito save you some RAM?