Aller au contenu

Guide

Consulter les journaux d'exécution des automatisations

Automatisations et intégrations · 7 min de lecture

Chaque fois qu'une règle d'automatisation s'exécute, Mateflow l'enregistre dans les journaux d'exécution (historique des automatisations, journal des exécutions). Utilisez les tests et les journaux pour vérifier qu'une règle fait ce que vous attendez, comprendre pourquoi une exécution a échoué ou a été ignorée, et la relancer.

Qui peut le faire : Les propriétaires et les administrateurs. Les modérateurs ne voient pas les automatisations. · Où : Sur le web (console d'administration). · Offre : Les automatisations dépendent de votre offre de la plateforme.

Tester une règle d'automatisation avant de l'activer

Les nouvelles règles sont enregistrées désactivées : vous pouvez donc d'abord les tester. Cliquez sur Tester la règle sur la page de la règle, ou dans le formulaire avant l'enregistrement. Un test est une simulation : il vérifie le déclencheur et les conditions et remplit le texte, mais n'exécute jamais les actions.

  1. Sous Données de déclenchement, choisissez Données d’exemple ou le Dernier événement réel de votre communauté.
  2. Si vous le souhaitez, choisissez un Membre (facultatif). Les conditions sur le membre, comme les points, les tags et les jours depuis l'inscription, sont vérifiées pour cette personne. Avec des données d'exemple et sans membre, elles ne sont pas remplies.
  3. Cliquez sur Tester la règle.

Le résultat s'affiche sur la règle : chaque condition indique Remplie ou Non remplie, et les actions qui ne s'exécuteraient pas affichent Ne s’exécutera pas. Les tests ignorent la Fréquence : un test peut donc réussir pour un membre pour lequel la règle s'est déjà exécutée. Lorsqu'un événement réel n'exécuterait pas la règle pour cette raison, une note en haut du résultat l'indique et précise quand la règle s'est exécutée.

Exécuter une règle d'automatisation maintenant

Exécuter maintenant sur la page d'une règle exécute réellement la règle. Choisissez un Membre pour l'exécuter comme s'il l'avait déclenchée, ou laissez le champ vide et utilisez des données d'exemple. Elle envoie de vraies notifications et produit de vrais points, tags, changements d'espace et webhooks.

Sans membre sélectionné, vérifiez le JSON du déclencheur. Il doit être un objet comme {} ; tableaux, null et valeurs simples sont refusés. Le journal s'ouvre après mise en file s'il est disponible. Les déclencheurs du cycle d'événement n'autorisent pas l'exécution immédiate.

Ouvrir les journaux d'exécution des automatisations

Accédez à Admin → Automatisations → Journaux d'exécution. La page liste les exécutions de toutes vos règles, des plus récentes aux plus anciennes. Chaque ligne affiche Date, Règle, le Membre, le Déclencheur qui l'a lancée et son Statut. Pour voir les exécutions d'une seule règle, ouvrez la règle depuis Admin → Automatisations → Règles.

En haut, Aperçu affiche les exécutions, le taux de réussite et la durée sur les Dernières 24 h, les 7 derniers jours ou les 30 derniers jours, avec Évolution des exécutions, Échecs et Erreurs par type. Cliquez sur une règle sous Règles les plus actives ou Règles avec le plus d'erreurs pour l'ouvrir.

Les journaux d'exécution sont conservés 30 jours. Les exécutions encore en cours, ou en attente d'une action différée, ne sont jamais supprimées.

Filtrer les journaux d'exécution des automatisations

  • Rechercher par nom de règle ou déclencheur.
  • Toutes les règles : choisissez une règle.
  • Tous les membres : choisissez un membre, par exemple pour comprendre pourquoi quelqu'un n'a pas reçu de notification de bienvenue.
  • Statut, et une plage de dates.
  • Inclure les journaux de test : les exécutions de test sont masquées, sauf si vous activez cette option. Elles portent le libellé Test.

Cliquez sur Effacer pour revenir à la liste complète. Cliquez sur Charger plus en bas de la liste pour voir des exécutions plus anciennes.

Signification de chaque statut d'exécution d'une automatisation

Statut Signification
Réussie Toutes les actions ont été exécutées.
Échec partiel Certaines actions ont été exécutées et au moins une a échoué.
Échouée L'exécution a échoué.
Ignorée La règle n'a rien fait, par exemple parce que ses conditions n'étaient pas remplies.
En file d'attente L'exécution est en file d'attente.
En cours L'exécution est en cours. Une exécution qui comporte des actions différées reste dans cet état jusqu'à ce que la dernière ait été exécutée.

Pour une exécution Ignorée, Détails du journal affiche le Motif de l'omission, comme Conditions non remplies ou Votre forfait n’inclut pas les automatisations : les règles sont en pause. Dans le navigateur d'un téléphone, la ligne l'affiche aussi.

Pourquoi un événement n'apparaît pas dans les journaux d'automatisation

Mateflow ne consigne pas chaque événement qu'une règle ignore : un membre peut donc être absent des journaux alors que la règle est activée. Ces cas ne laissent aucune entrée :

  • L'événement ne correspond pas aux paramètres du déclencheur de la règle, comme son espace, son événement ou son seuil de points.
  • L'événement échoue à une condition Espace du déclencheur ou Type de contenu.
  • La règle est réglée sur Une fois par membre ou Une seule fois et a déjà utilisé cette exécution. Cherchez l'exécution Réussie précédente, ou testez la règle avec ce membre.

Les conditions portant sur le membre, comme les tags, les points et le nombre de jours depuis l'inscription, consignent bien une exécution Ignorée.

Voir le détail d'une exécution d'automatisation

Cliquez sur une ligne pour ouvrir Détails du journal. Vous y trouvez :

  • le Membre et ce sur quoi portait l'exécution, comme une publication, un événement ou un cours ;
  • Seulement si (Conditions) : chaque condition avec Remplie ou Non remplie et la valeur réelle. Après l'échec de l'une d'elles, les suivantes affichent Non vérifiée (une condition précédente n'était déjà pas remplie) ;
  • Données du déclencheur et Résultats des actions, y compris le nombre de membres auxquels une notification a été envoyée (Envoyée à) et l'échéance d'une action différée (Prévu) ;
  • la Durée et, pour une exécution qui a échoué, le Message d'erreur, l'Étape de l'échec et un code d'erreur sur chaque action qui a échoué.

