Azure Communication Services - Email gebeurtenissen

Dit artikel bevat de eigenschappen en het schema voor e-mailevenementen van Communication Services. Zie Azure Event Grid gebeurtenisschema voor een inleiding tot gebeurtenisschema's.

Gebeurtenistypen

Azure Communication Services verzendt de volgende typen telefonie- en sms-gebeurtenissen:

Gebeurtenistype	Beschrijving
Microsoft.Communication.EmailDeliveryReportReceived	Gepubliceerd wanneer een leveringsrapport wordt ontvangen voor een Email verzonden door de Communication Service.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Gepubliceerd wanneer de verzonden Email wordt geopend of op de koppeling wordt geklikt, indien van toepassing.

Gebeurtenisreacties

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 voor Status zijn:

• Delivered: het bericht is overgedragen aan de beoogde bestemming (geadresseerde Mail Transfer Agent).
• Suppressed: de e-mail van de geadresseerde is eerder niet bezorgd en als gevolg hiervan worden alle volgende e-mailberichten naar deze geadresseerde tijdelijk onderdrukt.
• Bounced: de e-mail is niet bezorgd. Dit kan zijn gebeurd omdat het e-mailadres niet bestaat of omdat 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 uitgevouwen voordat deze aan de afzonderlijke leden van de groep werd geleverd.
• 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 de engagementType is, engagementContext is Clickde koppeling in de Email verzonden waarop is geklikt.

Zelfstudie

Zie Quickstart: E-mail gebeurtenissen verwerken voor een zelfstudie waarin wordt uitgelegd hoe u zich kunt abonneren op e-mail gebeurtenissen met behulp van webhook.