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는 전송된 메일의 클릭한 링크입니다.
자습서
웹후크를 사용하여 이메일 이벤트를 구독하는 방법을 보여 주는 자습서는 빠른 시작: 이메일 이벤트 처리를 참조하세요.