Azure Communication Services – E-mailové události

Článek
01/22/2025

Tento článek obsahuje vlastnosti a schéma e-mailových událostí komunikačních služeb. Úvod do schémat událostí najdete ve schématu událostí služby Azure Event Grid.

Typy událostí

Služba Azure Communication Services generuje následující typy událostí Služby krátkých zpráv (SMS):

Typ události	Popis
Microsoft.Communication.EmailDeliveryReportReceived	Publikuje se při přijetí zprávy o doručení e-mailu odeslaného komunikační službou.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Publikuje se při otevření e-mailu nebo kliknutí na odkaz.

Odpovědi na události

Když se událost aktivuje, služba Event Grid odešle data o této události do odběru koncových bodů.

Tato část obsahuje příklad toho, jak by tato data vypadala pro každou událost.

Událost Microsoft.Communication.EmailDeliveryReportReceived

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

Poznámka:

Možné hodnoty pro Status :

Delivered: Zpráva byla úspěšně předána zamýšlenému cíli (příjemce agenta přenosu pošty).
Suppressed: E-mail příjemce se dříve pevně odrazil a všechny následné e-maily tohoto příjemce jsou dočasně potlačeny v důsledku toho.
Bounced: E-mail se pevně odrazil, což se může stát, protože e-mailová adresa neexistuje nebo je doména neplatná.
Quarantined: Zpráva byla v karanténě (jako spam, hromadná pošta nebo phishing).
FilteredSpam: Zpráva byla identifikována jako spam a byla odmítnuta nebo blokována (není v karanténě).
Expanded: Příjemce distribuční skupiny byl rozšířen před doručením jednotlivým členům skupiny.
Failed: Zpráva nebyla doručena.

Událost Microsoft.Communication.EmailEngagementTrackingReportReceived

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

Poznámka:

Možné hodnoty jsou engagementType View a Click. Pokud je ClickengagementContext , engagementType je odkaz v odeslaném e-mailu, který byl kliknut.

Kurz

Kurz, který ukazuje, jak se přihlásit k odběru e-mailových událostí pomocí webhooků, najdete v tématu Rychlý start: Zpracování e-mailových událostí.

Sdílet prostřednictvím