Azure Communication Services – Email-Ereignisse

2025-01-21

In diesem Artikel werden die Eigenschaften und das Schema für E-Mail-Ereignisse von Communication Services beschrieben. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema.

Ereignistypen

Von Azure Communication Services werden die folgenden Ereignistypen für Telefonie und SMS (Kurznachrichten) ausgegeben:

Ereignistyp	BESCHREIBUNG
Microsoft.Communication.EmailDeliveryReportReceived	Wird veröffentlicht, wenn ein Zustellbericht für eine von der Communication Services-Instanz gesendete Email empfangen wird.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Wird veröffentlicht, wenn die gesendete Email geöffnet oder auf den Link (falls zutreffend) geklickt wird.

Ereignisantworten

Wenn ein Ereignis ausgelöst wird, sendet der Event Grid-Dienst Daten zum Ereignis an die Endpunkte, die über ein entsprechendes Abonnement verfügen.

In diesem Abschnitt wird anhand eines Beispiels gezeigt, wie diese Daten für jedes Ereignis aussehen.

Microsoft.Communication.EmailDeliveryReportReceived-Ereignis

[{
  "id": "00000000-0000-0000-0000-000000000000",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
  "subject": "sender/senderid@azure.com/message/00000000-0000-0000-0000-000000000000",
  "data": {
    "sender": "senderid@azure.com", 
    "recipient": "receiver@azure.com",
    "messageId": "00000000-0000-0000-0000-000000000000",
    "status": "Delivered",
    "deliveryStatusDetails": {
      "statusMessage": "Status Message"
    },
    "deliveryAttemptTimeStamp": "2020-09-18T00:22:20.2855749+00:00",
  },
  "eventType": "Microsoft.Communication.EmailDeliveryReportReceived",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "eventTime": "2020-09-18T00:22:20.822Z"
}]

Hinweis

Dies sind die möglichen Werte für Status:

Delivered: Die Nachricht wurde erfolgreich an das beabsichtigte Ziel (E-Mail-Transfer-Agent des Empfängers) übergeben.
Suppressed: Für die Empfänger-E-Mail erfolgte zuvor ein Hardbounce, und alle nachfolgenden E-Mails an diesen Empfänger werden daher vorübergehend unterdrückt.
Bounced: Für die E-Mail erfolgt ein Hardbounce, weil die E-Mail-Adresse möglicherweise nicht vorhanden ist oder die Domäne ungültig ist.
Quarantined: Die Nachricht wurde unter Quarantäne gestellt (als Spam, Massen-E-Mail oder Phishing).
FilteredSpam: Die Nachricht wurde als Spam identifiziert und abgelehnt oder blockiert (nicht unter Quarantäne gestellt).
Expanded: Ein Verteilergruppenempfänger wurde vor der Übermittlung an die einzelnen Mitglieder der Gruppe erweitert.
Failed: Die Nachricht wurde nicht zugestellt.

Microsoft.Communication.EmailEngagementTrackingReportReceived-Ereignis

[{
  "id": "00000000-0000-0000-0000-000000000000",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/microsoft.communication/communicationservices/{communication-services-resource-name}",
  "subject": "sender/senderid@azure.com/message/00000000-0000-0000-0000-000000000000",
  "data": {
    "sender": "senderid@azure.com", 
    "messageId": "00000000-0000-0000-0000-000000000000",
    "userActionTimeStamp": "2022-09-06T22:34:52.1303595+00:00",
    "engagementContext": "",
    "userAgent": "",
    "engagementType": "view"
  },
  "eventType": "Microsoft.Communication.EmailEngagementTrackingReportReceived",
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "eventTime": "2022-09-06T22:34:52.688Z"
}]

Hinweis

Mögliche Werte für engagementType sind View und Click. Wenn engagementTypeClick ist, ist engagementContext der Link in der gesendeten Email, auf den geklickt wurde.

Lernprogramm

Ein Tutorial zum Abonnieren von E-Mail-Ereignissen mithilfe von Web-Hooks finden Sie unter Schnellstart: Behandeln von E-Mail-Ereignissen.