Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
- 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 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:
- Öffnen Sie das Azure-Portal.
- Wählen Sie im linken Menü Abonnements aus.
- Wählen Sie das Abonnement aus, das Sie für Event Grid verwenden.
- Wählen Sie im linken Menü unter Einstellungen die Option Ressourcenanbieter aus.
- Suchen Sie nach Microsoft.EventGrid.
- 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.
Wechseln Sie im Portal zu der von Ihnen erstellten Communication Services-Ressource.
Wählen Sie in der Communication Services-Ressource im linken Menü der Seite Communication ServicesEreignisse aus.
Wählen Sie Ereignisabonnement hinzufügen aus.
Geben Sie auf der Seite Ereignisabonnement erstellen einen Namen für das Ereignisabonnement ein.
Wählen Sie unter Ereignistypen die Ereignisse aus, die Sie abonnieren möchten. Für SMS können Sie und auswählen
SMS Received
SMS Delivery Report Received
.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.
Wählen Sie als Endpunkttyp die Option Webhook aus.
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
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 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 dieDelivery Report
Option der gesendeten SMS aktivieren. Versuchen Sie, eine Nachricht an Ihr eingeschaltetes TelefonDelivery 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 Received
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.