Azure Communication Services - peristiwa Email

Artikel
07/21/2023

Artikel ini menyediakan properti dan skema untuk peristiwa email layanan komunikasi. Untuk pengenalan skema kejadian, lihat skema kejadian Azure Event Grid.

Jenis peristiwa

Azure Communication Services mengeluarkan jenis peristiwa telepon dan SMS berikut ini:

Jenis peristiwa	Deskripsi
Microsoft.Communication.EmailDeliveryReportReceived	Diterbitkan saat laporan pengiriman diterima untuk Email yang dikirim oleh Communication Service.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Diterbitkan saat Email dikirim dibuka atau tautan, jika berlaku diklik.

Tanggapan peristiwa

Ketika suatu peristiwa dipicu, layanan Event Grid akan mengirim data tentang peristiwa itu ke titik akhir.

Bagian ini berisi contoh tampilan data tersebut untuk setiap peristiwa.

Peristiwa 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"
}]

Catatan

Nilai yang mungkin untuk Status adalah:

Delivered: Pesan berhasil diserahkan ke tujuan yang dimaksudkan (Agen Transfer Email penerima).
Suppressed: Email penerima telah dipantulkan sebelumnya, dan semua email berikutnya ke penerima ini ditekan sementara sebagai hasilnya.
Bounced: Email di-bounced secara permanen, yang mungkin telah terjadi karena alamat email tidak ada atau domain tidak valid.
Quarantined: Pesan dikarantina (sebagai spam, email massal, atau phishing).
FilteredSpam: Pesan diidentifikasi sebagai spam, dan ditolak atau diblokir (tidak dikarantina).
Expanded: Penerima grup distribusi diperluas sebelum pengiriman ke masing-masing anggota grup.
Failed: Pesan tidak terkirim.

Peristiwa 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"
}]

Catatan

Nilai yang mungkin untuk engagementType adalah View dan Click. engagementType Ketika adalah Click, engagementContext adalah tautan dalam Email dikirim yang diklik.

Tutorial

Untuk tutorial yang menunjukkan cara berlangganan peristiwa email menggunakan webhook, lihat Mulai Cepat: Menangani peristiwa email.

Bagikan melalui