Azure Communication Services - Événements d’e-mail

Article
07/24/2023

Cet article décrit les propriétés et le schéma des événements e-mail Communication Services. Pour une présentation des schémas d’événements, consultez Schéma d’événements Azure Event Grid.

Types d’événements

Azure Communication Services émet les types d’événements de téléphonie et SMS suivants :

Type d'événement	Description
Microsoft.Communication.EmailDeliveryReportReceived	Publié quand un rapport de remise est reçu pour un e-mail envoyé par le service de communication.
Microsoft.Communication.EmailEngagementTrackingReportReceived	Publié quand l’e-mail envoyé est ouvert ou que l’utilisateur clique sur le lien, le cas échéant.

Réponses aux événements

Quand un événement est déclenché, le service Event Grid envoie les données relatives à cet événement aux points de terminaison d’abonnement.

Cette section contient un exemple de ce à quoi ces données ressembleraient pour chaque événement.

Événement 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"
}]

Notes

Les valeurs possibles pour Status sont :

Delivered : Le message a bien été remis à la destination prévue (agent de transfert de courrier du destinataire).
Suppressed : L’e-mail du destinataire avait auparavant fait l’objet d’un rebond dur, ce qui s’est traduit par la suppression temporaire de tous les e-mails suivants à ce destinataire.
Bounced : L’e-mail a fait l’objet d’un rebond dur, ce qui s’est peut-être produit en raison de l’inexistence de l’adresse e-mail ou de l’invalidité du domaine.
Quarantined : Le message a été mis en quarantaine (en tant que courrier indésirable, courrier envoyé en nombre ou hameçonnage).
FilteredSpam : Le message a été identifié comme étant du courrier indésirable et a été rejeté ou bloqué (non mis en quarantaine).
Expanded : Un destinataire du groupe de distribution a été étendu avant la remise aux membres individuels du groupe.
Failed : Le message n’a pas été remis.

Événement 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"
}]

Notes

Les valeurs possibles pour engagementType sont View et Click. Quand engagementType a pour valeur Click, engagementContext est le lien dans l’e-mail envoyé sur lequel l’utilisateur a cliqué.

Didacticiel

Pour obtenir un tutoriel qui montre comment s’abonner à des événements de messagerie à l’aide de web hooks, consultez Démarrage rapide : Gérer les événements de messagerie.

Partager via