Freigeben über


SMS-Ereignisse bearbeiten

Beginnen Sie mit Azure Communication Services, indem Sie Azure Event Grid verwenden, um Communication Services-SMS-Ereignisse zu verarbeiten. Nachdem Sie SMS-Ereignisse wie eingehende Nachrichten und Zustellungsberichte abonniert haben, generieren und empfangen Sie diese Ereignisse.

Um die Anleitungen in diesem Artikel zu befolgen, fallen in Ihrem Azure-Konto geringfügige Kosten von höchstens einigen wenigen Cent (USD) an.

Von Bedeutung

Die SMS- und PSTN-Funktionen hängen von Ihrer Telefonnummer und dem durch Ihre Azure-Rechnungsanschrift festgelegten Land bzw. der Region ab. Weitere Informationen finden Sie in der Dokumentation zur Abonnementberechtigung.

Voraussetzungen

Informationen zu Azure Event Grid

Event Grid ist ein cloudbasierter Ereignisdienst. In diesem Artikel erfahren Sie, wie Sie Communication Services-Ereignisse abonnieren und ein Ereignis zum Anzeigen des Ergebnisses auslösen. Üblicherweise senden Sie Ereignisse an einen Endpunkt, der die Ereignisdaten verarbeitet und entsprechende Aktionen ausführt. In diesem Artikel wird beschrieben, wie Sie die Ereignisse an eine Web-App senden, die die Nachrichten sammelt und anzeigt.

Einrichten der Umgebung

Führen Sie die folgenden Abschnitte aus, um die Umgebung zum Generieren und Empfangen von Ereignissen einzurichten.

Registrieren eines Event Grid-Ressourcenanbieters

Wenn Sie Event Grid nicht in Ihrem Azure-Abonnement verwenden, müssen Sie Ihren Event Grid-Ressourcenanbieter registrieren. Führen Sie die folgenden Schritte aus, um den Anbieter zu registrieren:

  1. Öffnen Sie das Azure-Portal.
  2. Wählen Sie im linken Menü Abonnements aus.
  3. Wählen Sie das Abonnement aus, das Sie für Event Grid verwenden.
  4. Wählen Sie im linken Menü unter Einstellungen die Option Ressourcenanbieter aus.
  5. Suchen Sie nach Microsoft.EventGrid.
  6. Wählen Sie Registrieren aus, falls Ihr Ressourcenanbieter nicht registriert ist.

Es kann einen Moment dauern, bis die Registrierung abgeschlossen ist. Wählen Sie zum Aktualisieren des Status die Option Aktualisieren aus. Wenn unter StatusRegistriert angezeigt wird, sind Sie bereit, fortzufahren.

Bereitstellen des Event Grid-Viewers

Verwenden Sie in diesem Beispiel eine Event Grid-Anzeige, um Ereignisse nahezu in Echtzeit anzuzeigen. Durch den Viewer erhält der Benutzer das Erlebnis eines Echtzeitfeeds. Außerdem müssen die Nutzdaten jedes Ereignisses auch zur Überprüfung verfügbar sein.

Zum Einrichten des Viewers führen Sie die Schritte in Azure Event Grid Viewer aus.

Abonnieren von SMS-Ereignissen mithilfe von Webhooks

