> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alyzai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Choisir un déclencheur

> Comprendre les déclencheurs manuels, planifiés et événementiels d’une automatisation.

> [!NOTE]
>
> Concept · 7 min

Le déclencheur définit **quand** un workflow démarre et quelles données sont disponibles pour sa première étape. Choisissez-le avant de détailler les nœuds : il structure les entrées et la façon de tester le processus.

Un déclencheur ne décrit pas uniquement une fréquence. Il définit aussi l’identité de l’événement,
les valeurs transmises, les filtres appliqués et le comportement attendu si le même événement se
présente à nouveau.

## Les trois familles

| Type | À utiliser lorsque… | Point d’attention |
| - | - | - |
| **Manuel** | une personne décide quand lancer le processus | définir les données demandées et les droits du lanceur |
| **Planifié** | le processus suit une fréquence connue | vérifier le fuseau horaire, la première échéance et les retards |
| **Événementiel** | une action dans Alyzai ou un outil connecté doit démarrer le workflow | filtrer les événements et contrôler les doublons |

## Choisir le bon déclencheur

**1. Décrivez l’événement de départ**

Écrivez une phrase sans solution technique : « chaque lundi matin », « lorsqu’une réponse
est reçue » ou « quand un utilisateur le demande ».

**2. Listez les données nécessaires**

Identifiez les valeurs indispensables à la première étape. Elles devront être saisies,
fournies par l’événement ou retrouvées dans une source. Séparez les identifiants techniques
des libellés destinés à l’utilisateur.

**3. Prévoyez les doublons**

Décidez ce qui doit se passer si le même événement arrive deux fois ou si un lancement
manuel est répété. Utilisez un identifiant stable ou une vérification d’existence lorsque
l’action finale ne doit se produire qu’une fois.

**4. Testez avec un exemple maîtrisé**

Utilisez une donnée non sensible et facile à reconnaître dans l’historique. Pour un
planning, testez d’abord le workflow manuellement lorsque l’éditeur le permet, puis observez
une seule échéance contrôlée.

> [!TIP]
>
> **Exemple métier.** « À chaque nouvelle réclamation » est un déclencheur événementiel ; «
> produire la synthèse le vendredi à 16 h » est planifié ; « relancer ce dossier maintenant »
> reste manuel.

## Limites

Un workflow déployé ne peut réagir qu’aux événements et connexions réellement disponibles dans le
workspace. Si une source externe n’expose pas l’événement nécessaire, utilisez un lancement
planifié qui recherche les nouveaux éléments.

* Un événement reçu ne garantit pas que toutes les données nécessaires soient présentes.
* Une connexion expirée peut empêcher la réception ou la lecture des données.
* Une fréquence trop courte peut lancer une nouvelle exécution avant la fin de la précédente.
* Le fuseau horaire du planning doit être explicite pour les changements d’heure et les équipes
  réparties.
* Désactiver ou modifier un déclencheur ne répare pas les exécutions déjà lancées.

## Vérifications avant déploiement

1. Le déclencheur correspond à une phrase métier sans ambiguïté.
2. L’entrée de test contient les mêmes champs qu’une entrée réelle.
3. Les événements non pertinents sont filtrés.
4. Le comportement en cas de doublon est défini.
5. Le volume possible et les effets externes ont été estimés.
6. L’historique permettra d’identifier le type de lancement et la version.

## Questions fréquentes

> [accordion] Manuel ou planifié pour un premier workflow ?
>
> Commencez manuellement pour contrôler les entrées et les effets, puis ajoutez un planning
> après validation du parcours.

> [accordion] Que faire si aucun événement compatible n’est proposé ?
>
> Vérifiez le connecteur disponible. À défaut, planifiez une recherche des nouveaux éléments
> en conservant un identifiant de dernier traitement.

> [accordion] Peut-on changer le déclencheur après le déploiement ?
>
> Oui dans un nouveau brouillon, mais il faut retester les entrées, doublons et volumes avant
> de déployer la version suivante.

## Étape suivante

> [card] [Utiliser les nœuds et variables](https://docs.alyzai.com/fr/automatisations/noeuds-et-variables.md)
>
> Transformer les données du déclencheur en étapes observables.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.