Twilio による SMS サービスおよび音声サービスの使用

Twilio は今後のビジネス コミュニケーションの要となる企業であり、デベロッパーが音声、VoIP、メッセージをアプリケーションに組み込むためのメカニズムを提供しています。また、クラウドベースのグローバル環境に必要なすべてのインフラストラクチャを仮想化し、Twilio 通信 API プラットフォーム経由で公開しています。アプリケーションはビルドが簡単で、拡張可能です。従量課金制であるため柔軟性に富み、クラウドは信頼性が高いことから安心して使用できます。

Twilio Voice を使用すると、アプリケーションで電話をかけたり受けたりできます。Twilio SMS を使用すると、アプリケーションでテキスト メッセージを送受信できます。Twilio Client を使用すると、あらゆる電話、タブレット、ブラウザから IP 電話を発信できます。WebRTC がサポートされています。

料金

Google App Engine 利用者はアップグレードすると、SMS メッセージまたは着信に使用できる無料クレジットが付与されます。

Twilio は従量課金制のサービスです。アカウントの開設料金は発生せず、アカウントはいつでも閉鎖できます。詳細については、Twilio 料金をご覧ください。

プラットフォーム

Twilio プラットフォームは、Twilio マークアップ言語(TwiML)、RESTful API、VoIP SDK(ウェブブラウザ、Android、iOS 用)で構成されています。ヘルパー ライブラリは複数の言語で利用できます。完全なリストについては、Twilio ヘルパー ライブラリをご覧ください。

TwiML

TwiML は、着信通話または SMS を受信したときに何をすべきかを Twilio に指定するために使用できる一連の指示です。他者から自分のいずれかの Twilio 番号に着信があったり SMS が送信されてきたりすると、Twilio はその電話番号に関連付けられている URL を検索し、その URL にリクエストを行います。URL の TwiML 指示を読み取って、以下のどの処理を実行すべきかを判別します。

  • <Say> - テキストを音声に変換する
  • <Record> - 通話を録音する
  • <Play> - 発信者向けのメッセージを再生する
  • <Gather> - 発信者にキーパッドの数字を押すように指示する
  • <Message> - メッセージを送信する

その他の動詞や機能については、Twilio マークアップ言語のドキュメントをご覧ください。

REST API

Twilio REST API を使用すると、自分のアカウント、電話番号、通話、テキスト メッセージ、録音に関するメタデータをクエリできます。また、通話を発信したり、テキスト メッセージを送信したりすることもできます。

API は REST の原則に基づいているため、アプリケーションの作成とテストは非常に簡単です。ブラウザを使用して URL にアクセスし、あらゆるプログラミング言語のほぼすべての HTTP クライアントを使用して API と対話できます。詳細については、Twilio REST API をご覧ください。

サンプルコードのコピー

Twilio との統合を示す完全なコードサンプルは、GitHub から入手できます。このサンプルコードを使用する場合は、ローカルマシンにコピーしてください。

git clone https://github.com/GoogleCloudPlatform/php-docs-samples
cd php-docs-samples/appengine/flexible/twilio

セットアップ

以下の手順で、Twilio を使用して着信通話を受信、SMS を送信、または SMS を受信します。

  1. プロジェクトを作成します。詳細は、App Engine 上の PHP に関する「Hello, World!」をご覧ください。

  2. Twilio アカウントを作成します。

  3. Twilio で番号を作成します。自分の Twilio 番号のアプリ用 URL を必要に応じて設定します。たとえば、サンプルコード用であれば、以下のようになります。

    • 音声リクエスト URL の設定: https://[your-app-id].appspot.com/call/receive
    • SMS リクエスト URL の設定: https://[your-app-id].appspot.com/sms/receive
  4. app.yaml の環境変数セクションで Twilio を構成します。例:

    env_variables:
        TWILIO_ACCOUNT_SID: your-account-sid
        TWILIO_AUTH_TOKEN: your-auth-token
        TWILIO_FROM_NUMBER: your-twilio-number

  5. Composer をインストールします。

  6. Twilio のライブラリをアプリケーションの composer.json に追加します。例:

    composer require twilio/sdk
    
  7. アプリのローカルテストの準備をするため、コマンドラインでローカルマシンの環境変数を設定します。たとえば、サンプルコード用であれば、以下のようになります。

    export TWILIO_ACCOUNT_SID=[YOUR_TWILIO_ACCOUNT_SID]
    export TWILIO_AUTH_TOKEN=[YOUR_TWILIO_AUTH_TOKEN]
    export TWILIO_NUMBER=[YOUR_TWILIO_NUMBER]
    
  8. アプリケーションをローカルで実行して、コールバックと SMS 送信をテストできます。次に例を示します。

    php -S localhost:8080
    

