Awesome
ohana-sms
A project to create an SMS interface for the Ohana API. SMS, Voice, and SIP support through Tropo, web app hosted on Heroku. A civic hacking project to give back to the community by @Skram of Social Health Insights.
Demonstration
<table> <tr> <th>Service</th> <th>Number/Name</th> <th>Voice/Text</th> </tr> <tr> <th>Call/SMS</th> <td>+1 650-397-2418</td> <td>Both</td> </tr> <tr> <th>SIP</th> <td>sip:9991432720@sip.tropo.com</td> <td>Voice only</td> </tr> </table>Data Source
This app uses data from the Ohana API.
- HTTP API Documentation at http://ohanapi.herokuapp.com/api/docs
- This app uses the Ruby library at https://github.com/codeforamerica/ohanakapa-ruby/
Screenshots and Voice Recordings
<table> <tr> <td><a href="docs/sms_1_start.png" target="_blank"><img src="docs/sms_1_start.png" alt="sms demo - start view" title="SMS Example - Start of conversation" style="max-width:40%;"></a></td> <td><a href="docs/sms_2_details.png" target="_blank"><img src="docs/sms_2_details.png" alt="sms demo - detail view" title="SMS Example - End of conversation" style="max-width:40%;"></a></td> </tr> </table>A recording of a voice session
Current Limitations
- User is only prompted for a location and only a 5-digit zip code is acceptable.
- User is not asked for what kind of service they are looking for. "food" is hardcoded in.
- It is easy to ask SMS users what "kind" they are looking for or even let them include free text queries. This is not the case for phone users. We can say "press or say 1 for food, 2 for shelter, etc.." or use voice recognition for a set vocabulary but then we must explain the available words, etc.
- User can only select from the first 9 search results
TODO
- Add information for contributing to this repo (it's very much welcomed)
- Add screenshots and/or recordings to demo functionality
Steps to recreate
-
You will need to have Ruby, Rubygems, Heroku and Git installed first.
-
Drop into your command line and run the following commands:
git clone http://github.com/marks/ohana-sms.git --depth 1cd ohana-sms
- Edit the
config.ymlto use suit your preferences and make sure following ENV are set (Google Analytics ones and are optional):
OHANA_API_KEY=your_api_key
GOOGLE_ANALYTICS_DOMAIN=yourdomain.com
GOOGLE_ANALYTICS_ID=UA-XXXXXXXX-XX
- Back at the command line, issue:
heroku creategit push heroku master
-
Log in or sign up for Tropo and create a new WebAPI application. For the App URL, enter in your Heroku app's URL and append
/index.jsonto the end of it. -
That's it! Call in, use, and tinker with your app!