Servizi di comunicazione di Azure - eventi Email

Articolo
07/21/2023

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 eventi di telefonia e SMS seguenti:

Tipo di evento	Descrizione
Microsoft.Communication.EmailDeliveryReportReceived	Pubblicato quando viene ricevuto un report di recapito per un Email inviato dal servizio di comunicazione.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Pubblicato quando il Email inviato viene aperto o il collegamento, se applicabile viene fatto clic.

Risposte agli 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 passato alla destinazione prevista (destinatario Mail Transfer Agent).
Suppressed: il messaggio di posta elettronica del destinatario era stato interrotto in precedenza e tutti i messaggi di posta elettronica successivi a questo destinatario vengono temporaneamente eliminati come risultato.
Bounced: il messaggio di posta elettronica non esiste o il dominio non è valido.
Quarantined: il messaggio è stato messo in quarantena (come posta indesiderata, posta indesiderata o phishing).
FilteredSpam: il messaggio è stato identificato come posta indesiderata ed è stato rifiutato o bloccato (non 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 è , engagementContext è Clickil collegamento nel Email inviato che è stato fatto clic.

Esercitazione

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

Share via