1. Mailjet
  2. Support
  3. Documentation

Real-Time Monitoring

Sommaire

Introduction

Suivez les emails transactionnels essentiels à votre entreprise (envoyés via SMTP ou Send API) avec le Real-Time Monitoring de Mailjet.

Créez des alertes personnalisées et recevez des notifications en temps réel pour contrôler tout problème potentiel et prendre les mesures appropriées. Par exemple :

• Votre entreprise envoie généralement 10 emails de confirmation de commande par heure. Moins de 4 messages de confirmation de commande ont été envoyés au cours des 2 dernières heures ? Vous en serez averti.

• Vous envoyez des emails au nom de plusieurs clients. Le délai d’envoi est crucial. Vous souhaitez être averti quand ces emails prennent plus de 3 minutes à être envoyés afin de gérer de manière proactive les questions de votre client.

• Tous les samedis, vous annoncez des ventes flash privées à vos meilleurs clients. Habituellement, cet email rencontre un beau succès avec un taux de clics d’au moins 20%. Définissez une alerte pour être averti le week-end lorsque le taux de clics descend en dessous de 20%.

Ce guide vous apprendra à classer vos messages par catégorie, créer des alertes, configurer différents canaux de notification et consulter l’ensemble des notifications avec la fonctionnalité Real-Time Monitoring.

Real-Time Monitoring

Remarque : Real-Time Monitoring réel n’est disponible qu’avec les Plans Premium (Crystal et plus).

Aperçu de Real-Time Monitoring

Pour faire simple, Mailjet ajoute à vos emails transactionnels un en-tête personnalisé permettant d’identifier une catégorie. À vous ensuite de créer des alertes pour cette catégorie dans le but de suivre le volume, les statistiques, les délais d’envoi, etc. de vos emails. Une alerte se déclenche ? Vous recevez une notification.

Catégories

Créez des CATÉGORIES pour regrouper des types similaires d’emails transactionnels que vous souhaitez suivre. Un email transactionnel donné ne peut appartenir qu’à une seule catégorie.

Exemple de regroupement d’emails :

• Créez une grande catégorie « Commandes » pour suivre l’ensemble de vos emails relatifs aux commandes (nouvelles commandes, règlement de commandes, etc.).

• Créez une catégorie pour vous concentrer sur un type très particulier d’email, comme « Réinitialisation de mots de passe » ou « Création de comptes ».

• Si vous envoyez des emails au nom de vos clients, vous pouvez créer une catégorie pour chaque client.

Vous pouvez créer jusqu’à 50 catégories par clé API.

Real-Time Monitoring

Une fois les catégories créées, modifiez le script de vos emails transactionnels afin d’ajouter la nouvelle en-tête précisant la catégorie. (Cette étape nécessite des connaissances techniques. Elle est réalisée en dehors de votre tableau de bord.)

Alerts

Il est possible de créer plusieurs ALERTES pour chaque catégorie (jusqu’à 50 alertes par clé API).

Il existe 4 types d’alertes :

• Volume inhabituel

• Statistiques inhabituelles

• Retard d'envoi

• Erreurs sur un message important

Real-Time Monitoring

Vous êtes averti lorsque les conditions de l’alerte sont remplies.

[Revenir en haut]

Notifications

Vous pouvez définir un ou plusieurs modes de NOTIFICATION pour chaque alerte créée : email*, Slack, SMS (bientôt disponible).

Par défaut, toutes les notifications d'alerte s’affichent sur votre tableau de bord Real-Time Monitoring :

Real-Time Monitoring

* Les notifications par email ne sont pas décomptées de votre abonnement.

Accompagnement initial

Le système Mailjet vous aidera à configurer Real-Time Monitoring : il vous guidera dans la création de votre première catégorie de suivi et dans la configuration de vos modes de notification (email et Slack).

Cet accompagnement ne prendra que quelques minutes. Vous pourrez ensuite créer les alertes pour votre catégorie comme vous l'entendez.

Vous êtes prêt ?

Commencez par cliquer sur Transactionnel → Real-Time Monitoring.

Real-Time Monitoring

Cliquez ensuite sur « Continuer » dans l’écran d’accueil.

Real-Time Monitoring

[revenir en haut]

Étape 1 : Créer vos catégories de suivi

