Azure Communication Services – Email händelser

Artikel
07/21/2023

Den här artikeln innehåller egenskaper och schema för e-posthändelser för kommunikationstjänster. En introduktion till händelsescheman finns i Azure Event Grid händelseschema.

Händelsetyper

Azure Communication Services genererar följande typer av telefoni- och SMS-händelser:

Händelsetyp	Beskrivning
Microsoft.Communication.EmailDeliveryReportReceived	Publiceras när en leveransrapport tas emot för en Email som skickas av kommunikationstjänsten.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Publiceras när Email skickas antingen öppnas eller länken, om tillämpligt klickas.

Händelsesvar

När en händelse utlöses skickar Event Grid-tjänsten data om händelsen till prenumererande slutpunkter.

Det här avsnittet innehåller ett exempel på hur dessa data skulle se ut för varje händelse.

Microsoft.Communication.EmailDeliveryReportReceived-händelse

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

Anteckning

Möjliga värden för Status är:

Delivered: Meddelandet har överlämnats till det avsedda målet (mottagarens e-postöverföringsagent).
Suppressed: Mottagarens e-post hade studsat hårt tidigare, och alla efterföljande e-postmeddelanden till den här mottagaren ignoreras tillfälligt som ett resultat.
Bounced: E-postmeddelandet studsade hårt, vilket kan ha inträffat eftersom e-postadressen inte finns eller domänen är ogiltig.
Quarantined: Meddelandet sattes i karantän (som skräppost, massutskick eller nätfiske).
FilteredSpam: Meddelandet identifierades som skräppost och avvisades eller blockerades (inte i karantän).
Expanded: En distributionsgruppsmottagare utökades innan den levererades till de enskilda medlemmarna i gruppen.
Failed: Meddelandet levererades inte.

Microsoft.Communication.EmailEngagementTrackingReportReceived-händelse

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

Anteckning

Möjliga värden för engagementType är View och Click. engagementType När är ClickengagementContext , är länken i Email som har skickats som klickades.

Självstudie

En självstudiekurs som visar hur du prenumererar på e-posthändelser med hjälp av webbkrokar finns i Snabbstart: Hantera e-posthändelser.

Share via