This is an automated expense system where users can submit expenses by SMS.
For more information on the use case, see RHoK's problem statement.
- You will need a heroku account and their toolbelt installed.
- You will need a Twilio account.
- You will need a Gmail account to handle the creation of spreadsheets. Use a new Gmail account for better experience.
Enter this command into your terminal:
git clone git@github.com:matstc/rhok-accountability.git
Then enter these commands into your terminal:
cd rhok-accountability
heroku create
git push heroku master
heroku config:add gmail=GMAIL_ACCOUNT_USERNAME
heroku config:add gmailp=GMAIL_ACCOUNT_PASSWORD
The application should now be running at heroku's URL.
OPTIONAL: if you want to show an email address for users to contact in case they need help, set the help_email variable like this:
heroku config:add help_email=YOUR_EMAIL_ADDRESS
The email address will then be shown on the main page.
Go to heroku's URL and fill out the following form:
Once you click the "create" button, you will see a link to a Google spreadsheet. The person with that email address is now the owner of that spreadsheet.
The phone number should start with + and follow international conventions (and should not contain any spaces).
Once you have a Twilio account, make sure you register a number. Then go to your number's settings and add the appropriate SMS request URL. The request URL follows the format http://HEROKU_URL/application/add. For instance, if your heroku URL is myapp.herokuapp.com then your request URL will be http://myapp.herokuapp.com/application/add
Things should now work. If you text something to the phone number you used to set up your spreadsheet, you should see a new expense row in the spreadsheet.
Format your message with commas in-between values. For example:
pencils, 14.50$, extra stationery