Parmi les codes d'erreur courants figurent Délai dépassé, Requête rejetée (4xx), Erreur du serveur (5xx), Cible introuvable, Aucun membre cible, Les points sont désactivés dans cette communauté, Le cours est complet et Règle modifiée pendant l'attente pour une action différée dont la règle a changé.

Relancer une automatisation qui a échoué

Les actions qui ont échoué ne sont pas réessayées automatiquement : vous pouvez donc relancer les exécutions Échouée et Échec partiel depuis Détails du journal. Les exécutions de test ne peuvent pas être relancées.

  • Relancer les actions en échec : seules les actions qui ont échoué s'exécutent de nouveau, immédiatement et sans leur délai.
  • Relancer toute la règle : toutes les actions s'exécutent de nouveau avec les données de déclenchement d'origine. Les notifications et les webhooks sont envoyés de nouveau, mais les points déjà attribués ne sont pas attribués deux fois.

Confirmez dans Relancer cette exécution ?. Vous voyez Relance mise en file d'attente, et la nouvelle exécution porte la mention Relance d'une exécution précédente. Corrigez d'abord la cause, par exemple les paramètres de la règle ou l'adresse du webhook. Si une règle échoue 5 fois d'affilée, le propriétaire et les administrateurs sont prévenus, et la règle reste activée jusqu'à ce que vous la désactiviez. Consultez Automatiser des tâches avec des règles.

Si la règle a changé ou si un ancien journal manque d'historique fiable, la relance partielle peut être refusée. Vérifiez la règle avant une relance complète, qui peut renvoyer les messages. Les filtres utilisent les jours UTC ; la durée inclut l'attente et les répartitions peuvent reposer sur des échantillons plafonnés.

Rattraper une exécution d'automatisation ignorée

Une exécution ignorée à cause de votre forfait ou de ses conditions peut quand même être lancée, par exemple après une mise à niveau ou après avoir ajouté le tag qui manquait au membre. Cliquez sur l'exécution pour ouvrir Détails du journal, cliquez sur Rattraper et confirmez dans Rattraper cette exécution ?. Les exécutions de test ne peuvent pas être rattrapées.

L'événement s'exécute maintenant avec ses données de déclenchement d'origine : les conditions sont de nouveau vérifiées et, si elles sont remplies, les actions s'exécutent. Fréquence s'applique toujours : si la règle a déjà utilisé cette exécution, vous voyez une erreur et rien n'est envoyé.

Pour le cycle d'événement, le rattrapage revérifie l'horaire, la règle, l'accès, l'audience et les préférences. Il ne force pas un avis expiré et ne contourne pas un rappel personnel occupant ce créneau.

Vérifier la livraison des e-mails dans les journaux

Une action e-mail possède un état de livraison distinct du résultat de la règle. Accepté par le service ne signifie pas livré. Consultez les détails pour voir destinataire, tentatives et résultat, puis actualisez si le résultat est en attente ou incertain. Relancer ne soumet pas à nouveau les e-mails déjà acceptés. La reprise n’est proposée que si le service confirme qu’une nouvelle tentative est possible ; corrigez d’abord la cause. Voir Envoyer des e-mails marketing automatisés.

Articles associés

Ce guide vous a-t-il été utile ?

Retour aux guides

Vous ne trouvez pas ce qu'il vous faut ?

Si vous êtes membre d'une communauté, ses administrateurs sont les mieux placés pour vous aider. Si vous créez ou gérez une communauté sur Mateflow, notre équipe peut vous aider.