Click to Call with Flask

This is an application example implementing Click to Call using Twilio.

Read the full tutorial here!

Local development

This project is built using the Flask web framework. It runs on Python 2.7+ and Python 3.4+.

To run the app locally, first clone this repository and cd into its directory. Then:

1. Create a new virtual environment:

   • If using vanilla virtualenv:

     virtualenv venv
     source venv/bin/activate
     

   • If using virtualenvwrapper:

     mkvirtualenv clicktocall-flask
     

2. Install the requirements:

   pip install -r requirements.txt
   

3. Copy the .env.example file to .env, and edit it including your credentials for the Twilio API (found at https://www.twilio.com/user/account/settings). You will also need a Twilio Number.

4. Run source .env to apply the environment variables (or even better, use autoenv)

5. Expose your application to the wider internet using ngrok. You can click here for more details. This step is important because the application won't work as expected if you run it through localhost.

   $ ngrok http 5000

6. Start the development server:

   make run
   

Once Ngrok is running, open up your browser and go to your Ngrok URL. It will look like this: http://9a159ccf.ngrok.io

That's it!

Testing

This app comes with a full testing suite ready for nose.

$ make test

Meta

• No warranty expressed or implied. Software is as is. Diggity.
• MIT License
• Lovingly crafted by Twilio Developer Education.