rsf-textable

A class that can send and receive text messages via twilio, that has a clean and simple speak/listen API.

In order to make this work, not only do you need to set up a twilio account, and number, but you also need to use an NGROK tunnel to your temp server, to receive webhook events. This is all explained here: https://www.twilio.com/docs/sms/quickstart/node#sign-up-for-twilio-and-get-a-twilio-phone-number

environment variables

• TWILIO_SERVER_PORT : Number, the port on which to temporarily run the server
• TWILIO_SENDER_NUMBER: String, the phone number associated with the twilio account, formatted like +12223334444
• TWILIO_ACCOUNT_SID : String, the account sid value taken from twilio
• TWILIO_TOKEN : String, the secret token given by twilio

API

Textable

constructor(id, name): A Textable is a wrapped version of a bidirectional communication channel between the program, and a person, in which messages of text/strings can be sent and received

id: String, the phone number to reach this person at

name: String, optional, a name of the person being contacted

Instance methods

speak(string): Contact the person represented by the Textable, sending them a message

string: String, the string of text to send the person represented

listen(callback): Handle a message from the person represented by the Textable, received as a simple string

callback(string): Function, give a function which will be called whenever a message from the person is received