Send and receive text messages with your Lita chatbot
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
locales
spec
.gitignore
.travis.yml
Gemfile
README.md
Rakefile
lita-twilio.gemspec

README.md

Build Status Coverage Status Gem Version

lita-twilio

Lita-Twilio integrates your Twilio account into Lita. Send and receive text messages from your company chat room.

Installation

Add lita-twilio to your Lita instance's Gemfile:

gem "lita-twilio"

Configuration

There's a bit of Yak-shaving to do here, sorry.

Required attributes

  • default_room (String) - The room or person Lita will message on receipt of incoming SMS.
  • account_sid (String) Your Twilio account's sid.
  • auth_token (String) Your Twilio account's auth_token.
  • phone_number (String) Your Twilio account's phone_number.
  • server_token (String) A keyphrase you will use to authenticate requests to the :post route. You'll need this token to properly setup Twilio callbacks to power the receive route.

Twilio Account Setup

  • If you have the free account, you'll need to manually add and verify numbers to which you want to send.
  • Go to https://www.twilio.com/user/account/phone-numbers/incoming and change the Request URL under messages to http://yourdomain.com/twilio?token=VALUE-OF-YOUR-CONFIG-SERVER_TOKEN.

Usage

*Litabot: sms 415-867-5309 Hello Jenny will send an SMS to (415) 867-5309 with the message "Hello Jenny"

  • Phone numbers must be strictly in the XXX-XXX-XXXX format, and sms or SMS (case insensitive) must be used as a command to Litabot.
  • Any incoming messages to your Twilio account will be displayed with the message and sender.

Contributing

Pull requests are welcome! The plan for version > 1.0 will support some of Twilio's other functionality: send and receive telephone calls, and I'm open to any suggestions. Please use the issues to file bug reports.

License

MIT