Службы коммуникации Azure — события Email

Статья
07/21/2023

В этой статье приведены свойства и схема для событий электронной почты служб коммуникации. Общие сведения о схемах событий см. в статье Схема событий службы "Сетка событий Azure".

Типы событий

Службы коммуникации Azure создают события телефонии и SMS следующих типов:

Тип события	Описание
Microsoft.Communication.EmailDeliveryReportReceived	Публикуется при получении отчета о доставке для Email, отправляемого Службой коммуникации.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Публикуется при открытии отправленного Email или нажатии ссылки, если применимо.

Ответы на события

При активации события служба Сетки событий отправляет данные о нем на подписанные конечные точки.

В этом разделе приведен пример того, как будут выглядеть данные для каждого события.

Событие 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"
}]

Примечание

Возможные значения параметра Status:

Delivered: сообщение было успешно передано в целевое место назначения (агент передачи почты получателя).
Suppressed: сообщение электронной почты получателя ранее было трудно отскочить, и все последующие сообщения электронной почты этому получателю временно подавляются в результате.
Bounced: сообщение электронной почты жестко отскочило, что могло произойти из-за того, что адрес электронной почты не существует или домен недопустим.
Quarantined: сообщение помещено в карантин (как спам, массовая почта или фишинг).
FilteredSpam: сообщение было идентифицировано как спам и было отклонено или заблокировано (не помещено в карантин).
Expanded: получатель группы рассылки был расширен перед доставкой отдельным участникам группы.
Failed: сообщение не доставлено.

Событие 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"
}]

Примечание

Возможные значения для engagementType: View и Click. engagementType Если имеет значение Click, engagementContext — это ссылка в отправленном Email, которую щелкнули.

Учебник

Руководство, в которое показано, как подписаться на события электронной почты с помощью веб-перехватчиков, см. в статье Краткое руководство. Обработка событий электронной почты.

Поделиться через