Azure Communication Services – Email události

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

Typy událostí

Azure Communication Services generuje následující typy událostí telefonie a SMS:

Typ události	Popis
Microsoft.Communication.EmailDeliveryReportReceived	Publikuje se při přijetí oznámení o doručení Email odeslané komunikační službou.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Publikuje se při otevření odeslaného Email nebo kliknutí na odkaz (pokud je to možné).

Odpovědi na události

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

Tato část obsahuje příklad toho, jak by tato data vypadala pro jednotlivé události.

Microsoft.Communication.EmailDeliveryReportReceived – událost

[{
  "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 jsou:

• Delivered: Zpráva byla úspěšně předána zamýšlenému cíli (příjemci Agent přenosu pošty).
• Suppressed: E-mail příjemce se dříve obtížně odrazil a všechny následné e-maily od tohoto příjemce jsou dočasně potlačeny.
• Bounced: E-mail se pevně odrazil, k čemuž mohlo dojít kvůli tomu, že e-mailová adresa neexistuje nebo je doména neplatná.
• Quarantined: Zpráva byla umístěna do karantény (jako spam, hromadná pošta nebo phishing).
• FilteredSpam: Zpráva byla identifikována jako spam a byla odmítnuta nebo zablokována (nebyla umístěna do karantény).
• Expanded: Příjemce distribuční skupiny byl před doručením jednotlivým členům skupiny rozšířen.
• Failed: Zpráva se nedoručila.

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 pro engagementType jsou View a Click. Pokud je engagementTypeClick, engagementContext je odkaz v Email odeslaný, na který se kliklo.

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í.