クイックスタート: SMS と配信レポートのイベントを処理する

Azure Event Grid を使用して Communication Services の SMS イベントを処理することにより、Azure Communication Services を開始します。 インバウンド メッセージや配信レポートなどの SMS イベントをサブスクライブした後、これらのイベントを生成して受信します。 このクイックスタートを完了すると、ご利用の Azure アカウントでわずかな (数セント未満の) コストが発生します。

重要

SMS と PSTN 機能は、使用する電話番号と、Azure の請求先住所によって決まる、運用している国およびリージョンによって異なります。 詳細については、サブスクリプションの資格に関するドキュメントを参照してください。

前提条件

Event Grid について

Event Grid は、クラウドベースのイベント処理サービスです。 この記事では、Communication Services のイベントをサブスクライブし、イベントをトリガーして結果を表示する方法について説明します。 通常は、イベント データを処理し、アクションを実行するエンドポイントにイベントを送信します。 この記事では、メッセージを収集して表示する Web アプリにイベントを送信します。

環境をセットアップする

イベントの生成と受信に使用する環境を設定するには、次のセクションの手順のようにします。

Event Grid リソース プロバイダーを登録する

これまでに Azure サブスクリプションで Event Grid を使ったことがない場合は、Event Grid リソース プロバイダーの登録が必要な可能性があります。 プロバイダーを登録するには、次の手順のようにします。

  1. Azure Portal にアクセスします。
  2. 左側のメニューで [サブスクリプション] を選択します。
  3. Event Grid に使うサブスクリプションを選びます。
  4. 左側のメニューの [設定] で、 [リソース プロバイダー] を選択します。
  5. Microsoft.EventGrid を探します。
  6. リソース プロバイダーが登録されていない場合は、[登録] を選びます。

登録完了まで少し時間がかかることがあります。 [最新の情報に更新] を選択して、状態を更新します。 [状態][登録済み] と表示されたら、次に進むことができます。

Event Grid ビューアーをデプロイする

このクイックスタートでは、Event Grid ビューアーを使って、準リアルタイムでイベントを表示します。 ビューアーにより、リアルタイム フィードのエクスペリエンスがユーザーに提供されます。 また、各イベントのペイロードを検査に使用できるようになるはずです。

ビューアーを設定するには、「Azure Event Grid ビューアー」の手順のようにします。

Webhook を使用して SMS イベントをサブスクライブする

特定のイベントをサブスクライブして、追跡するイベントの送信先に関する情報を Event Grid に提供できます。

  1. ポータルで、作成した Communication Services リソースに移動します。

  2. Communication Service リソース内で、[Communication Services] ページの左側のメニューの [イベント] を選びます。

  3. [Add Event Subscription](イベント サブスクリプションの追加) を選びます。

    Azure Communication Services リソースの [イベント] ページを示すスクリーンショット。[イベント サブスクリプション] ボタンが強調表示されています。

  4. [イベント サブスクリプションの作成] ページで、イベント サブスクリプションの名前を入力します。

  5. [イベントの種類] で、サブスクライブするイベントを選びます。 SMS の場合は、[SMS Received] と [SMS Delivery Report Received] を選ぶことができます。

  6. システム トピック名の入力を求められた場合は、一意の文字列を自由に指定してかまいません。 このフィールドはエクスペリエンスに影響を与えず、内部テレメトリの目的で使用されます。

    [イベント サブスクリプションの作成] ダイアログを示すスクリーンショット。[イベントの種類] で、SMS Received と SMS Delivery Report Received が選択されています。

  7. [エンドポイントの種類] では、[webhook] を選びます。

    [イベント サブスクリプションの作成] ダイアログの詳細を示すスクリーンショット。[エンドポイントの種類] の一覧で、[Web Hook] が選択されています。

  8. [エンドポイント] では、[エンドポイントの選択] を選び、自分の Web アプリの URL を入力します。

    ここでは、クイックスタートで前に設定した Event Grid ビューアーの URL を使います。 サンプルの URL は、https://{{site-name}}.azurewebsites.net/api/updates という形式になっています。

  9. [選択の確認] を選択します。

    [webhook の選択] ダイアログを示すスクリーンショット。[サブスクライバー エンドポイント] ボックスには URL が含まれており、[選択の確認] ボタンが表示されます。

SMS のイベントを表示する

SMS のイベントを生成して受信するには、次のセクションの手順のようにします。

SMS イベントをトリガーする

イベント トリガーを表示するには、いくつかのイベントを生成する必要があります。

  • SMS Received イベントは、Communication Services の電話番号がテキスト メッセージを受信したときに生成されます。 イベントをトリガーするには、電話から、Communication Services リソースにアタッチされている電話番号にメッセージを送信します。
  • SMS Delivery Report Received イベントは、Communication Services の電話番号を使ってユーザーに SMS を送信したときに生成されます。 イベントをトリガーするには、送信する SMSDelivery Report オプションをオンにする必要があります。 Delivery Report を有効にして、電話にメッセージを送信してみてください。 このアクションを完了すると、ご利用の Azure アカウントでわずかな (数セント未満の) コストが発生します。

Communication Services でサポートされているイベントの完全な一覧を確認してください。

SMS イベントを受信する

イベントを生成すると、エンドポイントに SMS ReceivedSMS Delivery Report Received イベントが送信されることがわかります。 これらのイベントは、このクイックスタートで最初に設定した Event Grid ビューアーに表示されます。 ペイロード全体を表示するには、イベントの横にある目のアイコンを選びます。 イベントは次のデータのようになっているはずです。

SMS 受信イベントの Event Grid スキーマを示す Azure Event Grid ビューアーのスクリーンショット。

SMS 配信レポート イベントの Event Grid スキーマを示す Azure Event Grid ビューアーのスクリーンショット。

詳細については、イベント スキーマとその他のイベントの概念に関する記事を参照してください。

リソースをクリーンアップする

Communication Services サブスクリプションをクリーンアップして解除する場合は、リソースまたはリソース グループを削除できます。 リソース グループを削除すると、それに関連付けられている他のリソースも削除されます。 詳細については、リソースのクリーンアップに関する記事を参照してください。

次の手順

このクイックスタートでは、SMS イベントの使用方法について説明しました。 Event Grid サブスクリプションを作成することによって SMS メッセージを受信できます。

次の記事もご覧ください。