A text message interface for people to check their EBT card balance for SNAP and other human service benefits

Currently available in:

• California
• Texas
• Missouri
• Pennsylvania

This is a simple Ruby app built on Twilio that creates a text message interface for people to check their food stamp EBT card balance (and cash balance for other programs).

The original idea was by @lippytak with influence from @alanjosephwilliams's experience on Code for America's health project ideas repo.

This is a project of CFA's Health SpecOps Team.

Our primary metrics are:

• of successful balance checks (growth)

• of unique users with 1+ successful balance checks (growth)

• % of users who check their balance more than once (engagement)

(click for interactive graph - sorry it's so slow!)

To deploy on Heroku, close and push the repo, and then set the following environment variables:

• TWILIO_SID
• TWILIO_AUTH

with your Twilio credentials.

Then, go onto your Twilio account and purchase a phone number. Configure that phone number with the following request URLs:

Voice: http://my-balance-url.herokuapp.com/voice_call (choose HTTP POST from dropdown)

Messaging: http://my-balance-url.herokuapp.com (choose HTTP POST from dropdown)

Because we use .env for testing, you'll want to run your tests by running:

foreman run bundle exec rspec spec

The twilio_console.rb file just gets you a quick Ruby prompt with Twilio clients pre-loaded. This is useful for doing manual responses to users. To use this, you will need to set the environment variables specified in that file.

We have isolated Twilio subaccounts for the app, under CFA's main account.

• Staging: balance-health-guarino
• Production: balance-production-guarino

Each account has phone numbers attached to it.

For A/B testing different outreach media, we can buy a new phone number on the same Twilio subaccount and point it to the same server URL.

We're deployed on Heroku on CFA's main account with both staging and production instances. Currently only @daguar is configured as a collaborator.

Copyright Code for America Labs, 2014 — MIT License