La catégorie de suivi permettra de regrouper les emails transactionnels que vous souhaitez suivre.

Vous pouvez créer jusqu’à 50 catégories. Vous choisissez comment regrouper vos emails.

Vous pouvez par exemple regrouper des emails par thème (par exemple les emails de facturation), par type d’envoi (par exemple les synthèses de comptes hebdomadaires) ou par performances (les emails de factures ont en général un taux de rejets moins élevé).

Saisissez le nom de la catégorie, puis cliquez sur « Enregistrer et continuer ».

Real-Time Monitoring

Étape 2 : Configurer vos canaux de notification

Au cours de cette première étape, vous choisirez comment vous souhaitez être averti lorsqu’une alerte se déclenche : par email ou par Slack.

Real-Time Monitoring

Notifications par email :

L’adresse email de votre compte est ajoutée par défaut à la liste des notifications par email, mais il vous est possible d’ajouter jusqu’à 20 adresses email. (Pour des raisons de sécurité, ajoutez uniquement les adresses de destinataires de confiance.)

Cliquez sur « Ajouter une adresse email » pour ajouter une nouvelle adresse. Saisissez ensuite l’adresse email accompagnée d’un titre (facultatif).

Real-Time Monitoring

Notifications par Slack :

Il est également possible d’envoyer les notifications à un maximum de 5 contacts sur Slack via un webhook. (Consultez l’ Annexe A pour savoir comment ajouter un webhook à Slack.)

Il vous suffit de cliquer sur « Ajouter à Slack » et de saisir votre webhook.

Real-Time Monitoring

Une fois terminé, cliquez sur « Sauvegarder et continuer » .

Real-Time Monitoring

Pour des raisons de sécurité, nous envoyons un email contenant un code unique de confirmation à chaque adresse email saisie dans la liste de notifications. Chaque destinataire doit confirmer l'invitation en vous faisant suivre l’email.

Une fois que vous avez reçu le code de confirmation, saisissez-le dans le champ correspondant et cliquez sur « Envoyer ».

Real-Time Monitoring

L’adresse email sera ainsi validée.

Real-Time Monitoring

Remarque : si vous recevez un message indiquant que le code saisi est erroné et invalide, vérifiez que vous l’avez bien saisi dans la ligne correspondante. Si c’est le cas, vous pouvez cliquer sur le lien « Renvoyer » pour qu'un nouveau code de confirmation soit envoyé au destinataire. Le code de confirmation n’est valable que 15 minutes.

Aucune confirmation n’est demandée pour Slack. Il suffit de cliquer sur « Enregistrer et continuer » pour poursuivre :)

Real-Time Monitoring

Super ! Vous avez configuré votre première catégorie de suivi et vos premiers canaux de notification !

Real-Time Monitoring

Comme indiqué à l’écran, n’oubliez pas d’ajouter l’en-tête de la nouvelle catégorie à vos messages transactionnels. Le suivi des emails transactionnels ne fonctionnera pas sinon.

Vous avez besoin d'un développeur pour cette étape. Il ajoutera un nouvel en-tête à vos scripts transactionnels pour les emails liés à la votre catégorie donnée. Il suffit de remplacer nom_de_votre_catégorie par le nom de la catégorie que vous venez de créer.

  • Send API : “MonitoringCategory”: “nom_de_votre_catégorie”
  • SMTP :X-MJ-MonitoringCategory: nom_de_votre_catégorie

(Vous trouverez les guides sur Real-Time Monitoring pour les développeurs sur dev.mailjet.com)

Une fois vos scripts mis à jour, cliquez sur le bouton « Continuer » pour terminer le processus d’accompagnement et accéder au tableau de bord Général.

Real-Time Monitoring

Vous pouvez alors créer vos alertes de suivi pour votre nouvelle catégorie, créer d’autres catégories ou modifier vos notifications d'alerte.

[revenir en haut]

Alertes

Général

Général

Après avoir créé une catégorie, vous pouvez créer des alertes pour cette dernière.

