SMS メッセージを受信する

Event Grid では、Azure Functions のすぐに使用できるサポートが提供されるため、ヘッダーの解析や Webhook のデバッグの複雑さに対処することなく、イベント リスナーを簡単に設定できます。 すぐに使用できるトリガーを使用して、トリガーに一致するイベントが検出されるたびに実行される Azure 関数を設定できます。 このドキュメントでは、SMS 受信トリガーについて説明します。

ローカル環境の設定

1. Visual Studio Code を使用して、Azure Functions 拡張機能をインストールします。

2. 拡張機能を使用して、次の手順に従って Azure 関数を作成 します。

   次の手順で関数を構成します。

   • 言語: TypeScript
   • テンプレート: Azure Event Grid トリガー
   • 関数名:ユーザー定義

   作成されると、次のような関数がディレクトリに作成されます。

   
   import { AzureFunction, Context } from "@azure/functions"
   
   const eventGridTrigger: AzureFunction = async function (context: Context, eventGridEvent: any): Promise<void> {
       context.log(eventGridEvent);
   
   };
   
   export default eventGridTrigger;
   
   

SMS イベントを受信するように Azure 関数を構成する

1. イベントの値 (送信者など) から、メッセージの数と内容を解析するように Azure 関数を構成します。

   
   import { AzureFunction, Context } from "@azure/functions"
   
   const eventGridTrigger: AzureFunction = async function (context: Context, eventGridEvent: any): Promise<void> {
      context.log(eventGridEvent);
      const to = eventGridEvent['data']['to'];
      const from = eventGridEvent['data']['from'];
      const message = eventGridEvent['data']['message'];
   
   };
   
   export default eventGridTrigger;
   
   

この時点で、イベントを介した SMS の受信は正常に処理されました。 これで、そのイベントで何を行うかの可能性は、ログ記録から応答まで多岐に及みます。 次のセクションでは、受信した SMS に対応することに重点を置いて説明します。 SMS に応答しない場合は、関数をローカルで実行する次のセクションに進んでください。

SMS への応答

1. 受信 SMS に応答するために、SMS を送信するために Azure Communication Service SMS 機能を使用します。 まず、 SmsClient を呼び出し、リソースの connection string で初期化します。 接続文字列をコードに直接貼り付けるか、Azure Function ディレクトリの local.settings.json ファイル内の値の下に配置できます。

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "node",
    "ACS_CONNECTION_STRING": "<<CONNECTION STRING>>"
  }
}

2. 次に、取得したイベントの to と from 値に基づいて送信する SMS を作成します。

   import { AzureFunction, Context } from "@azure/functions"
   import { SmsClient } from "@azure/communication-sms";
   
   const connectionString = process.env.ACS_CONNECTION_STRING; //Replace with your connection string
   
   const eventGridTrigger: AzureFunction = async function (context: Context, eventGridEvent: any): Promise<void> {
       context.log(eventGridEvent);
       const to = eventGridEvent['data']['to'];
       const from = eventGridEvent['data']['from'];
       const message = eventGridEvent['data']['message'];
   
       const smsClient = new SmsClient(connectionString);
   
       const sendResults = await smsClient.send({
           from: to,
           to: [from],
           message: "Message received successfully. Will respond shortly."
       });
   
   };
   
   export default eventGridTrigger;
   

ここからは、可能性は無限大です。 前書きの回答でメッセージに応答したり、ボットを追加したり、最後の手順でコードを調整して応答を格納したりできます。

ローカルで実行する

関数をローカルで実行するには、Visual Studio Code で F5 キーを押します。 ngrok を使用して、ローカルで実行されている Azure 関数を Azure Event Grid にフックします。

1. 関数が実行されたら、 ngrokを構成します。 環境に合わせて ngrok をダウンロード する必要があります。

   ngrok http 7071
   

   関数が実行されている ngrok リンクをコピーします。

2. Azure Communication Services リソース内の Event Grid を使用して SMS イベントを構成します。 これは 、Azure CLI を使用して行います。 Azure portal で見つかった Azure Communication Services リソースのリソース ID が必要です。 リソース ID は、/subscriptions/<<AZURE SUBSCRIPTION ID>>/resourceGroups/<<RESOURCE GROUP NAME>>/providers/Microsoft.Communication/CommunicationServices/ のようになります。<<RESOURCE NAME>>

   az eventgrid event-subscription create --name "<<EVENT_SUBSCRIPTION_NAME>>" --endpoint-type webhook --endpoint "<<NGROK URL>> " --source-resource-id "<<RESOURCE_ID>>"  --included-event-types Microsoft.Communication.SMSReceived 
   

