Azure Communication Services — zdarzenia Email

Ten artykuł zawiera właściwości i schemat zdarzeń poczty e-mail usług komunikacyjnych. Aby zapoznać się z wprowadzeniem do schematów zdarzeń, zobacz Azure Event Grid schemat zdarzeń.

Typy zdarzeń

Azure Communication Services emituje następujące typy zdarzeń telefonii i wiadomości SMS:

Typ zdarzenia	Opis
Microsoft.Communication.EmailDeliveryReportReceived	Opublikowany po odebraniu raportu dostawy dla Email wysyłanego przez usługę komunikacji.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Opublikowany po otwarciu Email lub kliknięciu linku, jeśli ma to zastosowanie.

Odpowiedzi na zdarzenia

Po wyzwoleniu zdarzenia usługa Event Grid wysyła dane dotyczące tego zdarzenia do subskrybowania punktów końcowych.

Ta sekcja zawiera przykładowy wygląd tych danych dla każdego zdarzenia.

Zdarzenie 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"
}]

Uwaga

Możliwe wartości Status to:

• Delivered: Wiadomość została pomyślnie przekazana do zamierzonego miejsca docelowego (agenta transferu poczty adresata).
• Suppressed: Adres e-mail odbiorcy został wcześniej odbity, a wszystkie kolejne wiadomości e-mail do tego adresata są tymczasowo pomijane w wyniku.
• Bounced: Ciężko odbiła się wiadomość e-mail, co mogło się zdarzyć, ponieważ adres e-mail nie istnieje lub domena jest nieprawidłowa.
• Quarantined: Wiadomość została poddana kwarantannie (jako spam, poczta zbiorcza lub wyłudzanie informacji).
• FilteredSpam: Wiadomość została zidentyfikowana jako spam i została odrzucona lub zablokowana (nie została poddana kwarantannie).
• Expanded: Odbiorca grupy dystrybucyjnej został rozszerzony przed dostarczeniem do poszczególnych członków grupy.
• Failed: Komunikat nie został dostarczony.

Microsoft.Communication.EmailEngagementTrackingReportReceived — zdarzenie

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

Uwaga

Możliwe wartości engagementType to View i Click. Gdy parametr engagementType ma Clickwartość , engagementContext to link w Email wysłany, który został kliknięty.

Samouczek

Aby zapoznać się z samouczkiem pokazującym, jak subskrybować zdarzenia poczty e-mail przy użyciu elementów webhook, zobacz Szybki start: obsługa zdarzeń poczty e-mail.