Pour cela, commencez par sélectionner le type d'alerte :

  • Volume inhabituel
    Vous serez averti dès que le volume d’emails envoyés sort des seuils que vous avez définis.
  • Alerte de statistiques inhabituelles
    Vous serez averti dès que les statistiques (taux d’ouvertures, d'erreurs, de mises en spam, etc.) sortent des seuils que vous aurez définis.
  • Alerte de retard d'envoi
    Vous serez averti dès que l’envoi des emails prend plus de temps que prévu.
  • Alerte d’erreur sur message critique
    Vous serez tout de suite averti quand des emails importants sont rejetés ou bloqués.

Real-Time Monitoring

Une fois le type d'alerte sélectionné, saisissez les paramètres de l’alerte :

Real-Time Monitoring

1) Nom de l'alerte : Nom unique pour l’alerte. Ce nom sera utilisé dans les différents canaux de notification (le tableau de bord, l’objet des notifications par email, etc.).

2) Définition de l'alerte : Définit les seuils et conditions de l’alerte et le type de notification à envoyer (avertissement ou critique). Par exemple : une notification critique doit être envoyée quand le taux d'ouverture est inférieur à 10% au cours des 2 derniers jours.

3) Options d'alerte : Paramétrez l’alerte pour qu’elle reste active en permanence ou uniquement à des jours et heures spécifiques.

4) Canaux d'alerte : Sélectionnez les modes de notification de l’alerte (email, Slack).

Découvrez comment créer une alerte de chaque type :

Alerte de volume inhabituel
Alerte de statistiques inhabituelles
Alerte de retard d'envoi
Alerte d’erreur sur message critique

[revenir en haut]

Créer des alertes
Alerte de volume inhabituel

Soyez averti si aucun message ou un volume peu élevé de messages est envoyé au cours d'une période donnée.

Dans cet exemple, nous souhaitons être avertis seulement le week-end lorsqu’aucun email d’activation de compte n’est envoyé depuis 2 heures. Cette alerte enverra une notification critique via email et Slack.

Cliquez sur « Créer une nouvelle alerte » dans l’onglet Alertes.

Real-Time Monitoring

Sélectionnez la catégorie pour laquelle s’appliquera l’alerte. Cochez la case « Volume inhabituel » puis cliquez sur « Continuer ».

Real-Time Monitoring

Saisissez un Nom d'alerte.

Sélectionnez les éléments suivants sous la section Définition de l'alerte :

• Envoyez-moi un :   message critique
• Quand :                 aucun message
• A (ont) été :            envoyé
• Au cours des dernières : 2 heures

Real-Time Monitoring

Sous Options d'alerte, sélectionnez « Déclencher cette alerte uniquement aux jours et heures indiqués » et cochez uniquement les cases samedi et dimanche.

Real-Time Monitoring

Sous Canaux d'alerte, sélectionnez une adresse email et une room Slack. Cliquez ensuite sur « Continuer ».

Real-Time Monitoring

Vérifiez les paramètres de votre alerte. Cliquez sur « Annuler » si vous devez procéder à des modifications. Sinon, cliquez sur le bouton « Créer l'alerte ».

Real-Time Monitoring

Votre nouvelle alerte apparaîtra sur la page des alertes.

Real-Time Monitoring

[revenir en haut]

Alerte de statistiques inhabituelles

