Empfangen einer SMS-Nachricht

Event Grid bietet Standardunterstützung für Azure Functions, die eine einfache Einrichtung eines Ereignis-Listeners ermöglicht, ohne dass es notwendig ist, sich mit der Komplexität des Analysierens von Headern oder dem Debuggen von Webhooks zu befassen. Mithilfe des Out-of-Box-Triggers können wir eine Azure-Funktion einrichten, die jedes Mal ausgeführt wird, wenn ein Ereignis erkannt wird, das dem Trigger entspricht. In diesem Dokument konzentrieren wir uns auf empfangene SMS-Trigger.

Einrichten unserer lokalen Umgebung

1. Installieren Sie die Azure Functions-Erweiterung mit Visual Studio Code.

2. Erstellen Sie mit der Erweiterung eine Azure-Funktion, die diesen Anweisungen folgt.

   Konfigurieren Sie die Funktion mit den folgenden Anweisungen:

   • Sprache: TypeScript
   • Vorlage: Azure Event Grid Trigger
   • Funktionsname: Benutzerdefiniert

   Nach der Erstellung sehen Sie eine Funktion, die in Ihrem Verzeichnis wie folgt erstellt wurde:

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

Konfigurieren der Azure-Funktion zum Empfangen eines SMS-Ereignisses

1. Konfigurieren Sie Azure Function so, dass Werte aus dem Ereignis analysiert werden, z. B. wer es gesendet hat, an welche Zahl und welche Nachricht es sich handelt.

   
   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;
   
   

An diesem Punkt haben Sie den Empfang einer SMS über Ereignisse erfolgreich behandelt. Jetzt reichen die Möglichkeiten, was mit diesem Ereignis zu tun ist, von der Protokollierung bis hin zur Reaktion darauf. Im nächsten Abschnitt konzentrieren wir uns auf die Reaktion auf die empfangene SMS. Wenn Sie nicht auf die SMS antworten möchten, fahren Sie mit dem nächsten Abschnitt fort, um die Funktion lokal auszuführen.

Antworten auf die SMS

1. Um auf die eingehende SMS zu reagieren, verwenden wir die Azure Communication Service SMS-Funktionen zum Senden von SMS. Wir beginnen mit dem Aufrufen des SmsClient und der Initialisierung mit dem connection string für unsere Ressource. Sie können die Verbindungszeichenfolge entweder direkt in den Code einfügen oder sie in Ihrer local.settings.json Datei in Ihrem Azure Function-Verzeichnis unter Werten platzieren.

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

2. Anschließend verfassen wir eine SMS, die basierend auf den Werten von to und from des von uns erhaltenen Ereignisses gesendet werden soll.

   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;
   

Von hier aus sind die Möglichkeiten endlos. Sie können mit einer vordefinierten Antwort auf eine Nachricht antworten, einen Bot hinzufügen oder Antworten speichern, indem Sie den Code im letzten Schritt anpassen.

Lokal ausführen

Um die Funktion lokal auszuführen, drücken Sie F5 in Visual Studio Code. Wir verwenden ngrok , um unsere lokal ausgeführte Azure-Funktion mit Azure Event Grid zu verbinden.

1. Sobald die Funktion ausgeführt wird, konfigurieren Sie ngrok. Sie müssen ngrok für Ihre Umgebung herunterladen.

   ngrok http 7071
   

   Kopieren Sie den bereitgestellten ngrok Link dort, wo Ihre Funktion läuft.

2. Konfigurieren Sie SMS-Ereignisse über das Ereignisraster in Ihrer Azure Communication Services-Ressource. Dazu verwenden wir die Azure CLI. Sie benötigen die Ressourcen-ID für Ihre Azure Communication Services-Ressource im Azure-Portal. Die Ressourcen-ID sieht folgendermaßen aus: /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. Nachdem nun alles eingebunden ist, testen Sie den Fluss, indem Sie eine SMS an die Telefonnummer in Ihrer Azure Communication Services-Ressource senden. Sie sollten die Konsolenprotokolle auf Ihrem Terminal sehen, in denen die Funktion ausgeführt wird. Wenn Sie den Code hinzugefügt haben, um auf die SMS zu antworten, sollten Sie sehen, dass die SMS zurück an Sie gesendet wurde.

Bereitstellen in Azure

