Ereignisbehandlung in Azure Communication Services

Azure Communication Services ist in Azure Event Grid integriert, um zuverlässig, skalierbar und sicher Ereignisbenachrichtigungen in Echtzeit bereitzustellen. In diesem Artikel erfahren Sie, wie Sie Ihre Anwendungen so konfigurieren, dass sie auf Communication Services-Ereignisse lauschen. So können Sie beispielsweise eine Datenbank aktualisieren, eine Arbeitsaufgabe erstellen und eine Pushbenachrichtigung senden, wenn eine SMS-Nachricht von einer Telefonnummer eingeht, die Ihrer Communication Services-Ressource zugeordnet ist.

Azure Event Grid ist ein vollständig verwalteter Ereignisroutingdienst, der ein Veröffentlichen-Abonnieren-Modell verwendet. Event Grid verfügt über eine integrierte Unterstützung für Azure-Dienste wie Azure Functions und Azure Logic Apps. Mithilfe von Webhooks können Ereigniswarnungen an Azure-fremde Dienste übertragen werden. Eine vollständige Liste der Ereignishandler, die Event Grid unterstützt, finden Sie unter Einführung in Azure Event Grid.

Hinweis

Weitere Informationen zur Datenresidenz in Bezug auf die Ereignisbehandlung finden Sie in der konzeptionellen Dokumentation zu Datenresidenz.

Ereignistypen

Event Grid verwendet Ereignisabonnements zum Weiterleiten von Ereignisnachrichten an Abonnenten.

Von Azure Communication Services werden folgende Ereignistypen ausgegeben:

• Chatereignisse
• Ereignisse für Telefonie und SMS
• Ereignisse für Sprach- und Videoanrufe
• Präsenzereignisse
• E-Mail-Ereignisse
• Auftragsrouterereignisse
• Ereignisse für erweitertes Messaging

Sie können das Azure-Portal oder die Azure CLI verwenden, um Ereignisse zu abonnieren, die von Ihrer Communication Services-Ressource ausgegeben werden.

Ereignisbetreff

Das Feld subject gibt bei allen Communication Services-Ereignissen Aufschluss über den Benutzer, die Telefonnummer oder die Entität, an den bzw. an die sich das Ereignis richtet. Zur einfachen Event Grid-Filterung werden gängige Präfixe verwendet.

Betreffpräfix	Communication Services-Entität
phonenumber/	PSTN-Telefonnummer
user/	Communication Services-Benutzer
thread/	Chatthread

Das folgende Beispiel zeigt einen Filter für alle SMS-Nachrichten und Zustellberichte, die an alle zu einer Communication Services-Ressource gehörenden Telefonnummern mit der Vorwahl „555“ gesendet werden:

"filter": {
  "includedEventTypes": [
    "Microsoft.Communication.SMSReceived",
    "Microsoft.Communication.SMSDeliveryReportReceived"
  ],
  "subjectBeginsWith": "phonenumber/1555",
}

Nächste Schritte

• Eine Einführung zu Azure Event Grid finden Sie unter Einführung in Azure Event Grid.
• Eine Einführung in Azure Event Grid-Konzepte finden Sie hier.
• Eine Einführung in Azure Event Grid-Systemthemen finden Sie hier.