Службы коммуникации Azure — события электронной почты

Статья
01/22/2025

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

Типы событий

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

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

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

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

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

Событие 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 ссылка в сообщении электронной почты, которую щелкнули.

Учебник

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

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