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

Article
01/24/2025

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 de SMS (Short Message Service) 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 été rejeté. Cela peut être dû à une adresse email inexistante ou à un domaine invalide.
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