Azure Communication Services - E-mailgebeurtenissen

Artikel
01/22/2025

Dit artikel bevat de eigenschappen en het schema voor e-mail gebeurtenissen van communication services. Zie het Gebeurtenisschema van Azure Event Grid voor een inleiding tot gebeurtenisschema's.

Gebeurtenistypen

Azure Communication Services verzendt de volgende gebeurtenistypen telefonie en Short Message Service (SMS):

Gebeurtenistype	Beschrijving
Microsoft.Communication.EmailDeliveryReportReceived	Gepubliceerd wanneer een bezorgingsrapport wordt ontvangen voor een e-mail die door de Communication Service wordt verzonden.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Gepubliceerd wanneer het verzonden e-mailbericht wordt geopend of de koppeling, indien van toepassing, wordt erop geklikt.

Reacties op gebeurtenissen

Wanneer een gebeurtenis wordt geactiveerd, verzendt de Event Grid-service gegevens over die gebeurtenis om eindpunten te abonneren.

Deze sectie bevat een voorbeeld van hoe de gegevens voor elke gebeurtenis eruitzien.

Microsoft.Communication.EmailDeliveryReportReceived-gebeurtenis

[{
  "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"
}]

Notitie

Mogelijke waarden zijn Status :

Delivered: Het bericht is overgedragen aan de beoogde bestemming (ontvanger Mail Transfer Agent).
Suppressed: De e-mail van de geadresseerde was eerder niet bezorgd en alle volgende e-mailberichten aan deze geadresseerde worden tijdelijk onderdrukt als gevolg hiervan.
Bounced: De e-mail is niet bezorgd, wat kan gebeuren omdat het e-mailadres niet bestaat of het domein ongeldig is.
Quarantined: Het bericht is in quarantaine geplaatst (als spam, bulkmail of phishing).
FilteredSpam: Het bericht is geïdentificeerd als spam en is geweigerd of geblokkeerd (niet in quarantaine geplaatst).
Expanded: Een ontvanger van een distributiegroep is uitgebreid voordat de afzonderlijke leden van de groep worden bezorgd.
Failed: Het bericht is niet bezorgd.

Microsoft.Communication.EmailEngagementTrackingReportReceived-gebeurtenis

[{
  "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"
}]

Notitie

Mogelijke waarden voor engagementType zijn View en Click. Wanneer dit engagementType het is Click, engagementContext is de koppeling in het verzonden e-mailbericht waarop is geklikt.

Zelfstudie

Voor een zelfstudie die laat zien hoe u zich kunt abonneren op e-mail gebeurtenissen met webhook, raadpleegt u Quickstart: E-mail gebeurtenissen verwerken.

Delen via