Débogage avec les Exécutions de Flux de Travail
Utilisez l’interface Exécutions de Flux de Travail pour déboguer les problèmes :- Accédez via le panneau Exécutions dans l’éditeur de flux de travail
- Cliquez sur les exécutions individuelles pour voir les données d’entrée/sortie de chaque étape
- Vérifiez l’état d’exécution, les messages d’erreur, et le flux de données entre les étapes
Problèmes Courants et Solutions
Flux de Travail Ne Se Déclenchant Pas
Problème : Le flux de travail ne s’exécute pas comme prévu. Solutions :- Vérifiez que le flux de travail est Actif (pas en mode Brouillon)
- Vérifiez que la configuration de déclenchement correspond à votre structure de données
- Pour les déclencheurs d’enregistrement, assurez-vous que le bon objet et les bons champs sont sélectionnés
- Pour les déclencheurs Webhook, vérifiez l’URL et le format de données attendu
- Pour les déclencheurs planifiés, vérifiez la configuration de l’heure
Formulaires Inaccessibles
Problème : Les actions de formulaire sont difficiles à trouver ou à accéder dans les flux de travail automatisés.Les formulaires sont actuellement conçus uniquement pour les déclencheurs manuels. Pour les flux de travail avec d’autres déclencheurs (Enregistrement créé, mis à jour, etc.), les formulaires ne sont accessibles que via l’interface de l’exécution de flux de travail, ce qui n’est pas l’expérience utilisateur attendue. Un centre de notifications sera lancé en 2026 pour supporter correctement les formulaires dans les flux de travail automatisés.
Consommation Élevée de Crédits
Problème : Flux de travail consommant plus de crédits que prévu. Causes & Solutions Communes :- Appels API Inefficaces : Regroupez les appels API lorsque possible au lieu de requêtes individuelles
- Mauvaise Configuration de Déclencheur Manuel : Utilisez la disponibilité
En Masseplutôt queUniquepour traiter plusieurs enregistrements en une seule exécution de flux de travail - Filtres Manquants : Ajoutez une logique conditionnelle pour arrêter les flux de travail lorsque les critères ne sont pas remplis
- Étapes Inutiles : Supprimez les actions redondantes et optimisez la logique de flux de travail
- En Temps Réel vs. Planifié : Utilisez des flux de travail planifiés pour les processus non urgents
Limites de Flux de Travail Concurrent
Problème : Atteindre la limite de 100 flux de travail concurrents par espace de travail.Vous ne pouvez pas exécuter plus de 100 flux de travail en parallèle à tout moment par espace de travail.
- Utilisez la disponibilité
En Massepour les déclencheurs manuels pour traiter plusieurs enregistrements en une seule exécution - Mettez en place des délais entre les exécutions de flux de travail en utilisant des déclencheurs planifiés
- Optimisez les flux de travail pour qu’ils s’exécutent plus rapidement et réduisez le temps d’exécution simultanée
- Envisagez un traitement par lots pendant les heures creuses
Limitation du Taux d’API
Problème : Les appels API externes échouent en raison de limites de taux. Solutions :- Utilisez des flux de travail planifiés au lieu de déclencheurs en temps réel lorsque possible
- Mettez en place des délais entre les appels API dans les actions de Code
- Regroupez les requêtes API lorsque le service externe le permet
- Surveillez les exécutions de flux de travail pour les erreurs de limite de taux et ajustez les horaires
Problèmes d’Itérateur
Problème : Les actions d’itérateur ne fonctionnent pas comme prévu. Solutions :- Note : L’itérateur est actuellement en version bêta. Activez-le sous Paramètres → Releases → Lab
- Vérifiez que l’entrée est un tableau d’enregistrements à partir d’une étape précédente
- Assurez-vous que les actions dans l’itérateur sont correctement configurées
- Utilisez l’itérateur avec
Déclencheurs Manuels en Massepour des performances optimales
Permissions Manquantes
Problème : Impossible d’accéder à la section des flux de travail.Si vous ne voyez pas la section des flux de travail, c’est dû à un problème de permissions. Contactez votre administrateur d’espace de travail pour vous accorder l’accès aux flux de travail.
Conseils d’Optimisation
Meilleures Pratiques de Performance
- Commencez simple et ajoutez de la complexité progressivement
- Utilisez la disponibilité
En Massepour les déclencheurs manuels afin de traiter plusieurs enregistrements efficacement - Ajoutez des filtres tôt pour arrêter les flux de travail lorsque les critères ne sont pas remplis
- Regroupez les appels API et utilisez des flux de travail planifiés pour les processus non urgents
- Cachez les exécutions de flux de travail des pages affichant tous les flux de travail pour améliorer les performances de chargement
- Surveillez l’utilisation des crédits régulièrement dans Paramètres → Facturation
Prévention des Erreurs
- Testez en mode brouillon avant d’activer les flux de travail
- Validez les réponses API et implémentez des actions de repli
- Utilisez des noms d’étapes descriptifs pour un entretien plus facile
- Documentez la logique complexe pour les membres de l’équipe
Obtenir de l’Aide
Ressources en Libre-Service
- Consultez Caractéristiques du Flux de Travail pour les détails techniques
- Vérifiez Crédits de Flux de Travail pour des conseils d’optimisation
- Explorez Automatisations Internes et Intégration d’Outils Externes pour des exemples
Support Professionnel
- Contactez nos Services Professionnels pour un dépannage complexe
- Contactez le support via contact@twenty.com pour une assistance technique