このドキュメントでは、Azure Event Grid ビューアーまたは RequestBin を使用してAzure Communication Services リソースがイベントを送信していることを検証する方法について説明します。
Note
Azure Event Grid を使用すると、追加のコストが発生します。 詳しくは、Azure Event Grid の価格に関するページをご覧ください。
前提条件
- アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
- アクティブな Communication Services リソースと接続文字列。 Communication Services のリソースを作成する。
- Azure CLI をインストールします。
Azure Event Grid ビューアーが既にデプロイされている場合、またはより堅牢なビューアーを配置したい場合は、指示に従ってデプロイできます。 Event Grid ビューアーによって生成されたエンドポイントが必要です。
または、イベントをすばやく簡単に検証する方法が必要な場合は、RequestBin を使用できます。 RequestBin には、選択できる 2 つのモダリティが用意されています。 イベントをすばやくテストする場合は、パブリック エンドポイントの設定を使用できます。 これらのパブリック エンドポイントは、すべてのユーザーが URL を使用してイベント データにアクセスできるようにします。 プライベートのままにする場合は、RequestBin アカウントを作成し、プライベート エンドポイントを作成できます。 詳細については、RequestBin のパブリック エンドポイントとプライベート エンドポイントの比較を参照してください。
以降の手順は、両方のオプションで同じです。
エンドポイントにイベントを送信するように Azure Communication Services リソースを構成する
Azure CLI を使用して、前提条件で作成したエンドポイントを構成し、Azure Communication Services リソースからイベントを受信します。 Azure portal で見つかった Azure Communication Services リソースのリソース ID が必要です。
az eventgrid event-subscription create --name "<<EVENT_SUBSCRIPTION_NAME>>" --endpoint-type webhook --endpoint "<<URL>> " --source-resource-id "<<RESOURCE_ID>>" --included-event-types Microsoft.Communication.SMSReceivedこのコマンドでは、
Microsoft.Communication.SMSReceivedイベントの種類のみを追加しました。 さらにイベントを受信する場合は、コマンドにイベントの種類を追加できます。 すべてのイベントの種類の一覧については、Azure Communication Services イベントに関するページを参照してください。(省略可能。RequestBin を使用している場合のみ) エンドポイントに投稿された最初のイベントで
validationURLをコピーする必要があります。 その URL をブラウザーに貼り付けて、エンドポイントを検証する必要があります。 そのページには、"Webhook successfully validated as a subscription endpoint" (Webhook がサブスクリプション エンドポイントとして正常に検証されました) と表示されます。
イベントの表示
イベントを受信するようにエンドポイントを構成したので、それを使用してイベントの受信時にイベントを表示できます。