Servizi di comunicazione di Azure - Eventi di posta elettronica

Articolo
01/22/2025

Questo articolo fornisce le proprietà e lo schema per gli eventi di posta elettronica dei servizi di comunicazione. Per un'introduzione agli schemi di eventi, vedere Schema di eventi di Griglia di eventi di Azure.

Tipi di evento

Servizi di comunicazione di Azure genera i tipi di evento SMS (Short Message Service) e di telefonia seguenti:

Tipo di evento	Descrizione
Microsoft.Communication.EmailDeliveryReportReceived	Pubblicato quando viene ricevuto un report di recapito per un messaggio di posta elettronica inviato dal servizio di comunicazione.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Pubblicato all'apertura del messaggio di posta elettronica o al collegamento, se applicabile.

Risposte di eventi

Quando viene attivato un evento, il servizio Griglia di eventi invia i dati relativi all'evento agli 'endpoint di sottoscrizione.

Questa sezione contiene un esempio che illustra l'aspetto dei dati per ogni evento.

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

Nota

I valori possibili per Status sono:

Delivered: il messaggio è stato trasferito correttamente alla destinazione desiderata (destinatario Mail Transfer Agent).
Suppressed: il messaggio di posta elettronica del destinatario è stato interrotto in precedenza e tutti i messaggi di posta elettronica successivi a questo destinatario vengono temporaneamente eliminati di conseguenza.
Bounced: il messaggio di posta elettronica viene inviato in modo predefinito, che può verificarsi perché l'indirizzo di posta elettronica non esiste o il dominio non è valido.
Quarantined: il messaggio è stato messo in quarantena (come posta indesiderata, posta in blocco o phishing).
FilteredSpam: il messaggio è stato identificato come posta indesiderata ed è stato rifiutato o bloccato (non messo in quarantena).
Expanded: un destinatario del gruppo di distribuzione è stato espanso prima del recapito ai singoli membri del gruppo.
Failed: il messaggio non è stato recapitato.

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

Nota

I valori possibili per engagementType sono View e Click. engagementType Quando è Click, engagementContext è il collegamento nel messaggio di posta elettronica inviato su cui è stato fatto clic.

Esercitazione

Per un'esercitazione che illustra come sottoscrivere eventi di posta elettronica tramite web hook, vedere Guida introduttiva: Gestire gli eventi di posta elettronica.

Condividi tramite