Документация › Руководства

Триггеры — боты запускаются сами

Бот стартует по времени, по сочетанию клавиш, по веб-вызову, при появлении окна, при изменении файла или при запуске — настраивается за минуту с помощью мастера.

Обновлено: 2026-09-22

До сих пор вы запускали каждого бота вручную: открыть файл, нажать «Старт». Триггеры избавляют от этого. Триггер — это правило «когда произойдёт X, тогда запусти бота Y», а служба триггеров внутри FlowBotCommander следит за этим в фоне.

Триггеры — новое (бета) с версии 1.6.0. Всё основное работает, но шероховатости возможны. Если что-то заметите: Справка → Сообщить об ошибке… — журнал при желании прикладывается.

Что может сработать как триггер

Тип	Пример
Расписание	каждый вечер в 20:00 выполнять ежедневки; каждые 30 минут проверять почту; один раз в субботу в 09:00
Горячая клавиша	нажать Ctrl+F9, пока игра на переднем плане — бот пошёл
Веб-вызов (вебхук)	запустить бота с телефона, кнопкой Stream Deck или из Home Assistant
Появляется окно	как только окно игры появилось после загрузки, взять на себя вход
Изменение файла	когда в папке скриншотов появляется новая картинка, разобрать её
Запуск приложения	при каждом старте FlowBotCommander — вместе с «запуском с Windows» это значит при входе в систему

Шаг 1 — Сохранить бота

Триггер может запустить только сохранённого бота. Сохраните его через Файл → Сохранить — лучше в папку ботов, которую мастер показывает сам (%AppData%\FlowBotCommander\bots). Любой другой .bot.json тоже подойдёт, тогда выберите его в мастере через «Обзор…».

Шаг 2 — Открыть мастер

Инструменты → Триггеры… (бета), затем «Новый триггер…». В мастере четыре шага:

Какой бот? — выбрать сохранённого бота; имя триггера предлагается автоматически.
Когда запускать? — один из шести типов из таблицы выше.
Детали — в зависимости от типа: время, клавиша, заголовок окна, папка…
Итог — мастер всё проверяет и говорит, чего не хватает. Кнопка «Готово» создаёт триггер.

Справа вверху переключатель Новичок / Продвинутый. В режиме новичка видно только необходимое. Продвинутый добавляет дни недели, условия (см. ниже) и тонкости вебхуков и файлов. При переключении значения сохраняются.

Шаг 3 — Включить службу

В окне триггеров (или в Инструменты → Настройки → Служба триггеров) поставьте галочку «Запускать службу триггеров, пока приложение открыто». Строка состояния меняется на «Служба: работает». Без этой галочки не сработает ни один триггер — намеренно, чтобы вас никогда не застало врасплох то, чего вы не включали.

Боту нужен ваш экран, чтобы видеть, и мышь, чтобы кликать. Поэтому служба триггеров работает внутри приложения, а не как невидимая служба Windows — такой службе доступ к рабочему столу вообще не разрешён. Значит, триггеры срабатывают, только пока FlowBotCommander открыт (свёрнутого достаточно).

Чтобы это стало нормой, есть вторая галочка: «Запускать FlowBotCommander вместе с Windows (свёрнутым)». Тогда приложение стартует в фоне при входе, и триггеры сразу готовы.

Типы подробно

Расписание

Ежедневно в заданное время — несколько значений через запятую: 07:30, 20:00.
Каждые N минут — первый запуск придёт через один интервал после включения, а не сразу.
Один раз — дата и время; после этого триггер исчерпан (остаётся в списке, но больше не срабатывает).
Дни недели (продвинутый) — ни одной галочки означает «каждый день».

Список в окне триггеров показывает следующий запланированный запуск.

Горячая клавиша

Нажмите «Нажать клавишу…», затем саму клавишу (при желании с Ctrl/Alt/Shift). Кнопка «Свободно?» проверяет, не занято ли сочетание другой программой — мастер скажет об этом, вместо того чтобы молча ничего не делать.

F-клавиши с Ctrl или Alt в играх заняты редко. Клавиша паники (по умолчанию Pause) по-прежнему останавливает бота — у неё всегда приоритет.

В режиме новичка триггер по клавише автоматически получает минимальный интервал 2 секунды, чтобы двойное нажатие не запустило бота дважды.

Веб-вызов (вебхук)

Триггер получает имя, например vecher-farm, а с ним адрес:

http://127.0.0.1:8766/hook/vecher-farm?token=ВАШ-ТОКЕН

Токен находится в окне триггеров в разделе «Приёмник вебхуков (продвинутый)» — там же кнопка «Копировать». Откройте адрес (закладка браузера, curl, Stream Deck «открыть сайт», rest_command в Home Assistant) — и бот запустится. Вместо ?token= подойдёт и заголовок Authorization: Bearer ВАШ-ТОКЕН.

Приёмник включается за вас при создании первого вебхук-триггера. По умолчанию он слушает только на этом компьютере. Если запускать должен телефон, поставьте в окне галочку «Доступен с других устройств моей сети» и используйте IP компьютера вместо 127.0.0.1 (окно показывает пример).

С этой галочкой любой в вашей сети, кто знает токен, сможет запускать ваших ботов. Храните токен в тайне и при сомнениях создайте новый («Новый»). Windows может один раз запросить разрешение брандмауэра. Приёмник умеет только запускать триггеры — он ничего не читает и не меняет.

Появляется окно

Введите заголовок окна или возьмите его кнопкой «Выбрать окно…» из списка открытых окон. Триггер срабатывает, когда подходящее окно появляется заново, — но не для окна, которое было открыто уже при включении. Продвинутый режим: снимите «Срабатывать при каждом появлении окна», если это должно случиться лишь раз за сеанс.

Изменение файла

Выберите папку, шаблон файла (*.png, *.log, *.*) и что считается: «создан», «изменён» или и то и другое. Серия изменений (Windows при копировании охотно сообщает о нескольких) объединяется в одно срабатывание. Продвинутый режим: включать подпапки.

Запуск приложения

Настраивать нечего. Бот стартует вскоре после запуска приложения, когда вкладки готовы.

Условия (продвинутый режим)

У каждого триггера могут быть условия, проверяемые перед каждым запуском:

Если бот уже работает — «пропустить» (по умолчанию) или «подождать и запустить». Два бота сразу дрались бы за мышь и клавиатуру, поэтому триггер никогда не запускается поверх работающего бота.
Минимальный интервал — секунды, которые должны пройти между двумя запусками.
Только если это окно открыто — например, только пока запущена игра.
Временное окно — только между 22:00 и 06:00 (может переходить через полночь).

Решение триггера попадает в журнал бота и в файл журнала — с причиной: «запущен (расписание 20:00)», «пропущено — бот уже работает», «вне временного окна»…

Проверка без ожидания

Выделите триггер в окне и нажмите «Сработать сейчас». Это обходит расписание, временное окно и минимальный интервал — но не работающего сейчас бота. За секунды видно, стартует ли нужный бот в нужной вкладке.

Если не получается

«Служба: выключена» в строке состояния — не стоит галочка «Запускать службу триггеров».
Клавиша ничего не делает — внизу окна сообщение «сочетания заняты другими программами». Выберите другое сочетание.
Вебхук не отвечает — разверните «Приёмник вебхуков»: работает ли он? Занят ли порт? С телефона нужны сетевая галочка и IP компьютера.
Бот стартует, но делает не то — триггер загружает именно сохранённый файл. Изменения в редакторе должны быть сохранены.
«не удалось запустить» — файл бота исчез или перемещён; выберите его в мастере заново.

Читать дальше

API управления — когда скрипт или ИИ должны уметь больше, чем просто запускать
Уведомления — получать сообщение, когда запущенный триггером бот закончил