Responder is a lightweight (2016 keyword of the year) NodeJS/MongoDB API for gathering and managing feedback from SMS messages sent to phone number(s)/short code(s) on Twilio (think of it like a ticketing system that people text).
- Clone the repository
npm install
- Create a
secrets.json
file in the root (see the development configuration section below for more details) npm start
- Setup a Twilio SMS Messaging Service and set its
REQUEST URL
tohttps://YOURDOMAIN.COM/webhooks/twilio/sms
POST /webhooks/twilio/sms // TwiML Messaging Service SMS Handler
GET /admin/messages // List all messages received from Twilio
GET /admin/message/:id // View specific message by id
DELETE /admin/message // Delete a message by id
GET /admin/tickets // View ticket chains
secrets.json
{
"MESSAGING_SID": "XXX", // Twilio Messaging Service ID (restricts your endpoint to your messaging service)
"MONGO_URI": "XXX", // the MongoDB connection string
"API_USERNAME": "XXX", // the username used for basic auth
"API_PASSWORD": "XXX", // the password user for basic auth
"ROLLBAR_TOKEN": "XXX" // your Rollbar key for error tracking
}
Respondr will look for ENV variables with the same names as the ones in secrets.json
This application can be deployed pretty much anywhere NodeJS applications can (YMMV). We currently have it deployed on Microsoft Azure (albeit it feels kind of strange) using an app service and IISNODE for the web server (and it seems pretty performant).
Supported Platforms (confirmed)
- Microsoft Azure