0.0
No commit activity in last 3 years
No release in over 3 years
Twilio integration for Lita
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0
>= 3.0.0

Runtime

>= 4.2
 Project Readme

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