3. すべてがフックされたので、Azure Communication Services リソースの電話番号に SMS を送信してフローをテストします。 関数が実行されているターミナルにコンソール ログが表示されます。 SMS に応答するコードを追加した場合は、テキスト メッセージが返されることがわかります。

Azure にデプロイする

Azure 関数を Azure にデプロイするには、次の手順に従う必要 があります。 デプロイ後、Azure Communication Services リソースの Event Grid を構成します。 デプロイされた Azure 関数の URL (関数の下の Azure portal で見つかった URL) を使用して、次のコマンドを実行します。

az eventgrid event-subscription update --name "<<EVENT_SUBSCRIPTION_NAME>>" --endpoint-type azurefunction --endpoint "<<AZ FUNCTION URL>> " --source-resource-id "<<RESOURCE_ID>>"

ローカル テスト用に作成したイベント サブスクリプションを更新するため、以前に使用したのと同じイベント サブスクリプション名を使用してください。

テストするには、Azure Communication Services リソースで設定した電話番号に SMS を送信します。

Logic Apps と Power Automate は、Event Grid を介して Azure Communication Services によって生成されたイベントを処理するのに役立つ、すぐに使用できるコネクタを提供します。 Logic Apps と Power Automate の両方で、同じコネクタ セットが提供されます。 あなたの好みで決めてください。決定の参考にするために、サービス間の違いについてお読みください。

Event Grid コネクタを使用したイベントの処理

1. まず、希望する環境に新しいフローを作成します。 開始するには、 When a resource event occurs トリガーを選択します。

   

2. これで、コネクタを構成できます。 使用するサブスクリプションを指定する必要があります。 (Azure Communication Services リソースがあるのと同じサブスクリプションである必要があります)。 リソースの種類を指定します。 この場合は、[ Microsoft.Communication.CommunicationServices] を選択します。 次に、接続する Azure Communication Services リソースのリソース名を指定する必要があります。 最後に、受信するイベントの種類 (この場合は Microsoft.Communication.SMSReceived) を選択する必要があります。

   

   コネクタは、ユーザーに代わってイベント サブスクリプションを自動的に設定し、受信するイベントを構成します。

3. 後で簡単に作業できるように、Event Grid コネクタからの応答を処理する Parse JSON connector を追加します。 Event Grid コネクタから Body オブジェクトを取得し、イベントに対して想定されるスキーマに一致するようにコネクタを構成します。

   サンプル スキーマ (開いて表示)

   
       {
           "properties": {
               "data": {
                   "properties": {
                       "From": {
                           "type": "string"
                       },
                       "Message": {
                           "type": "string"
                       },
                       "MessageId": {
                           "type": "string"
                       },
                       "ReceivedTimestamp": {
                           "type": "string"
                       },
                       "To": {
                           "type": "string"
                       }
                   },
                   "type": "object"
               },
               "dataVersion": {
                   "type": "string"
               },
               "eventTime": {
                   "type": "string"
               },
               "eventType": {
                   "type": "string"
               },
               "id": {
                   "type": "string"
               },
               "metadataVersion": {
                   "type": "string"
               },
               "subject": {
                   "type": "string"
               },
               "topic": {
                   "type": "string"
               }
           },
           "type": "object"
       }
   
   

   

この時点で、SMS イベントは正常に処理されました。 イベントのログ記録から SMS への応答まで、さまざまな方法で対処できます。 このドキュメントのコンテキストでは、受信した SMS メッセージに応答します。

SMS への応答

1. まず、フローに SMS コネクタを追加し、Azure Communication Services リソースの情報を使用して構成します。 これにより、コネクタはリソースにアクセスし、代わりに SMS を送信できます。 あなたのリソースにconnection stringが必要です。

   

2. 次に、送信者と受信者の情報を使用してコネクタを構成します。 受信したイベントの情報を使用してそれらを埋めます。 sms を元の送信者に送り返すには、 to と from 番号を FIP します。 最後に、メッセージを追加します。

   

これで、フローを保存し、Azure Communication Services リソースに関連付けられている電話番号に SMS を送信してテストできます。 テキスト メッセージが返されます。

ここからは、可能性は無限大です。 事前に書き込まれた回答でメッセージに応答したり、ボットを追加したり、応答を格納したり、ワークフロー自動化を追加したりできます。