着信通話の受信

設定を完了したら、最初のアプリケーションを作成します。

app.php/call/receive ハンドラは、着信に応答し、TwiML の指示を返す方法を示しています。

/***
 * Answers a call and replies with a simple greeting.
 */
$app->post('/call/receive', function () use ($app) {
    $response = new Services_Twilio_Twiml();
    $response->say('Hello from Twilio!');
    return new Response(
        (string)$response,
        200,
        ['Content-Type' => 'application/xml']
    );
});
  1. プロジェクトを App Engine にデプロイします。プロジェクトをデプロイしたら、POST リクエストを http://your-app-id.appspot.com/call/receive に送信します。これにより、以下のテキストが返されます。

    <?xml version="1.0" encoding="UTF-8"?>
      <Response>
        <Say>Hello from Twilio!</Say>
      </Response>
    
  2. http://your-app-id.appspot.com/call/receive URL をコピーして、Twilio アカウントの [番号(Numbers)] ページの [音声 URL(Voice URL)] ボックスに貼り付けます。

  3. 自分の Twilio 番号を入力して発信します。応答で「Hello from Twilio!」という音声が聞こえます。発信すると、Twilio があなたの URL をフェッチして、上記の XML 指示を実行し、指示がなくなったら通話を切断します。

SMS の送信

Twilio を使用して SMS を送信するには、twilio-php ヘルパー ライブラリを使用します。

/***
 * Send an sms.
 */
$app->post('/sms/send', function (Request $request) use ($app) {
    $twilio = new Services_Twilio(
        $app['twilio.account_sid'], // Your Twilio Account SID
        $app['twilio.auth_token']   // Your Twilio Auth Token
    );
    $sms = $twilio->account->messages->sendMessage(
        $app['twilio.number'], // From this number
        $request->get('to'),   // Send to this number
        'Hello from Twilio!'
    );
    return sprintf('Message ID: %s, Message Body: %s', $sms->sid, $sms->body);
});
  1. 実際の電話番号を使用するように to パラメータを変更します。to の番号は携帯電話番号などの任意の発信番号に設定できます。

  2. 更新されたコードをデプロイし、URL http://your-app-id.appspot.com/sms/send をウェブブラウザに入力して SMS を送信します。

SMS の受信

Twilio を使用して着信 SMS を受信するには、twilio-php ヘルパー ライブラリを使用します。

app.php/sms/receive ビューは、着信 SMS に応答し、TwiML の指示を返す方法を示しています。

/***
 * Receive an sms.
 */
$app->post('/sms/receive', function (Request $request) use ($app) {
    $sender = $request->get('From');
    $body = $request->get('Body');
    $message = "Hello, $sender, you said: $body";
    $response = new Services_Twilio_Twiml();
    $response->message($message);
    return new Response(
        (string) $response,
        200,
        ['Content-Type' => 'application/xml']
    );
});

更新されたコードを App Engine にデプロイし、SMS を自分の Twilio 番号に送信します。応答でグリーティングが届きます。

Twilio のその他の詳細

いくつかの基本事項を学習しました。また、セキュアでスケーラブルなアプリケーションを構築するためのその他の大切な点や推奨される方法をご覧ください。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

PHP の App Engine フレキシブル環境に関するドキュメント