SMS-Ereignisse bearbeiten

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.

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

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.
• Eine Communication Services-Ressource. Ausführliche Informationen hierzu finden Sie unter Erstellen einer Azure Communication Services-Ressource.
• Eine für SMS-Nachrichten geeignete Telefonnummer. Erhalte eine Telefonnummer.

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 in Ihrem Azure-Abonnement nicht Event Grid, 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.

   

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.

   

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

   

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 dem Event Grid Viewer, den 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.

   

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 (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 die 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, sehen Sie, 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. Um die gesamte Nutzlast anzuzeigen, wählen Sie das Augensymbol neben dem Ereignis aus. Ereignisse sollten in etwa wie die folgenden Daten aussehen:

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

Verwandte Artikel

• Weitere Informationen zu Ereignisbehandlungskonzepten
• Weitere Informationen zu Azure Event Grid