Schnellstart: Behandeln von SMS- und Übermittlungsberichtereignissen

  • Artikel

Machen Sie Ihre ersten Schritte mit Azure Communication Services, indem Sie Azure Event Grid zum Behandeln von SMS-Ereignissen von Communication Services verwenden. Nachdem Sie SMS-Ereignisse wie eingehende Nachrichten und Übermittlungsberichte abonniert haben, generieren und empfangen Sie diese Ereignisse. Im Rahmen dieser Schnellstartanleitung fallen in Ihrem Azure-Konto ggf. geringfügige Kosten im Centbereich an.

Wichtig

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 Service-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 senden wir Ereignisse an eine Web-App, die die Nachrichten sammelt und anzeigt.

Einrichten der Umgebung

Führen Sie zum Einrichten der Umgebung, die wir zum Generieren und Empfangen von Ereignissen verwenden, die Schritte in den folgenden Abschnitten aus.

Registrieren eines Event Grid-Ressourcenanbieters

Wenn Sie Event Grid in Ihrem Azure-Abonnement noch nicht verwendet haben, müssen Sie möglicherweise den 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

In diesem Schnellstart verwenden wir einen Event Grid-Viewer, 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: Seite „Ereignisse“ einer Azure Communication Services-Ressource. Die Schaltfläche „Ereignisabonnement“ ist 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 SMS Received und SMS Delivery Report Received auswählen.

  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: Dialogfeld „Ereignisabonnement erstellen“. Unter „Ereignistypen“ sind „Empfangene SMS“ und „Empfangene SMS-Zustellberichte“ ausgewählt.

  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.

    In diesem Fall verwenden wir die URL des Event Grid Viewers, den wir zuvor im Schnellstart 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: Dialogfeld „Webhook auswählen“. Das Feld „Abonnentendpunkt“ enthält eine URL, und die Schaltfläche „Auswahl bestätigen“ wird sichtbar.

Anzeigen von SMS-Ereignissen

Zum Generieren und Empfangen von SMS-Ereignissen führen Sie die Schritte in den folgenden Abschnitten aus.

Auslösen von SMS-Ereignissen

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

  • SMS Received-Ereignisse (SMS empfangen) 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 (SMS-Zustellbericht empfangen) werden generiert, wenn Sie mit einer Communication Services-Nummer eine SMS an einen Benutzer senden. Zum Auslösen eines Ereignisses müssen Sie die Delivery Report-Option der von Ihnen gesendeten SMS aktivieren. Versuchen Sie, eine Nachricht an Ihr Mobiltelefon mit aktiviertem Delivery Report zu senden. Für diese Aktion fallen in Ihrem Azure-Konto ggf. geringfügige Kosten im Centbereich 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, werden Sie feststellen, dass SMS Received- und SMS 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. Wählen Sie das Augensymbol neben dem Ereignis aus, um die gesamten Nutzdaten anzuzeigen. Ereignisse sollten in etwa wie die folgenden Daten aussehen:

Screenshot: Azure Event Grid-Viewer, der das Event Grid-Schema für ein Ereignis für empfangene SMS anzeigt

Screenshot: Azure Event Grid-Viewer, der das Event Grid-Schema für ein Ereignis für SMS-Zustellberichte 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. Weitere Informationen zum Bereinigen von Ressourcen finden Sie hier.

Nächste Schritte

In diesem Schnellstart haben Sie gelernt, SMS-Ereignisse zu verwenden. Sie können SMS-Nachrichten empfangen, indem Sie ein Event Grid-Abonnement erstellen.

Senden einer SMS

Weitere Möglichkeiten: