Documentation › Guides

Déclencheurs — démarrer des bots tout seuls

Un bot démarre à une heure, par un raccourci clavier, par un appel web, quand une fenêtre apparaît, quand un fichier change ou au démarrage — configuré en une minute avec l'assistant.

Dernière mise à jour: 2026-09-22

Jusqu'ici tu démarrais chaque bot toi-même : ouvrir le fichier, cliquer sur « Démarrer ». Les déclencheurs s'en chargent. Un déclencheur est une règle « quand X arrive, alors démarre le bot Y » — et le service de déclencheurs de FlowBotCommander veille dessus en arrière-plan.

Les déclencheurs sont nouveaux (bêta) depuis la version 1.6.0. L'essentiel fonctionne, mais des imperfections sont possibles. Si tu remarques quelque chose : Aide → Signaler un bug… — le journal est joint sur demande.

Ce qui peut déclencher

Type	Exemple
Horaire	faire les quêtes du jour chaque soir à 20:00 ; vérifier le courrier toutes les 30 minutes ; une fois samedi à 09:00
Raccourci clavier	appuyer sur Ctrl+F9 pendant que le jeu est au premier plan — le bot part
Appel web (webhook)	lancer le bot depuis le téléphone, une touche de Stream Deck ou Home Assistant
Une fenêtre apparaît	dès que la fenêtre du jeu s'affiche après le chargement, gérer la connexion
Changement de fichier	quand une nouvelle image arrive dans le dossier des captures, la trier
Démarrage de l'application	à chaque lancement de FlowBotCommander — avec « démarrer avec Windows », à la connexion

Étape 1 — Enregistrer le bot

Un déclencheur ne peut démarrer qu'un bot enregistré. Enregistre-le avec Fichier → Enregistrer — de préférence dans le dossier des bots que l'assistant affiche de lui-même (%AppData%\FlowBotCommander\bots). Tout autre .bot.json convient aussi ; choisis-le alors dans l'assistant via « Parcourir… ».

Étape 2 — Ouvrir l'assistant

Outils → Déclencheurs… (bêta), puis « Nouveau déclencheur… ». L'assistant compte quatre étapes :

Quel bot ? — choisir le bot enregistré ; un nom de déclencheur est proposé.
Quand doit-il démarrer ? — l'un des six types du tableau ci-dessus.
Détails — selon le type : heures, touche, titre de fenêtre, dossier…
Résumé — l'assistant vérifie tout et dit ce qui manque. « Terminer » crée le déclencheur.

En haut à droite se trouve le sélecteur Débutant / Avancé. En débutant, tu ne vois que l'essentiel. Avancé ajoute les jours de la semaine, les conditions (voir plus bas) et les détails des webhooks et fichiers. Les valeurs sont conservées quand tu changes de mode.

Étape 3 — Activer le service

Dans la fenêtre des déclencheurs (ou sous Outils → Paramètres → Service de déclencheurs), coche « Exécuter le service de déclencheurs tant que l'application est ouverte ». La ligne d'état passe à « Service : en marche ». Sans cette case, aucun déclencheur n'agit — volontairement, pour que rien que tu n'as pas activé ne puisse te surprendre.

Un bot a besoin de ton écran pour voir et de ta souris pour cliquer. C'est pourquoi le service de déclencheurs tourne dans l'application et non comme un service Windows invisible — un tel service n'aurait même pas accès à ton bureau. Les déclencheurs n'agissent donc que tant que FlowBotCommander est ouvert (réduit suffit).

Pour que ce soit la norme, il y a la seconde case : « Lancer FlowBotCommander avec Windows (réduit) ». L'application démarre alors en arrière-plan à la connexion et les déclencheurs sont armés aussitôt.

Les types en détail

Horaire

Chaque jour à heures fixes — plusieurs heures séparées par des virgules : 07:30, 20:00.
Toutes les N minutes — le premier démarrage arrive un intervalle après l'activation, pas tout de suite.
Une fois — une date avec une heure ; ensuite le déclencheur est terminé (il reste dans la liste mais n'agit plus).
Jours de la semaine (avancé) — aucune case cochée signifie « tous les jours ».

La liste de la fenêtre des déclencheurs montre le prochain démarrage prévu.

Raccourci clavier

Clique sur « Appuyer sur une touche… », puis appuie sur la touche (avec Ctrl/Alt/Maj si tu veux). « Est-il libre ? » vérifie si un autre programme tient déjà la combinaison — l'assistant te le dit au lieu de ne rien faire en silence.

Les touches F avec Ctrl ou Alt sont rarement prises par les jeux. La touche panique (par défaut : Pause) arrête toujours le bot — elle a toujours la priorité.

En mode débutant, un déclencheur par raccourci reçoit automatiquement un délai minimal de 2 secondes, pour qu'un double appui ne démarre pas le bot deux fois.

Appel web (webhook)

Le déclencheur reçoit un nom, par exemple soir-farm, et donc une adresse :

http://127.0.0.1:8766/hook/soir-farm?token=TON-JETON

Le jeton se trouve dans la fenêtre des déclencheurs sous « Récepteur webhook (avancé) » — avec un bouton « Copier ». Ouvre l'adresse (favori du navigateur, curl, Stream Deck « ouvrir un site », rest_command de Home Assistant) et le bot démarre. À la place de ?token=, l'en-tête Authorization: Bearer TON-JETON fonctionne aussi.

Le récepteur est activé pour toi à la création du premier déclencheur webhook. Par défaut il n'écoute que sur cet ordinateur. Si ton téléphone doit déclencher, coche « Accessible depuis d'autres appareils de mon réseau » dans la fenêtre des déclencheurs et utilise l'IP de ton ordinateur à la place de 127.0.0.1 (la fenêtre montre un exemple).

Avec cette case, toute personne de ton réseau qui connaît le jeton peut démarrer tes bots. Garde le jeton secret et génères-en un nouveau (« Nouveau ») en cas de doute. Windows peut demander une fois une autorisation de pare-feu. Le récepteur ne peut que déclencher — il ne lit rien et ne modifie rien.

Une fenêtre apparaît

Saisis le titre de la fenêtre ou choisis-le avec « Choisir la fenêtre… » dans la liste des fenêtres ouvertes. Le déclencheur agit quand une fenêtre correspondante apparaît — pas pour une fenêtre déjà ouverte au moment de l'activation. Avancé : décoche « Déclencher à chaque réapparition » si cela ne doit arriver qu'une fois par session.

Changement de fichier

Choisis le dossier, un motif de fichier (*.png, *.log, *.*) et si « créé », « modifié » ou les deux comptent. Une rafale de changements (Windows en signale volontiers plusieurs lors d'une copie) est fusionnée en un seul déclenchement. Avancé : inclure les sous-dossiers.

Démarrage de l'application

Rien à régler. Le bot démarre peu après l'ouverture de l'application, dès que les onglets sont en place.

Conditions (avancé)

Chaque déclencheur peut avoir des conditions vérifiées avant chaque démarrage :

Si un bot tourne déjà — « ignorer » (par défaut) ou « attendre, puis démarrer ». Deux bots en même temps se disputeraient la souris et le clavier ; un déclencheur ne démarre donc jamais par-dessus un bot en cours.
Délai minimal — secondes devant s'écouler entre deux démarrages.
Seulement si cette fenêtre est ouverte — par exemple seulement quand le jeu tourne.
Plage horaire — seulement entre 22:00 et 06:00 (peut passer minuit).

Ce que le déclencheur a décidé est écrit dans le journal du bot et dans le fichier journal — avec la raison : « démarré (horaire 20:00) », « ignoré — un bot tourne déjà », « hors de la plage horaire »…

Tester sans attendre

Sélectionne le déclencheur dans la fenêtre et appuie sur « Déclencher maintenant ». Cela passe outre l'horaire, la plage horaire et le délai minimal — mais pas un bot en cours d'exécution. En quelques secondes tu vois si le bon bot démarre dans le bon onglet.

Si ça ne marche pas

« Service : arrêté » dans la ligne d'état — la case « Exécuter le service de déclencheurs » manque.
Le raccourci ne fait rien — la fenêtre signale en bas « raccourcis pris par d'autres programmes ». Choisis une autre combinaison.
Le webhook ne répond pas — déplie « Récepteur webhook » : tourne-t-il ? Port pris ? Depuis un téléphone il faut la case réseau et l'IP de l'ordinateur.
Le bot démarre mais fait autre chose — le déclencheur charge exactement le fichier enregistré. Les modifications de l'éditeur doivent être enregistrées.
« démarrage impossible » — le fichier du bot a disparu ou été déplacé ; rechoisis-le dans l'assistant.

Pour aller plus loin

API de contrôle — quand un script ou une IA doit faire plus que démarrer
Notifications — être prévenu quand un bot lancé par un déclencheur a terminé