Où surveiller l'état des actions d'intégration ?

Ce que montre la page

Chaque tâche exécutée par vos étapes de flux et l'agent dans vos intégrations arrive ici : combien de fois elle a tourné, combien ont échoué et pourquoi. Les outils de l'agent de boutique (recherche de produits, statut de commande…) sont aussi comptés ici. Si une connexion se rompt ou si une étape cesse de fonctionner, votre équipe est prévenue.

Ouvrez l'onglet « Statistiques d'actions » de la page Intégrations. Tous les membres peuvent le voir.

Les mêmes données apparaissent aussi dans les cartes « Ce qu'il fait » de la page du fournisseur et dans l'onglet Analyse de l'agent.

Parties de la page

• Filtres : la plage de dates est à côté des onglets ; par défaut, les 7 derniers jours. Le filtre « Intégration » est sous les alertes et ne les filtre pas ; « Effacer » le réinitialise.
• Indicateurs : « Réussis », « Échoués », « Taux de réussite » et « Durée moyenne ».
• Graphiques : « Exécutions par jour », « Exécutions échouées par jour » et « Par agent » (exécutions et taux de réussite).
• Le tableau « Par action » : exécutions et échecs de chaque action, taux de réussite et « Erreur la plus fréquente ». Cliquez sur une ligne pour ouvrir la page de l'intégration.
• « Appels » : chaque exécution une par une, de la plus récente à la plus ancienne, filtrées par « Statut » et « Source » (« Étape de flux » ou « Assistant IA »). Cliquez sur une ligne pour voir l'erreur, la réponse du fournisseur et le statut HTTP, le nombre d'essais en cas de nouvelle tentative, un lien vers l'enregistrement créé et les champs envoyés au fournisseur. Les adresses e-mail et longs numéros sont masqués ; les champs envoyés et le texte d'erreur sont conservés 7 jours, l'exécution elle-même reste dans la liste. Les exécutions arrêtées par la limite horaire sont aussi comptées.

Un résultat enregistré renvoyé au rechargement de la page n'est pas compté ; seules les vraies exécutions le sont.

Alertes

Une alerte s'ouvre dans trois cas :

• Connexion : s'ouvre à la première erreur d'autorisation. Les étapes de vos agents prennent entre-temps leur branche d'erreur ; il faut vous reconnecter.
• Fournisseur : s'ouvre selon la fenêtre de temps et le seuil de la page Outils (par défaut, 5 échecs en 15 minutes).
• Étape de flux : s'ouvre quand une étape d'un flux rencontre une erreur de réglage 3 fois de suite. Utilisez « Ouvrir l'agent » pour vérifier les réglages de l'étape.

Les erreurs comme « Champ obligatoire vide » et les erreurs de limite sont comptées, mais n'ouvrent pas d'alerte.

Les alertes vont aux canaux liés à la notification « Échec d'une étape d'intégration » sur la page « Alertes et notifications » ; dans un nouvel espace de travail, les propriétaires et administrateurs les reçoivent par e-mail. Quand tout repart, un message « fonctionne à nouveau » est aussi envoyé.

Dans le catalogue, une intégration avec une alerte ouverte affiche « À vérifier » au lieu de « Connecté ». Les alertes fermées sont listées dans « Historique des alertes », juste sous les alertes ouvertes, comme « Rétabli », « Reconnecté » ou « Expiré ». « Expiré » signifie qu'il n'y a eu aucun nouvel échec pendant 7 jours.

Erreurs fréquentes

• « Autorisation refusée » / « Reconnexion nécessaire » : retirez la connexion et reconnectez-vous.
• « Limite horaire atteinte » : la limite horaire de l'espace de travail a été atteinte. Elle est de 20 pour les suppressions et annulations, et de 100 pour les envois (comme les e-mails).
• « Champ obligatoire vide » : un champ obligatoire de l'étape, ou la variable qui le remplit, était vide.
• « La cible est une valeur saisie par le visiteur » : la cible d'une action irréversible ne peut pas être la réponse du visiteur ; choisissez la cible sur l'étape.
• « Aucun canal sélectionné » / « Aucune liste sélectionnée » : choisissez le canal ou la liste sur l'étape.