Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Use Voice Add-ons in Python

In this guide we’ll cover how to combine Twilio Add-ons with Programmable Voice to use data from Twilio's partners in your Python web application. The sample code in this guide will use the Twilio Python SDK and the Flask web framework. Let's get started!

What's an Add-on?

Twilio Add-ons are pre-integrated third party services that you can use with your Twilio application. Add-ons enhance the responses your application receives from Twilio by including additional data from Twilio’s partners.

        
        
        
        
        This is a sample of the payload your application would receive when using the WhitePages Pro add-on

        Sample data from the Whitepages Pro add-on

        This is a sample of the payload your application would receive when using the WhitePages Pro add-on

        Here’s an example that uses the Whitepages Pro Caller Identification add-on. When you enable this add-on in your Twilio Console, Twilio will include this data with its requests to your application for incoming phone calls.

        The Whitepages Pro Caller Identification add-on gives your application more detailed information about the caller, like their name and address. But that’s just one add-on — there are more you can use from Twilio partners like IBM Watson and Wolfram Alpha, among others.

        See the Add-ons Catalog for the complete list of available add-ons.

        Enabling Add-ons in the Twilio Console

        The first stop in using an add-on is your Twilio Console. Log in and navigate to the Add-ons page within the Marketplace section.

        Add-ons catalog

        Then choose on the add-on you want to enable and click the “Install” button. In this example, we’ll use the Whitepages Pro Caller Identification add-on.

        Install an Add-on

        Once installed, be sure to check the box for “Incoming Voice Call” and click save. This will tell Twilio to use the add-on with incoming calls to your Twilio phone numbers.

        Now we’re ready to use the extra data from our add-on in our Python application.

        Using Add-on data in your application

        Twilio will include data from all of your add-ons in an “AddOns” field on requests it makes to your application.

              
              
              
              
              Use the Whitepages Pro Caller ID add-on to tell a caller their name and where they live

              Use the Whitepages Pro add-on to respond to an incoming phone call

              Use the Whitepages Pro Caller ID add-on to tell a caller their name and where they live

              This Flask application uses the data from the Whitepages Pro Caller ID add-on we configured above to tell the caller their name and what city we think they live in.

              You can find a detailed specification of the data structure for an individual add-on within that add-on's page in the catalog.

              And that’s it! Try giving your application a call to see your add-on in action. If you've never received a Twilio phone call with Python before, check out our guide on that topic.

              Where to next?

              We focused on the Whitepages add-on in this guide, but you can just as easily use any of the add-ons available in the catalog in your Twilio Console.

              Check out the full Add-Ons API Reference documentation if you want to learn more about how add-ons work, or even how to publish your own.

              Andrew Baker Ricky Robinett Rob Spectre Kevin Whinnery David Prothero
              Rate this page:

              Need some help?

              We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.