A module for using the Twilio REST API and generating valid TwiML.
Install from PyPi using pip
pip install twilio
Getting started with the Twilio API couldn't be easier. Create a Twilio REST client to get started. For example, the following code makes a call using the Twilio REST API.
TwilioRestClient
needs your Twilio credentials. While these can be passed in directly to the constructor, we suggest storing your credentials as environment variables. Why? You'll never have to worry about committing your credentials and accidentally posting them somewhere public.
The TwilioRestClient
looks for TWILIO_ACCOUNT_SID
and TWILIO_AUTH_TOKEN
inside the current environment.
from twilio.rest import TwilioRestClient
account = "AXXXXXXXXXXXXXXXXX"
token = "YYYYYYYYYYYYYYYYYY"
client = TwilioRestClient(account, token)
call = client.calls.create(to="9991231234", from_="9991231234",
url="http://foo.com/call.xml")
print call.length
print call.sid
TwilioRestClient
needs your Twilio credentials. While these can be passed in directly to the constructor (see above), we suggest storing your credentials as environment variables. Why? You'll never have to worry about committing your credentials and accidentally posting them somewhere public.
The TwilioRestClient
looks for TWILIO_ACCOUNT_SID
and TWILIO_AUTH_TOKEN
inside the current environment.
from twilio.rest import TwilioRestClient
client = TwilioRestClient()
To control phone calls, your application need to output TwiML. Use twilio.twiml..Response
to easily create such responses.
from twilio import twiml
r = twiml.Response()
r.play("monkey.mp3", loop=5)
print str(r)
<?xml version="1.0" encoding="utf-8"?>
<Response><Play loop="5">monkey.mp3</Play><Response>
The full power of the Twilio API is at your finger tips. The full documentation explains all the awesome features available to use.