45 | git clone git://github.com/RobSpectre/Call-Your-Family.git 46 |47 | 48 | 2) Install dependencies 49 |
50 | make init 51 |52 | 53 | 3) Navigate to folder and create new Heroku Cedar app 54 |
55 | heroku create --stack cedar 56 |57 | 58 | 4) Deploy to Heroku 59 |
60 | git push heroku master 61 |62 | 63 | 5) Scale your dynos 64 |
65 | heroku scale web=1 66 |67 | 68 | 6) Configure Heroku to use your Twilio credentials. 69 |
70 | python configure.py --account_sid ACxxxxxx --auth_token yyyyyyy 71 |72 | 73 | 7) Open the app in your browser and get an invite! 74 |
75 | heroku open 76 |77 | 78 | 79 | ### Development 80 | 81 | Be sure to follow the configuration steps above and use this step-by-step 82 | guide to tweak to your heart's content. 83 | 84 | 1) Install the dependencies. 85 |
86 | make init 87 |88 | 89 | 2) Launch local development webserver 90 |
91 | foreman start 92 |93 | 94 | 3) Open browser to [http://localhost:5000](http://localhost:5000). 95 | 96 | 4) Tweak away on `app.py`. 97 | 98 | 99 | ## Testing 100 | 101 | This example app comes with a full testing suite with the same kind of form 102 | validation that you would want to use in production. To run the tests, simply 103 | use `nose` with this shortcut command: 104 | 105 |
106 | make test 107 |108 | 109 | 110 | ## Anatomy 111 | 112 | This app does have a little more complexity than our usual examples in an effort 113 | to be production-ready. Here's a quick rundown of all the important files: 114 | 115 | * `local_settings.py` - Contains all the configuration options for the app, 116 | including Twilio credentials and the URIs you want to which you wish to direct 117 | your mobile users. 118 | * `app.py` - The meat of the app. Contains all the logic for rendering the 119 | form, sending the invites, and redirecting mobile users. 120 | * `tests` - Test suite testing the web, Twilio and form validation functionality 121 | of this example. 122 | * `templates` - The gorgeous interface I surreptitiously from 123 | [Andres](http://twitter.com/enborra). 124 | * `static` - Location of the styles for above. 125 | 126 | 127 | ## Meta 128 | 129 | * No warranty expressed or implied. Software is as is. Diggity. 130 | * [MIT License](http://www.opensource.org/licenses/mit-license.html) 131 | * Lovingly crafted by [Twilio](http://www.twilio.com) 132 | 133 | 134 | Call your folks. They'd like to hear from you. 135 | 136 | 137 | [](http://githalytics.com/RobSpectre/Call-Your-Family) 140 | -------------------------------------------------------------------------------- /app.py: -------------------------------------------------------------------------------- 1 | import os 2 | import signal 3 | 4 | 5 | from flask import Flask 6 | from flask import render_template 7 | from flask import url_for 8 | from flask import request 9 | 10 | from twilio import twiml 11 | from twilio.util import TwilioCapability 12 | 13 | 14 | # Declare and configure application 15 | app = Flask(__name__, static_url_path='/static') 16 | app.config.from_pyfile('local_settings.py') 17 | 18 | 19 | @app.route('/', methods=['GET', 'POST']) 20 | def index(): 21 | # Make sure we have this host configured properly. 22 | config_errors = [] 23 | for option in ['TWILIO_ACCOUNT_SID', 'TWILIO_AUTH_TOKEN']: 24 | if not app.config[option]: 25 | config_errors.append("%s is not configured for this host." 26 | % option) 27 | 28 | # Create capability token 29 | capability = TwilioCapability(app.config.get('TWILIO_ACCOUNT_SID', None), 30 | app.config.get('TWILIO_AUTH_TOKEN', None)) 31 | capability.allow_client_outgoing(app.config.get('TWILIO_APP_SID', None)) 32 | token = capability.generate() 33 | 34 | # Define important links 35 | params = { 36 | 'sms_request_url': url_for('.sms', _external=True), 37 | 'token': token, 38 | 'config_errors': config_errors} 39 | 40 | return render_template('index.html', params=params) 41 | 42 | 43 | @app.route('/voice', methods=['POST']) 44 | def voice(): 45 | response = twiml.Response() 46 | with response.dial(callerId=app.config['TWILIO_CALLER_ID'], 47 | timeLimit="600") as dial: 48 | dial.number(request.form['PhoneNumber']) 49 | return str(response) 50 | 51 | 52 | @app.route('/inbound', methods=['POST']) 53 | def inbound(): 54 | response = twiml.Response() 55 | response.play('/static/sounds/inbound.mp3') 56 | return str(response) 57 | 58 | 59 | @app.route('/sms', methods=['GET', 'POST']) 60 | def sms(): 61 | # Respond to any text inbound text message with a link to the app! 62 | response = twiml.Response() 63 | response.sms("This number belongs to the Twilio Call Your Family app " \ 64 | "for Boston. Please visit " \ 65 | "http://callyourfamily.twilio.ly for more info.") 66 | return str(response) 67 | 68 | 69 | # Handles SIGTERM so that we don't get an error when Heroku wants or needs to 70 | # restart the dyno 71 | def graceful_shutdown(signum, frame): 72 | exit() 73 | 74 | signal.signal(signal.SIGTERM, graceful_shutdown) 75 | 76 | 77 | if __name__ == '__main__': 78 | port = int(os.environ.get("PORT", 5000)) 79 | if port == 5000: 80 | app.debug = True 81 | app.run(host='0.0.0.0', port=port) 82 | -------------------------------------------------------------------------------- /bower.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "twilio-call-your-family", 3 | "version": "1.0.0", 4 | "authors": [ 5 | "Rob Spectre
{{ error }}
46 | {% endfor %} 47 | {% else %} 48 |1. Select the country you wish to call.
50 |2. Input the number.
51 |3. Press Call button.
52 |4. Click "Allow" in your browser or dialog.
53 |5. Talk through your browser for ten minutes.
54 | {% endif %} 55 |Input the phone number to call below:62 |
Check your local_settings.py to set these missing 29 | options:
30 |