twenty/packages/twenty-docs/fr/user-guide/workflows/workflow-troubleshooting.mdx

---
title: Dépannage du Flux de Travail
info: Déboguez et optimisez vos flux de travail avec des techniques de dépannage et des conseils d'optimisation des performances.
image: /images/user-guide/what-is-twenty/20.png
sectionInfo: Automatisez les processus et intégrez avec des outils externes
---

<Frame>
  <img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
</Frame>

## 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.

<Warning>
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.
</Warning>

**Solution de contournement** : Utilisez des déclencheurs manuels lorsque des formulaires sont nécessaires, ou restructurez les flux de travail pour éviter les formulaires dans les flux 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 Masse` plutôt que `Unique` pour 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.

<Warning>Vous ne pouvez pas exécuter plus de 100 flux de travail en parallèle à tout moment par espace de travail.</Warning>

**Solutions** :

- Utilisez la disponibilité `En Masse` pour 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 Masse` pour des performances optimales

### Permissions Manquantes

**Problème** : Impossible d'accéder à la section des flux de travail.

<Warning>
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.
</Warning>

## Conseils d'Optimisation

### Meilleures Pratiques de Performance

- **Commencez simple** et ajoutez de la complexité progressivement
- **Utilisez la disponibilité `En Masse`** pour 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](/user-guide/workflows/workflow-features) pour les détails techniques
- Vérifiez [Crédits de Flux de Travail](/user-guide/workflows/workflow-credits) pour des conseils d'optimisation
- Explorez [Automatisations Internes](/user-guide/workflows/internal-automations) et [Intégration d'Outils Externes](/user-guide/workflows/external-tool-integration) pour des exemples

### Support Professionnel

- Contactez nos [Services Professionnels](/user-guide/workflows/professional-services) pour un dépannage complexe
- Contactez le support via contact@twenty.com pour une assistance technique