Sie können bestimmte Ereignisse abonnieren, um für Event Grid Informationen bereitzustellen, wohin die Ereignisse gesendet werden sollen, die Sie nachverfolgen möchten.

  1. Wechseln Sie im Portal zu der von Ihnen erstellten Communication Services-Ressource.

  2. Wählen Sie in der Communication Services-Ressource im linken Menü der Seite Communication ServicesEreignisse aus.

  3. Wählen Sie Ereignisabonnement hinzufügen aus.

    Screenshot, das die Ereignisse-Seite einer Azure Communication Services-Ressource zeigt. Die Schaltfläche „Ereignisabonnement“ wird hervorgehoben.

  4. Geben Sie auf der Seite Ereignisabonnement erstellen einen Namen für das Ereignisabonnement ein.

  5. Wählen Sie unter Ereignistypen die Ereignisse aus, die Sie abonnieren möchten. Für SMS können Sie und auswählen SMS ReceivedSMS Delivery Report Received.

  6. Wenn Sie aufgefordert werden, einen Namen für das Systemthema anzugeben, können Sie eine eindeutige Zeichenfolge angeben. Dieses Feld wirkt sich nicht auf Ihre Benutzeroberflächen aus und wird für interne Telemetriezwecke verwendet.

    Screenshot, der das Dialogfeld

  7. Wählen Sie als Endpunkttyp die Option Webhook aus.

    Screenshot: Detailansicht des Dialogfelds „Ereignisabonnement erstellen“. In der Liste „Endpunkttyp“ ist „Webhook“ ausgewählt.

  8. Wählen Sie für EndpunktEndpunkt auswählen aus, und geben Sie dann die URL Ihrer Web-App ein.

    Verwenden Sie in diesem Fall die URL aus der Event Grid-Anzeige , die wir weiter oben in der Schnellstartanleitung eingerichtet haben. Die URL für das Beispiel weist dieses Format auf: https://{{site-name}}.azurewebsites.net/api/updates

  9. Klicken Sie auf Auswahl bestätigen.

    Screenshot, der das Dialogfeld

Anzeigen von SMS-Ereignissen

Führen Sie die folgenden Schritte aus, um SMS-Ereignisse zu generieren und zu empfangen.

Auslösen von SMS-Ereignissen

Zum Anzeigen von Ereignisauslösern müssen wir einige Ereignisse generieren.

  • SMS Received Ereignisse werden generiert, wenn die Communication Services-Telefonnummer eine Textnachricht empfängt. Um ein Ereignis auszulösen, senden Sie eine Nachricht von Ihrem Telefon an die Telefonnummer, die an Ihre Communication Services-Ressource angefügt ist.
  • SMS Delivery Report Received Ereignisse werden generiert, wenn Sie eine SMS an einen Benutzer senden, indem Sie eine Communication Services-Telefonnummer verwenden. Um ein Ereignis auszulösen, müssen Sie die Delivery Report Option der gesendeten SMS aktivieren. Versuchen Sie, eine Nachricht an Ihr eingeschaltetes Telefon Delivery Report zu senden. Wenn Sie diese Aktion ausführen, fallen in Ihrem Azure-Konto geringe Kosten von einigen US-Cent oder weniger an.

Sehen Sie sich die vollständige Liste der von Azure Communication Services unterstützten Ereignisse an.

Empfangen von SMS-Ereignissen

Nachdem Sie ein Ereignis generiert haben, sehen Sie, dass SMS ReceivedSMS Delivery Report Received Ereignisse an Ihren Endpunkt gesendet werden. Diese Ereignisse werden im Event Grid-Viewer angezeigt, den wir am Anfang dieses Schnellstarts eingerichtet haben. Um die gesamte Nutzlast anzuzeigen, wählen Sie das Augensymbol neben dem Ereignis aus. Ereignisse sollten in etwa wie die folgenden Daten aussehen:

Screenshot der Azure Event Grid-Anzeige, in der das Event Grid-Schema für ein empfangenes SMS-Ereignis angezeigt wird.

Screenshot des Azure Event Grid-Viewers, der das Event Grid-Schema für ein Ereignis eines SMS-Übermittlungsberichts anzeigt.

Erfahren Sie mehr über Ereignisschemas und andere Ereigniskonzepte.

Bereinigen von Ressourcen

Wenn Sie ein Communication Services-Abonnement bereinigen und entfernen möchten, können Sie die Ressource oder die Ressourcengruppe löschen. Wenn Sie die Ressourcengruppe löschen, werden auch alle anderen Ressourcen gelöscht, die ihr zugeordnet sind. Erfahren Sie mehr über das Aufräumen von Ressourcen.

Nächste Schritte