# Configurer des workflows

Découvrez comment configurer des workflows dans le Dashboard.

Créez un workflow pour automatiser une tâche. Vous pouvez déclencher des workflows à partir d’événements Stripe, les exécuter selon une planification récurrente ou les lancer à la demande depuis le Dashboard ou via l’API.

## Before you begin

- Vous pouvez exécuter jusqu’à 50 flux de travail actifs à la fois.
- Créez un [environnement de test](https://docs.stripe.com/sandboxes.md) pour tester, créer et exécuter des workflows. Vous pouvez ainsi expérimenter de nouvelles fonctionnalités, dépanner et résoudre les problèmes sans affecter les opérations en production.
- Assurez-vous de bien comprendre le [mode de fonctionnement de Workflows](https://docs.stripe.com/workflows/define-workflows.md).

## Créer un workflow

1. Accédez à [Workflows](https://dashboard.stripe.com/workflows) dans le Dashboard.
2. Cliquez sur **Nouveau workflow** pour ouvrir le générateur de workflows.
3. Cliquez sur **Workflow sans titre** et saisissez un nom de workflow.
4. Cliquez sur **Ajouter un déclencheur**.
   - Chaque workflow ne peut avoir qu’un seul déclencheur.
   - Un [déclencheur](https://docs.stripe.com/workflows/triggers.md) lance votre workflow. Vous pouvez utiliser un événement Stripe, une planification récurrente ou un déclencheur à la demande que vous lancez depuis le Dashboard ou via l’API. Consultez la section [Types de déclencheurs](https://docs.stripe.com/workflows/triggers.md#trigger-types).
   - Sélectionnez l’un des déclencheurs suggérés. Vous pouvez effectuer une recherche ou parcourir les catégories.
5. Si vous choisissez un déclencheur d’événements, vous pouvez préciser quand vous souhaitez que votre workflow s’exécute en ajoutant une [condition de déclenchement](https://docs.stripe.com/workflows/define-workflows.md#trigger-conditions).
   - Les conditions sous forme de liste évaluent jusqu’à 100 éléments. Par exemple, lors de la configuration de conditions sur un champ contenant une liste d’éléments, le workflow n’évalue que les 100 premiers éléments pour déterminer si la condition est remplie. Nous n’évaluons pas les éléments au-delà de la limite.
   - Votre workflow ne s’exécute que si les conditions de déclenchement sont remplies.
6. Cliquez sur **Ajouter une étape**. Vous pouvez sélectionner une [action](https://docs.stripe.com/workflows/define-workflows.md#actions), une [condition](https://docs.stripe.com/workflows/define-workflows.md#conditions) ou une [boucle](https://docs.stripe.com/workflows/loops.md).
   - Les valeurs dynamiques sont extraites d’une étape spécifique, qui peut devenir obsolète si l’objet change après l’exécution de cette étape ou le déclenchement d’un événement. Cependant, chaque action s’exécute sur la version actuelle et la plus récente de l’objet.
7. Ensuite, configurez l’action en ajoutant des valeurs aux paramètres. Vous devez remplir tous les champs obligatoires pour que le workflow puisse s’exécuter. Ces propriétés sont marquées comme **Obligatoires**.
8. Ajoutez des étapes supplémentaires, le cas échéant.
9. Cliquez sur **Publier**.

### Sélectionnez une source d’événement (plateformes Connect)

Si vous utilisez une plateforme Connect, vous verrez une option supplémentaire lors de la configuration de votre déclencheur : **Surveillance du déclencheur activée**. Cette option permet de déterminer quels événements du compte déclenchent le workflow.

- **Votre compte** : le workflow se déclenche lors d’événements provenant de votre compte de plateforme (par défaut).
- **Compte connecté** : le workflow se déclenche lors d’événements provenant de n’importe lequel de vos comptes connectés.

Sélectionnez la source d’événements qui correspond à votre cas d’usage. Vous ne pouvez pas en sélectionner deux. Un workflow ne surveille qu’une seule source d’événements.

Vous pouvez aussi configurer des actions individuelles à exécuter sur le compte connecté ou sur votre compte de plateforme. Consultez [Actions sur les comptes connectés](https://docs.stripe.com/workflows/define-workflows.md#actions-on-connected-accounts) pour plus de détails.

Pour des exemples de workflows que vous pouvez créer, consultez [Cas d’usage](https://docs.stripe.com/workflows/use-cases.md).

## Tester un workflow

Après avoir enregistré et activé votre workflow, testez-le. Vous devez tester le déclencheur, les conditions de déclenchement (le cas échéant) et les étapes séquentielles que vous avez appliquées.

Par exemple, pour tester un workflow qui se déclenche dès qu’un nouveau client est créé :

1. Créez un [environnement de test](https://docs.stripe.com/sandboxes.md) pour tester votre workflow en toute sécurité sans affecter votre compte en mode production.
2. Dans le Dashboard, accédez à la page [Clients](https://dashboard.stripe.com/customers).
3. Cliquez sur **+ Nouveau client**.
4. Saisissez les informations du client et vérifiez que le nom commence par le prénom du client (par exemple, « Jean »).
5. Cliquez sur **Ajouter un client**.

### Tester avec des comptes connectés

Pour tester un workflow qui se déclenche lors d’événements de compte connectés :

1. Utilisez un environnement de test avec au moins un compte connecté.
2. Créez ou simulez un événement sur le compte connecté qui correspond à votre déclencheur. Par exemple, si votre workflow se déclenche sur `payment_intent.succeeded`, créez un paiement de test sur un compte connecté.
3. Confirmez que l’exécution du workflow apparaît dans **l’historique d’exécution**. Les détails de l’exécution indiquent quel compte connecté a déclenché l’exécution.

Si vous n’avez pas de comptes connectés dans votre environnement de test, commencez par créer des comptes connectés de test. Consultez [Intégrations de test pour Connect](https://docs.stripe.com/connect/testing.md) pour obtenir des instructions.

> Les actions effectuées sur des comptes connectés peuvent échouer si le compte ne dispose pas des autorisations requises. Consultez les détails d’exécution pour rechercher la cause des erreurs d’autorisation.

## Observer un workflow

Après avoir déclenché le workflow, vérifiez ses détails d’exécution :

1. Accédez à [Workflows](https://dashboard.stripe.com/workflows) dans le Dashboard.

2. Cliquez sur le workflow correspondant.

3. sous **Exécutions récentes**, affichez l’entrée d’exécution la plus récente qui représente le workflow de test que vous avez créé et déclenché.

   - Si le workflow s’est exécuté correctement, l’état affiche un badge **Réussi**.
   - En cas d’échec du workflow, l’état affiche un badge **Échec**.

4. Cliquez sur l’exécution pour afficher les détails de chaque étape exécutée par le workflow. Si vous cliquez sur une étape, vous pouvez également cliquer sur **Inspecter dans Workbench** pour afficher les logs [Workbench](https://docs.stripe.com/workbench.md) destinés aux développeurs et générés à partir des actions effectuées dans le workflow.

   - Workbench est disponible pour les événements déclencheurs, qui vous permettent d’accéder directement à l’onglet Événement dans Workbench, et pour les actions dans lesquelles vous pouvez accéder au log des requêtes correspondant.
   - Cette option n’est pas disponible pour les étapes spécifiques aux workflows, telles que l’envoi d’e-mails ou l’évaluation des conditions, y compris la création de branches.

5. Dans la vue **Historique d’exécution**, cliquez sur le menu de dépassement (⋯) > **Inspecter la ressource** pour explorer une vue JSON de l’objet qui a déclenché le flux de travail à l’aide de [Workbench](https://docs.stripe.com/workbench/overview.md#inspector).

### Échec des workflows

En cas d’échec du workflow :

1. Dans la vue **Historique des exécutions**, cliquez sur les étapes qui n’ont pas affiché le message d’erreur.
2. Utilisez les messages d’erreur pour corriger les étapes. Vous pouvez également cliquer sur **Consulter dans Workbench** pour afficher les logs [Workbench](https://docs.stripe.com/workbench.md) destinés aux développeurs et générés par le workflow.
3. Après avoir résolu le problème, créez une nouvelle exécution du workflow pour confirmer la résolution du problème.
![Vue de Workbench à l'aide de workflows](https://b.stripecdn.com/docs-statics-srv/assets/workbench.d7d4401e2bd1fcd3e0884433acbf33a2.png)

Vue de Workbench à l’aide de workflows

### Surveillez les exécutions à l’aide d’événements webhook

Stripe émet des événements webhook lorsque l’état d’exécution d’un workflow change. Vous pouvez écouter ces événements pour déclencher des actions en aval ou suivre les résultats d’exécution sans interrogation régulière. Ces événements sont déclenchés pour toutes les exécutions de workflows, y compris celles déclenchées par un événement, les exécutions planifiées et les exécutions à la demande.

| **Événement** | **Se déclenche lorsque** | **Remarques** |
| --- | --- | --- |
| `v2.extend.workflow_run.started` | Une exécution de workflow commence à s’exécuter | Se déclenche pour toutes les exécutions de workflows. |
| `v2.extend.workflow_run.succeeded` | L’exécution d’un workflow a réussi | Les valeurs de sortie ne sont pas comprises (elles peuvent contenir des informations personnelles identifiables). |
| `v2.extend.workflow_run.failed` | L’exécution d’un workflow a échoué | Le modèle Pull comprend les détails de l’échec (`error_message`, `dashboard_url`). Le modèle Push omet les détails de l’erreur (risque lié aux informations personnelles identifiables). |

## Désactiver un workflow

Vous avez la possibilité d’activer, de désactiver ou de supprimer des workflows. Une fois que vous avez désactivé un workflow, Stripe le considère comme inactif et ne répond plus aux déclencheurs.

Vous pouvez maintenir jusqu’à 50 flux de travail actifs à la fois et avoir un total combiné de 50 flux de travail actifs et inactifs. Si vous avez 50 flux de travail, vous ne pouvez pas en créer un autre. Si vous avez 50 flux de travail actifs et souhaitez en activer un nouveau, vous devez d’abord désactiver un flux de travail actuellement actif.

Pour désactiver un workflow :

1. Accédez à [Workflows](https://dashboard.stripe.com/workflows), et sélectionnez le workflow pertinent.
2. cliquez sur **Désactiver**. Si vous souhaitez réactiver le workflow, cliquez sur **Activer**.

### Supprimer un workflow

la suppression d’un workflow est définitive. Après sa suppression, le workflow est irrécupérable. Avant de supprimer un workflow, assurez-vous de vouloir vraiment exécuter cette action. En cas de doute, vous pouvez le désactiver au lieu de le supprimer.

Pour supprimer un workflow :

1. Accédez à [Workflows](https://dashboard.stripe.com/workflows), et sélectionnez le workflow pertinent.
2. À côté de **Désactiver**, cliquez sur le menu déroulant (⋯) > **Supprimer le workflow**.
3. Cliquez sur **Supprimer** dans la fenêtre modale.

Le workflow est désormais définitivement supprimé, ainsi que ses informations d’exécution.

## Optional: Afficher les versions antérieures

Toutes les versions précédemment activées d’un flux sont accessibles directement dans l’éditeur de flux :

1. Ouvrez le flux dans l’éditeur.
2. Cliquez sur le menu déroulant des versions à côté du nom du flux.
3. Sélectionnez n’importe quelle version précédente pour voir sa configuration complète dans le canevas.

Cela vous permet de visualiser la configuration d’un flux à tout moment de son historique. Elle facilite la compréhension des modifications et le débogage des exécutions précédentes.

## See also

- [Workflows](https://docs.stripe.com/workflows/define-workflows.md)
- [Cas d’usage](https://docs.stripe.com/workflows/use-cases.md)
- [Itérer sur des collections](https://docs.stripe.com/workflows/loops.md)
- [Créer des actions personnalisées](https://docs.stripe.com/workflows/custom-actions.md)
- [Déclencheurs](https://docs.stripe.com/workflows/triggers.md)