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.
gem 'twilito'
# All of these arguments are required, but can be defaulted (see below)
result = Twilito.send_sms(
to: '+15555555555',
from: '+15554444444',
content: 'This is my content',
account_sid: '...', # Twilio Credentials
auth_token: '...'
)
# Returns instance of Twilito::Result
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)
begin
Twilito.send_sms!(
to: '+15555555555',
from: '+12333',
body: 'This is my content',
account_sid: '...',
auth_token: '...'
)
rescue Twilito::SendError => e
e.message # => 'Error from Twilio API'
e.response # => Raw response (instance of Net::HTTPResponse)
end
# In an initializer or something like that:
Twilito.configure 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:
Twilito.send_sms!(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 = Twilito.send_sms(
to: '+15555555555',
content: 'This is my content',
media_url: 'https://example.com/image.png',
)
TODO: Add examples of mocking and/or test helpers for asserting your code sends an SMS
- 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?