メニュー

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?

Pythonでの録音Add-onの使用方法

Twilio Add-onとProgrammable Voiceを組み合わせて、Flask WebアプリケーションでTwilioのパートナー企業から提供されるデータを使う方法について見ていきます。 さぁ、はじめましょう!

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.

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

        
        
        
        
        これは、IBM Watson Speech to Text Add-onの使用時にアプリケーションが受け取るペイロードのサンプルです。

        Sample data from the IBM Watson Speech to Text Add-on

        これは、IBM Watson Speech to Text Add-onの使用時にアプリケーションが受け取るペイロードのサンプルです。

        下記はIBM WatsonのSpeech to Text Add-onを使用した例になります。 生成された音声文字化の結果はTwilioからのコールバック経由でアプリケーションに配信されます。


        IBM Watson Speech Add-onはマシンインテリジェンスを使用して文法と言語構造からの情報を組み合わせ、Twilioのオーディオ録音をテキストに変換できます。

              
              
              
              
              これはAdd-onパートナーが上記のペイロードのURL内で提供するサンプルの分析です。

              IBM Watson Speech to Text Add-onからの録音分析のサンプル

              これはAdd-onパートナーが上記のペイロードのURL内で提供するサンプルの分析です。

              利用可能なAdd-onの全リストについては、Add-onカタログを参照してください。

              TwilioコンソールでAdd-onを有効にする

              Add-onの使用に当たってまずご確認いただく場所は、Twilioコンソールになります。 コンソールにログイン後、Marketplaceセクション内のAdd-onページに移動してください。

              アドオンカタログ

              続いて、有効にしたいAdd-onを選択し、「インストール」ボタンをクリックします。 サービス使用条件の受諾後、アカウントにインストールされます。 この例では、IBM Watson Speech to Text Add-onを使用します。

              IBM Watson Speech to Text Add-onのインストール


              Once installed, select the checkbox for the recording method you are using (see the different recording methods here). In our example to follow, we would only need the "Record Verb Recordings".

              Set the "Callback URL" and "Callback Request Method" as appropriate for your public server URL (instructions below).

              Pro Tip: you can quickly inspect what Twilio will send to your callback URL using tools like PostBin before you actually set up your server.

              IBM Watson Speech to Text 構成タブ

              Legal implications of call recording

              If you choose to record voice or video calls, you need to comply with certain laws and regulations, including those regarding obtaining consent to record (such as California’s Invasion of Privacy Act and similar laws in other jurisdictions). Additional information on the legal implications of call recording can be found here.



              Notice: Twilio recommends that you consult with your legal counsel to make sure that you are complying with all applicable laws in connection with communications you record or store using Twilio.

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

              アプリケーション上でAdd-onのデータを使用する

              Twilioは、すべてのAdd-onの情報をアプリケーションへのリクエスト上の "AddOns"フィールドに含めます。下記の例は、Flaskアプリケーション内からAdd-onのデータにアクセスする方法を示しています。

                    
                    
                    
                    
                    IBM Watson Speech To Text Add-Onを使用して、録音の文字化データを取得します。

                    IBM Watson Speech to Text Add-onの使用

                    IBM Watson Speech To Text Add-Onを使用して、録音の文字化データを取得します。

                    Twilioコンソールで構成したIBM Watson Speech to Text Add-onによって、アプリケーションで録音された通話に対してテキスト化を実現できます。 個々のAdd-onにおけるデータ構造の詳細については、カタログ内のこれらAdd-onのページをご確認ください。

                    これで一丁あがり! アプリケーションに電話をかけてみて、Add-onが実際に動作している様子を確認してみましょう。 PythonでTwilioでの通話着信を行うのが初めての場合は、ガイド中の関連トピックを参照してください。

                    関連トピック

                    このガイドではIBM Watson Speech to Text Add-onに的を絞って取り上げましたが、Twilio Console内のカタログ上で利用できる任意のAdd-onも同じように簡単に使用できます。

                    Add-onの仕組みについてさらに理解を深めたい、さらにはご自身でAdd-onを提供したい場合は、「Add-on APIリファレンスドキュメンテーション」をご参照ください。

                    Agustin Camino Ricky Robinett Rob Spectre David Prothero Stephen Wai Hector Ortega Andrew Baker Kat King Kevin Whinnery
                    Rate this page:

                    ヘルプが必要ですか?

                    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.