ボットを Twilio (SMS) に接続する

  • [アーティクル]

この記事の対象: SDK v4

Twilio (SMS) クラウド通信プラットフォームを使用してユーザーと通信するようにボットを構成できます。 この記事では、TwiML アプリケーションを作成し、Azure portal でボットを接続することで、Twilio を使用して通信するようにボットを構成する方法について説明します。

前提条件

  • Azure アカウント。 まだお持ちでない場合は、開始する前に無料アカウントを作成してください。
  • Azure に公開された既存のボット。

TwiML アプリケーションを作成します

  1. Twilio アカウントを持っていない場合は、新しいアカウントを作成します。 Twilio アカウントを既にお持ちの場合は、次の手順に進みます。
  2. TwiML アプリケーションの作成の手順に従う。

    • TwiML アプリのフレンドリ名を入力します。

    • [音声構成] で、[要求 URL] を空のままにします

    • [メッセージングの構成] で、要求 URL を設定します。

      • グローバル ボットの場合は、「https://sms.botframework.com/api/sms」と入力します。
      • リージョン ボットの場合は、選択したリージョンに応じて次の URL を入力します。
      リージョン 要求 URL
      ヨーロッパ https://europe.sms.botframework.com/api/sms
      インド https://india.sms.botframework.com/api/sms

電話番号を選択または追加する

手順に従って、コンソール経由で確認済みの呼び出し元を追加します。 確認済みの発信者番号が既にある場合は、これをスキップできます。

完了すると、確認済みの呼び出し元 ID に 確認済みの番号が表示されます。

音声とメッセージに使用する TwiML アプリを指定する

確認済みの発信者番号を追加した後、作成した TwiML アプリを使用するように番号の設定を構成します。

  1. [電話番号 > 管理] で [アクティブな番号]を選択します。 番号を選択し、[構成] に移動します。
  2. [音声と FAX] と [メッセージング] の両方で、[Configure With] を [TwiML アプリ] に設定します。 TwiML APP を先ほど作成した TwiML アプリに設定します。 完了後は、[保存] を選択します。
  3. [アクティブな数値] をもう一度選択します。 音声とメッセージングの両方のアクティブな構成が TwiML アプリに設定されていることがわかります。

Twilio から資格情報を収集する

  1. 「Twilio コンソールの ホーム ページ」に戻る

  2. [アカウント情報] の下に、次に示すように、プロジェクト ダッシュボードにアカウント SID と認証トークンが表示されます。 後の手順のためにこれらの値をコピーして保存します。

    Gather app credentials from Twilio Console

Azure portal で Twilio 資格情報を入力する

Twilio から必要な値を取得したら、Azure portal でボットを Twilio に接続します。

  1. 別のウィンドウかタブで、Azure portal に移動します。

  2. Twilio に接続するボットを選択します。

  3. [設定] で [チャンネル] を選択し、[使用可能なチャネル] の一覧から Twilio (SMS) アイコンを選択します。

  4. 前に保存した電話番号、アカウント SID、および認証トークンを入力します。 完了後は、[Apply (適用)] を選択します。

    Enter Twilio credentials in Azure

これで、ボットは Twilio のユーザーと通信するように正常に構成されました。

Twilio でボットをテストする

自分のボットが Twilio に正しく接続されているかどうかをテストするには、SMS メッセージを自分の Twilio 番号に送信します。 ボットがメッセージを受信すると、メッセージを自身に送り返し、そのメッセージのテキストをエコーする形で自身にメッセージを返します。

追加情報

Twilio の開発の詳細については、「Twilio SMS のドキュメント」を 参照してください。

Twilio アダプターを使用してボットを Twilio に接続する

Bot Builder Community リポジトリでは、使用可能な Azure AI Bot Service チャネルを使用してボットを Twilio に接続するだけでなく、Twilio 用のカスタム チャネル アダプターを定義します。