Recevez des alertes si les statistiques de vos messages (envoi, taux d'ouvertures, de clics, de mises en spam, etc.) sortent des seuils définis pour ces dernières heures ou ces derniers jours.

Nous souhaitons être avertis si le taux d'ouverture descend sous les 5% pour les emails de confirmation de commande envoyés ces dernières 24 heures. La notification d'avertissement sera envoyée via email et Slack.

Cliquez sur « Créer une nouvelle alerte » depuis la page Général.

Real-Time Monitoring

Sélectionnez la catégorie pour laquelle s’appliquera l’alerte.

Cochez la case « Statistiques inhabituelles » puis cliquez sur « Continuer ».

Real-Time Monitoring

Saisissez un Nom d'alerte.

Sélectionnez les éléments suivants sous la section Définition de l'alerte :

• Envoyez-moi un : message d’avertissement
• Quand le :            taux de clics
• Est :                     inférieur à 5 (%)
• Au cours des dernières :     1 jour

Real-Time Monitoring

Inutile de modifier les Options d'alerte.

Sélectionnez les notifications de vos Canaux d'alerte avant de cliquer sur « Continuer ».

Real-Time Monitoring

Vérifiez les paramètres de votre alerte. Cliquez sur « Retour » si vous devez procéder à des modifications.

Sinon, cliquez sur le bouton « Créer l'alerte ».

Real-Time Monitoring

Votre nouvelle alerte apparaîtra sur la page des alertes.

Real-Time Monitoring

[revenir en haut]

Alerte de retard d'envoi

Recevez des alertes si la première tentative d’envoi d’emails prend plus de temps que la durée prédéfinie (en minutes).

Dans cet exemple, nous souhaitons être avertis si la première tentative d’envoi de l’email de récapitulatif hebdomadaire (email envoyé le vendredi) prend plus de 5 minutes.

Cliquez sur « Créer une nouvelle alerte » depuis la page Général.

Real-Time Monitoring

Sélectionnez la catégorie pour laquelle s’appliquera l’alerte.

Cochez la case « Retard d’envoi » puis cliquez sur « Continuer ».

Real-Time Monitoring

Saisissez un Nom d'alerte.

Sélectionnez les éléments suivants sous la section Définition de l'alerte :

• Envoyez-moi un : message d’avertissement
• Chaque fois que la première tentative… : 8 minutes

Real-Time Monitoring

Dans les Options d'alerte, cochez uniquement la case du vendredi.

Sélectionnez les Canaux d'alerte sur lesquels vous souhaitez recevoir les notifications avant de cliquer sur « Continuer ».

Real-Time Monitoring

Vérifiez les paramètres de votre alerte, puis cliquez sur le bouton « Créer l'alerte ».

Real-Time Monitoring

Votre nouvelle alerte apparaîtra sur la page des alertes.

Real-Time Monitoring

[revenir en haut]

Alerte d’erreur sur message critique

Soyez immédiatement averti quand un message est bloqué ou rejeté.

Remarque : cette alerte est conçue pour vos messages les plus importants pour lesquels l’adresse email du destinataire a été vérifiée... Utilisée autrement, cette alerte risque de déclencher de nombreuses notifications.

Nous allons créer une alerte pour être avertis chaque fois qu’un message envoyé au nom de notre client est rejeté.

Cliquez sur « Créer une nouvelle alerte » dans la page Alertes.

Real-Time Monitoring

Sélectionnez la catégorie pour laquelle s’appliquera l’alerte.

Cochez la case « Erreur sur un message important » puis cliquez sur « Continuer ».

Real-Time Monitoring

Saisissez un Nom d'alerte.

Sélectionnez les éléments suivants sous la section Définition de l'alerte :

• Envoyez-moi un : message d’avertissement
• Chaque fois qu’un message : est rejeté

Real-Time Monitoring

Sélectionnez les canaux de notification avant de cliquer sur « Continuer ».

Real-Time Monitoring

Vérifiez les paramètres de votre alerte, puis cliquez sur le bouton « Créer l'alerte ».

Real-Time Monitoring

Votre nouvelle alerte apparaîtra sur la page des alertes.

Real-Time Monitoring

[revenir en haut]

Modifier des alertes

Vous pouvez modifier une alerte existante à tout moment. Il vous suffit pour cela de sélectionner Gérer → Modifier pour l’alerte de votre choix danssur la page Alertes.

Real-Time Monitoring

Modifiez votre alerte puis cliquez sur « Continuer ».

Real-Time Monitoring

Cliquez ensuite sur « Créer l'alerte » pour enregistrer les modifications.

Real-Time Monitoring

Dupliquer des alertes

Depuis la page Alertes, sélectionnez la campagne que vous souhaitez dupliquer, puis choisissez Gérer → Dupliquer.

Real-Time Monitoring

Saisissez le nouveau nom de l’alerte que vous venez de dupliquer et procédez aux modifications nécessaires.

Cliquez ensuite sur « Continuer ».

Real-Time Monitoring

Vérifiez votre nouvelle alerte, puis cliquez sur « Créer l'alerte ».

Real-Time Monitoring

[revenir en haut]

Supprimer des alertes

Sachez qu’une fois que vous avez supprimé une alerte, vous ne pouvez plus revenir en arrière. Si vous souhaitez conserver votre alerte, vous pouvez simplement désactiver les notifications par email et Slack. (Les alertes par défaut s’affichent toujours dans votre tableau de bord.)

Pour supprimer une alerte, rendez-vous sur la page « Alertes » et sélectionnez l'alerte que vous souhaitez supprimer, puis choisissez Gérer → Supprimer. Confirmez ensuite la suppression dans la fenêtre contextuelle.

Real-Time Monitoring

Désactiver toutes les alertes

Pour arrêter de recevoir vos notifications par email, SMS et Slack pour l’ensemble de vos alertes actives actuelles, cliquez sur le bouton « Tout désactiver » depuis n’importe quel onglet.

Real-Time Monitoring

Toutes les notifications d'alerte seront désactivées (sauf pour le tableau de bord).

Real-Time Monitoring

Pour les réactiver, il vous suffit de cliquer sur le lien « Réactiver » depuis n’importe quel onglet.

Real-Time Monitoring

Remarque : les nouvelles alertes créées pendant que l'option « Désactiver toutes les alertes » est sélectionnée ne seront pas désactivées.

[revenir en haut]

Catégories

Général

Regroupez les emails transactionnels que vous souhaitez suivre ensemble par catégorie. Un message ne peut appartenir qu'à une seule catégorie.

Vos catégories doivent refléter vos besoins professionnels. Vous pouvez les définir de différentes manières, notamment :

  • Regrouper les emails par performances (si par exemple les emails de confirmation de nouveaux comptes présentent un taux d’erreur supérieur à celui des emails de confirmation de commande)
  • Regrouper les emails par thème (activation de comptes, confirmation de commandes, etc.)
  • Regrouper les emails les plus importants pour votre entreprise (par exemple les emails qui traitent d’argent ou de problèmes juridiques)
  • Regrouper les emails par type d’envoi (par exemple pour séparer les emails hebdomadaires des emails pouvant être envoyés à tout moment)

Une fois vos catégories définies, une propriété de message est ajoutée à l’en-tête de vos emails transactionnels pour activer le suivi.

Vous pouvez définir vos catégories dans le tableau de bord Real-Time Monitoring ou via l’API.

Nous allons créer une catégorie depuis le tableau de bord.

Créer une catégorie

Sur la page Catégories, cliquez sur « Créer une nouvelle catégorie ».

Real-Time Monitoring

Saisissez le nom de votre catégorie avant de cliquer sur « Enregistrer la catégorie ».

Real-Time Monitoring

Attention ! Notez qu'une fois la catégorie créée, il est impossible de modifier son nom. Pour modifier le nom de la catégorie, vous devrez supprimer la catégorie actuelle pour en créer une nouvelle.

Ajouter et tester un en-tête personnalisé

Après la création d'une catégorie, un développeur devra mettre à jour les scripts des emails transactionnels concernés.

Pour chaque catégorie créée, il faut ajouter un en-tête personnalisé à l’email transactionnel :

  • Send API : “MonitoringCategory”: «nom_de_votre_catégorie_ici »
  • SMTP :X-MJ-MonitoringCategory: nom_de_votre_catégorie_ici

(Vous trouverez les guides sur Real-Time Monitoring pour les développeurs sur dev.mailjet.com).

Une fois l’en-tête ajouté, envoyez un email transactionnel test qui déclenchera une alerte pour cette catégorie. Après son envoi, vous pourrez vérifier la notification d'alerte dans votre tableau de bord.

Supprimer une catégorie

Attention ! Si des alertes sont liées à la catégorie, la suppression de la catégorie entraînera également la suppression de ses alertes. Sachez qu’une fois que vous avez supprimé une catégorie, vous ne pouvez plus revenir en arrière.

Pour supprimer une catégorie, rendez-vous sur la page Catégories et sélectionnez la catégorie à supprimer, puis choisissez Gérer → Supprimer. Validez ensuite l’action dans la fenêtre de confirmation.

Real-Time Monitoring

Canaux de notification

Affichage des alertes (onglet Général)

Vous définissez la période d’affichage des notifications d'alerte depuis votre tableau de bord Real-Time Monitoring.

Real-Time Monitoring

Rendez-vous pour cela dans l’onglet Préférences et sélectionnez la période d’affichage de votre choix.

Real-Time Monitoring

Si vous sélectionnez par exemple 12 heures, le tableau de bord Aperçu affichera l’ensemble des alertes des dernières 12 heures.

Adresses email pour les notifications

Depuis l'onglet Préférences, vous pouvez gérer jusqu’à 20 adresses email servant de canaux de notification.

Real-Time Monitoring

Pour ajouter une nouvelle adresse email, il vous suffit de cliquer sur le bouton « Ajouter une adresse » puis d’entrer la nouvelle adresse email ainsi que le titre de votre choix.

Real-Time Monitoring

Pour des raisons de sécurité, un email contenant un code de confirmation est envoyé à chaque nouvelle adresse ajoutée. Il est demandé au destinataire d’accepter l'invitation en transmettant le code à l'administrateur du compte.

Saisissez le code pour valider l’adresse email. Si vous ne recevez pas le code tout de suite, cliquez sur « Plus tard ».

Real-Time Monitoring

Pour valider une adresse email plus tard, sélectionnez Gérer → Veuillez confirmer l’adresse email pour envoyer une nouvelle invitation et un nouveau code à l'adresse du destinataire. Saisissez le code dès que le destinataire répond à l’email.

Real-Time Monitoring

Pour modifier le nom d’une adresse email existante, sélectionnez Gérer → Modifier le libellé (Si vous avez besoin de modifier l'adresse email elle-même supprimez-la pour en créer ensuite une nouvelle.)

Real-Time Monitoring

Pour supprimer une adresse, sélectionnez l'adresse à supprimer puis choisissez Gérer → Supprimer. Pour supprimer plusieurs adresses à la fois, sélectionnez les différentes adresses concernées, puis cliquez sur l’icône de suppression (en forme de corbeille).

Real-Time Monitoring

[revenir en haut]

Notifications par Slack

Gérez vos notifications via Slack (5 canaux maximum) depuis l'onglet Préférences.

Real-Time Monitoring

Ajouter un nouveau canal Slack

Cliquez sur le bouton « Ajouter un nouveau canal Slack », puis saisissez le webhook Slack et le titre (facultative). (Consultez l’ Annexe A pour savior comment obtenir un webhook Slack.)

Real-Time Monitoring

Pour modifier le titre, sélectionnez Gérer → Modifier le libellé (Si vous avez besoin de modifier l'URL du webhook Slack, supprimez le canal actuel pour en créer ensuite un nouveau.)

Real-Time Monitoring

Pour supprimer un webhook et arrêter toutes les notifications dans cette room Slack, sélectionnez le webhook de votre choix, puis choisissez Gérer → Supprimer. Pour supprimer plusieurs webhooks, sélectionnez les différents webhooks concernés et cliquez sur l’icône de suppression.

Real-Time Monitoring

[revenir en haut]

Consulter les notifications d'alerte dans l'onglet Général

L'onglet Général affichera par défaut toutes vos notifications d'alerte récentes.

(Allez dans l'onglet Préférences pour modifier la période d’affichage des notifications dans cet onglet.)

Real-Time Monitoring

Cliquez sur une notification…

Real-Time Monitoring

…pour afficher plus de détails, comme les canaux de notification, les destinataires concernés, la cause du problème, etc.

Real-Time Monitoring

[revenir en haut]

Annexe A - Créer un webhook Slack

Pour ajouter Slack comme canal de notification, vous devez commencer par créer un webhook Slack. Cette action nécessite les droits d’administrateur dans Slack.

Rendez-vous dans la room Slack où vous souhaitez faire apparaître les notifications.

Cliquez sur Channel Settings → Add an app or integration.

Real-Time Monitoring

Dans la nouvelle fenêtre, cliquez sur « Build ».

Real-Time Monitoring

Sous App Features, cliquez sur « Incoming webhooks ».

Real-Time Monitoring

Cliquez ensuite sur le lien « incoming webhook integration ».

Real-Time Monitoring

Cliquez simplement sur le bouton « Add Incoming WebHooks integration ».

Real-Time Monitoring

L’URL de webhook que vous avez générée est prête !

Real-Time Monitoring

Il vous suffit maintenant de retourner sur l'onglet « Préférences » dans Real-Time Monitoring et de créer votre alerte Slack.

Real-Time Monitoring

[revenir en haut]

Essayer Mailjet maintenant ?
Créez un compte - sans engagement, sans frais cachés