Github: https://github.com/twilio/twilio-python
twilio-python
Twilio REST APIを使用して有効なTwiMLを生成するためのモジュール。
最近の更新
リリース6.5.0以降、BetaおよびDeveloper Preview製品は、主要なtwilio-python
アーティファクトを介して公開されています。 alpha
支店のリリースは中止されました。
alpha
リリースラインを使用していた場合は、通常のリリースラインに問題なく戻すことができます。
通常のリリースラインを使用していた場合は、ベータ版または開発者プレビューのステータスにより、歴史的に隠されていたいくつかの新製品ラインが表示されるはずです。 このような製品は、Twilioのドキュメントとコンソールの両方でBeta / Developer Previewとして明示的に記述されています。
インストール
Pythonのパッケージマネージャであるpipを使ってPyPiからインストールします。
pip install twilio
pipをインストールしないでください。 コマンドラインからこれを実行して、インストールを試してください:
$ curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python
または、 twilio-python
のソースコード(ZIP)をダウンロードして 、次のtwilio-python
を実行することもできます 。
python setup.py install
sudo
上記のコマンドを実行する必要があるかもしれません。
5.xから移行する
twilio-python 5.xから6.xを使用してアプリケーションをアップグレードする方法については、 公式の移行ガイドを参照してください。
フィードバック
このリリース候補のフィードバックや問題をtwilio-pythonのGithub Issuesに報告してください。
入門
Twilio APIを使い始めるのは簡単ではありませんでした。 Client
を作成すると、準備が整いました。
API資格情報
Twilio
はTwilioの資格が必要です。 これらをコンストラクターに直接渡すか(以下のコードを参照)、環境変数を使用して渡すことができます。
from twilio.rest import Client
account = "ACXXXXXXXXXXXXXXXXX"
token = "YYYYYYYYYYYYYYYYYY"
client = Client(account, token)
あるいは、これらのパラメータを持たないClient
コンストラクタは、現在の環境内でTWILIO_ACCOUNT_SID
およびTWILIO_AUTH_TOKEN
変数を探します。
環境変数として資格情報を保存することをお勧めします。 どうして? あなたは信任状を託すことを心配する必要はなく、誤ってどこかに公開することを心配する必要はありません。
from twilio.rest import Client
client = Client()
電話を掛ける
from twilio.rest import Client
account = "ACXXXXXXXXXXXXXXXXX"
token = "YYYYYYYYYYYYYYYYYY"
client = Client(account, token)
call = client.calls.create(to="9991231234",
from_="9991231234",
url="http://twimlets.com/holdmusic?Bucket=com.twilio.music.ambient")
print(call.sid)
SMSを送信する
from twilio.rest import Client
account = "ACXXXXXXXXXXXXXXXXX"
token = "YYYYYYYYYYYYYYYYYY"
client = Client(account, token)
message = client.messages.create(to="+12316851234", from_="+15555555555",
body="Hello there!")
TwiMLを使用した通話の処理
電話を制御するには、アプリケーションでTwiMLを出力する必要があります。 twilio.twiml.Response
を使用すると、そのようなレスポンスを簡単に作成できます。
from twilio.twiml.voice_response import VoiceResponse
r = VoiceResponse()
r.say("Welcome to twilio!")
print(str(r))
<?xml version="1.0" encoding="utf-8"?>
<Response><Say>Welcome to twilio!</Say></Response>