Um die Azure-Funktion in Azure bereitzustellen, müssen Sie diese Anweisungen befolgen. Nach der Bereitstellung konfigurieren wir das Ereignisraster für die Azure Communication Services-Ressource. Mit der URL für die bereitgestellte Azure-Funktion (URL im Azure-Portal unter der Funktion) führen wir den folgenden Befehl aus:

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

Da wir das Ereignisabonnement aktualisieren, das wir für lokale Tests erstellt haben, stellen Sie sicher, dass Sie denselben Namen des Ereignisabonnements verwenden, den Sie zuvor verwendet haben.

Sie können testen, indem Sie eine SMS an die Telefonnummer senden, die Sie in Ihrer Azure Communication Services-Ressource eingerichtet haben.

Logic Apps und Power Automate bieten vorgefertigte Konnektoren, um bei der Verwaltung von durch Azure Communication Services über das Event Grid bereitgestellten Ereignissen zu helfen. Sowohl Logik-Apps als auch Power Automate bieten den gleichen Satz von Connectors. Es liegt an Ihnen, zu entscheiden, was Sie bevorzugen, lesen Sie die Unterschiede zwischen den Diensten , um Ihre Entscheidung zu informieren.

Verarbeiten von Ereignissen mit dem Event Grid-Connector

1. Erstellen Sie zunächst einen neuen Fluss in Ihrer bevorzugten Umgebung. Wählen Sie den When a resource event occurs Auslöser aus, um zu beginnen.

   

2. Jetzt können Sie den Connector konfigurieren. Sie müssen ein Abonnement bereitstellen, das Sie verwenden möchten. (Sollte dasselbe Abonnement sein, in dem Ihre Azure Communication Services-Ressource vorhanden ist). Geben Sie den Ressourcentyp an. Wählen Sie in diesem Fall die Option Microsoft.Communication.CommunicationServices. Anschließend müssen Sie einen Ressourcennamen für die Azure Communication Services-Ressource angeben, mit der eine Verbindung hergestellt werden soll. Schließlich müssen wir die Ereignistypen auswählen, die wir empfangen möchten, in diesem Fall: Microsoft.Communication.SMSReceived.

   

   Der Connector richtet das Ereignisabonnement automatisch in Ihrem Auftrag ein und konfiguriert die Ereignisse, die er empfangen möchte.

3. Um unser Leben später zu vereinfachen, fügen Sie ein Parse JSON connector hinzu, um Antworten vom Event Grid-Connector zu verarbeiten. Konfigurieren Sie den Connector so, dass er das Body Objekt aus dem Event Grid Connector verwendet und es mit dem erwarteten Schema für das Ereignis abgleicht.

   Beispielschema (zu sehen)

   
       {
           "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"
       }
   
   

   

An dieser Stelle haben Sie das SMS-Ereignis erfolgreich verarbeitet. Sie haben mehrere Möglichkeiten, was Sie damit machen können, von der Protokollierung des Ereignisses bis zur Reaktion auf die SMS. Im Kontext dieses Dokuments antworten wir auf die empfangene SMS-Nachricht.

Antworten auf die SMS

1. Fügen Sie zunächst den SMS-Connector zu unserem Fluss hinzu, und konfigurieren Sie ihn mit den Informationen für unsere Azure Communication Services-Ressource. Er ermöglicht es dem Connector, auf die Ressource zuzugreifen und die SMS in unserem Auftrag zu senden. Sie benötigen das connection string für Ihre Ressource.

   

2. Als Nächstes konfigurieren wir den Connector mit den Informationen für den Absender und empfänger. Wir verwenden die Informationen aus dem Ereignis, das wir erhalten haben, um sie aufzufüllen. Drehen Sie die Nummern für to und from um, um eine SMS zurück an den ursprünglichen Absender zu senden. Fügen Sie schließlich eine Nachricht hinzu.

   

Jetzt können Sie den Fluss speichern und testen, indem Sie eine SMS an die Telefonnummer senden, die Ihrer Azure Communication Services-Ressource zugeordnet ist. Sie sollten eine SMS zurückerhalten.

Von hier aus sind die Möglichkeiten endlos. Sie können mit einer vordefinierten Antwort auf eine Nachricht antworten, einen Bot hinzufügen, die Antwort speichern oder Eine Workflowautomatisierung hinzufügen.