Azure Communication Services — zdarzenia poczty e-mail

Ten artykuł zawiera właściwości i schemat zdarzeń poczty e-mail usług komunikacyjnych. Aby zapoznać się ze schematami zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid.

Typy zdarzeń

Usługi Azure Communication Services emitują następujące typy zdarzeń telefonii i short Message Service (SMS):

Typ zdarzenia	opis
Microsoft.Communication.EmailDeliveryReportReceived	Opublikowany po odebraniu raportu dostawy dla wiadomości e-mail wysłanej przez usługę komunikacji.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Opublikowane po otwarciu wiadomości e-mail 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ład tego, jak te dane będą wyglądać 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: Wiadomość e-mail adresata została wcześniej odbita, a wszystkie kolejne wiadomości e-mail do tego adresata są tymczasowo pomijane w wyniku.
• Bounced: Wiadomość e-mail została odbita, co może 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 Clickma wartość , engagementContext to link w wysłanej wiadomości e-mail, która została kliknięta.

Samouczek

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