Azure Communication Services - 메일 이벤트

이 문서에서는 통신 서비스 이메일 이벤트에 대한 속성 및 스키마를 제공합니다. 이벤트 스키마에 대한 소개는 Azure Event Grid 이벤트 스키마를 참조하세요.

이벤트 유형

Azure Communication Services에서 내보내는 전화 통신 및 SMS 이벤트 유형은 다음과 같습니다.

이벤트 유형	설명
Microsoft.Communication.EmailDeliveryReportReceived	Communication Service에서 보낸 메일에 대해 배달 보고서를 받을 때 게시됩니다.
Microsoft.Communication.EmailEngagementTrackingReportReceived	전송된 메일이 열리거나 링크를 클릭하면(해당되는 경우) 게시됩니다.

이벤트 응답

이벤트가 트리거될 때 Event Grid 서비스는 해당 이벤트에 대한 데이터를 구독 엔드포인트로 보냅니다.

이 섹션에는 각 이벤트에 대한 데이터가 어떻게 표시되는지 예가 포함되어 있습니다.

Microsoft.Communication.EmailDeliveryReportReceived event

[{
  "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 event

[{
  "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는 전송된 메일의 클릭한 링크입니다.

자습서

웹후크를 사용하여 이메일 이벤트를 구독하는 방법을 보여 주는 자습서는 빠른 시작: 이메일 이벤트 처리를 참조하세요.