Partager via

Démarrage rapide : Gérer les événements d’e-mail

  • Article

Démarrez avec Azure Communication Services en utilisant Azure Event Grid pour gérer les événements d’e-mail de Communication Services. Après vous être abonné à des événements d’e-mail tels que des rapports de remise et des rapports d’engagement, vous générez et recevez ces événements. Le fait de suivre ce guide de démarrage rapide entraîne une petite dépense de quelques cents USD tout au plus dans votre compte Azure.

Prérequis

À propos d’Event Grid

Event Grid est un service d’événement cloud. Dans cet article, vous allez apprendre à vous abonner à des événements de service de communication et à déclencher un événement pour voir le résultat. En règle générale, vous envoyez des événements à un point de terminaison qui traite les données d’événement et entreprend des actions. Dans cet article, nous allons envoyer les événements à une application web qui collecte et affiche les messages.

Configurer l’environnement

Pour configurer l’environnement que nous allons utiliser pour générer et recevoir des événements, suivez les étapes décrites dans les sections suivantes.

Enregistrer le fournisseur de ressources Event Grid

Si vous n’avez jamais utilisé Event Grid dans votre abonnement Azure, vous risquez de devoir inscrire votre fournisseur de ressources Event Grid. Pour inscrire le fournisseur, procédez comme suit :

  1. Accédez au portail Azure.
  2. Sélectionner Abonnements dans le menu de gauche.
  3. Sélectionnez l’abonnement que vous utilisez pour Event Grid.
  4. Dans le menu de gauche, sous Paramètres, sélectionnez Fournisseurs de ressources.
  5. Recherchez Microsoft.EventGrid.
  6. Si le fournisseur de ressources n’est pas inscrit, sélectionnez Enregistrer.

L’inscription peut prendre un certain temps. Sélectionnez Actualiser pour mettre à jour l’état. Lorsque Enregistré s’affiche sous le Statut, vous êtes prêt à continuer

Déployer la visionneuse Event Grid

Pour ce guide de démarrage rapide, nous allons utiliser une visionneuse Event Grid pour voir les événements en quasi-temps réel. La visionneuse offre à l’utilisateur l’expérience d’un flux en temps réel. De plus, la charge utile de chaque événement doit être disponible pour inspection.

Pour configurer la visionneuse, suivez les étapes décrites dans Visionneuse Azure Event Grid.

S’abonner aux événements d’e-mail à l’aide de webhooks

Vous pouvez vous abonner à des événements spécifiques pour fournir à Event Grid des informations sur l’emplacement d’envoi des événements que vous souhaitez suivre.

  1. Dans le portail, accédez à la ressource Communication Services que vous avez créée.

  2. Dans la ressource Communication Services, sélectionnez Événements dans le menu de gauche de la page Communication Services.

  3. Sélectionnez Ajouter un abonnement aux événements.

    Capture d’écran montrant la page Événements d’une ressource Azure Communication Services. Le bouton Abonnement aux événements est mis en évidence.

  4. Dans la page Créer un abonnement aux événements, entrez un nom pour l’abonnement aux événements.

  5. Sous Types d’événements, sélectionnez les événements auxquels vous souhaitez vous abonner. Pour E-mail, vous pouvez choisir Email Delivery Report Received et Email Engagement Tracking Report Received.

  6. Si vous êtes invité à fournir un Nom de rubrique système, n’hésitez pas à fournir une chaîne unique. Ce champ n’a aucun impact sur votre expérience et est utilisé à des fins de télémétrie interne.

    Capture d’écran montrant la boîte de dialogue Créer un abonnement aux événements. Sous Types d’événements, Rapport de remise d’e-mail reçu et Rapport de suivi de l’engagement par e-mail sont sélectionnés.

  7. Pour le type de point de terminaison, sélectionnez Web Hook.

    Capture d’écran montrant un détail de la boîte de dialogue Créer un abonnement aux événements. Dans la liste Type de point de terminaison, Webhook est sélectionné.

  8. Pour le Point de terminaison, choisissez Sélectionner un point de terminaison, puis entrez l’URL de votre application web.

    Dans le cas présent, nous allons utiliser l’URL de lavisionneuse Event Grid que nous avons configurée précédemment dans le guide de démarrage rapide. L’URL de l’exemple a ce format : https://{{site-name}}.azurewebsites.net/api/updates

  9. Sélectionnez Confirmer la sélection.

    Capture d’écran montrant la boîte de dialogue Sélectionner un webhook. La zone Point de terminaison de l’abonné contient une URL et un bouton Confirmer la sélection est visible.

Afficher les événements d’e-mail

Pour générer et recevoir des événements d’e-mail, suivez les étapes décrites dans les sections suivantes.

Déclencher des événements d’e-mail

Pour afficher les déclencheurs d’événements, nous devons générer certains événements. Pour déclencher un événement, envoyez un e-mail à l’aide de la ressource de domaine d’e-mail attachée à la ressource Communication Services.

  • Les événements Email Delivery Report Received sont générés lorsque l’e-mail est dans un état terminal, c’est-à-dire Livré, En échec, FilteredSpam, En quarantaine.

  • Les événements Email Engagement Tracking Report Received sont générés quand l’e-mail envoyé est ouvert ou quand un lien dans l’e-mail a fait l’objet d’un clic. Pour déclencher un événement, vous devez activer l’option User Interaction Tracking sur la ressource de domaine d’e-mail

Consultez la liste complète des événements pris en charge par Azure Communication Services.

Recevoir des événements d’e-mail

Après avoir généré un événement, vous remarquerez que les événements Email Delivery Report Received et Email Engagement Tracking Report Received sont envoyés à votre point de terminaison. Ces événements s’affichent dans lavisionneuse Event Grid que nous avons configurée au début de ce démarrage rapide. Sélectionnez l’icône représentant un œil en regard de l’événement pour voir l’intégralité de la charge utile. Les évènements doivent ressembler aux données suivantes :

Capture d’écran de la visionneuse Azure Event Grid montrant le schéma Event Grid pour un événement de rapport de remise d’e-mail reçu.

Capture d’écran de la visionneuse Azure Event Grid montrant le schéma Event Grid pour un événement de rapport de suivi de l’engagement par e-mail.

  • EngagementContext fait référence au lien cliqué lorsque l’engagementType est Click.
  • UserAgent fait référence à l’User-Agent d’où provient cet événement d’engagement d’e-mail. par exemple Si l’utilisateur a interagi sur Edge à l’aide d’un ordinateur Win10 : Mozilla/5.0 (Windows NT 10.0 ; Win64 ; x64) AppleWebKit/537.36 (KHTML, comme Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType fait référence au type d’engagement. Les valeurs possibles sont « Affichage » ou « Clic ».

Découvrez-en plus sur les schémas d’événements et d’autres concepts liés aux événements.

Nettoyer les ressources

Si vous voulez nettoyer et supprimer un abonnement Communication Services, vous pouvez supprimer la ressource ou le groupe de ressources. La suppression du groupe de ressources efface également les autres ressources qui y sont associées. Apprenez-en davantage sur le nettoyage des ressources.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez appris comment consommer des événements d’e-mail. Vous pouvez recevoir des événements d’e-mail en créant un abonnement Event Grid.

Envoyer un e-mail

Pour obtenir des informations de schéma et des exemples d’événements, consultez Azure Communication Services - événements Email.

Vous pouvez également voir les articles suivants :