База знаний GetMyBot

Реакции: основы

Как научить бота отвечать на команду, нажатие кнопки или другое событие. Создание реакции, порядок проверки и переходы между реакциями.

На этой странице

Реакция задаёт одно правило поведения бота. Например: «Когда человек напишет /price, отправить ему прайс». Или: «Когда оплатит заказ, поставить метку “Оплатил” и выдать доступ».

Настройте событие, дополнительные условия и действия в разделе Реакции. Бот проверяет правила сверху вниз и выполняет первое подходящее. Поэтому частные правила обычно ставят выше общего ответа на любое сообщение.

Из чего состоит реакция

Для примера с прайсом достаточно выбрать команду /price и добавить сообщение с ценами. Остальные настройки нужны, если правило должно работать только для определённых людей или чатов. У редактора четыре вкладки:

ВкладкаНа какой вопрос отвечаетПример
ТриггерКогда запускать: текст, команда, медиа, кнопка, событие или расписаниеЧеловек написал /price
В чатахГде работает реакция: личный чат, обращение в группе, конкретные чаты; учитывает состояние пользователяТолько в личной переписке
УсловияЧто дополнительно проверить: метки, параметры, время, число сообщенийУ человека есть метка «Оплатил»
ДействияЧто сделать: отправить сообщение, изменить метки, записать данные, вызвать ИИОтправить прайс

Создание и редактирование

Нажмите Создать реакцию или откройте существующую. Вверху редактора задаются обязательное название, номер #N, описание и переключатель Активна. Слева выбирают разделы Триггер / В чатах / Условия / Действия, в центре заполняют форму. Справа показан предварительный просмотр сообщения в Telegram с блоками, кнопками и меню. Нажмите Сохранить.

У сохранённой реакции редактор показывает панель статистики: число срабатываний, график и последние события.

История изменений и восстановление

У сохранённой реакции откройте История изменений. Здесь видны последние 20 изменений, время, автор, источник правки и различия «Было / Стало». Можно вернуть состояние до выбранного изменения: сначала просмотрите различия, затем подтвердите восстановление.

Восстановление заменяет несохранённые правки и само записывается в историю. Оно возвращает настройки реакции, но не отменяет уже отправленные сообщения или изменения данных. Если после просмотра реакцию успел изменить другой участник, обновите различия.

Пошаговый разбор и упражнение.

Порядок и приоритет

Реакции в списке можно перетаскивать в ручном порядке без поиска, фильтров и выбранной папки: порядок определяет приоритет. На событие срабатывает первая подходящая реакция, после чего перебор останавливается. Чтобы продолжить перебор и дать сработать следующим подходящим реакциям, добавьте действие Следующая реакция (goto_next).

Поиск, фильтры и группировка

Над списком есть поиск по названию и номеру, а также фильтры:

  • Состояние: все, только активные или только неактивные реакции.
  • Создана от / до: календарные дни в вашем часовом поясе, оба дня включительно.
  • Порядок: ручной (как при проверке ботом), сначала новые или сначала старые.
  • Группировка: по дням или по месяцам создания. Группы работают только в порядке по дате. Если включить группировку при ручном порядке, список переключится на «Сначала новые»; уже выбранный порядок «Сначала новые» или «Сначала старые» сохранится. Выбор ручного порядка выключает группировку.

Фильтры применяются ко всем реакциям, а не только к открытой странице, и сочетаются с поиском и папками. Счётчик показывает, сколько реакций найдено. Состояние фильтров сохраняется в адресе страницы: его можно обновить, отправить ссылкой или вернуться к нему кнопкой «Назад». Сбросить фильтры очищает поиск, фильтры, порядок и группировку, но оставляет выбранную папку.

Фильтры и сортировка меняют только вид списка: порядок проверки реакций ботом остаётся прежним.

Включение и отключение

Переключатель в строке списка (или Активна в редакторе) включает и выключает реакцию, не удаляя её. Выключенные реакции в переборе пропускаются.

Дублирование и удаление

В строке списка есть кнопки Дублировать (создаёт копию) и Удалить. Дублирование удобно, когда нужно сделать похожую реакцию с небольшими отличиями.

Импорт и экспорт

Реакцию можно выгрузить в JSON (кнопка Экспорт в редакторе) и загрузить обратно (Импорт в списке). Это переносит реакцию между ботами и позволяет хранить версии вне платформы.

Рассылка реакции

Кнопка Рассылка в строке реакции (иконка «отправить») разошлёт эту реакцию всем активным подписчикам бота: удобно для анонсов и оповещений. Аудиторию можно сузить по меткам. Подробнее: Рассылки.

Цепочки и диалоги

Например, первая реакция показывает каталог, кнопка запускает вторую с карточкой товара, а та спрашивает адрес доставки. Переходы между реакциями настраиваются несколькими способами:

  • Цепная реакция (chain): действие, которое запускает другую реакцию по ходу выполнения.
  • Следующая реакция (goto_next): передаёт управление следующей подходящей реакции в списке.
  • Шаги диалога: блок сообщения может ждать ответ пользователя (с проверкой формата), ставя сценарий на паузу. См. Сообщения и кнопки.
  • Ветка «иначе»: если условия реакции не выполнились, можно запустить другую реакцию (поле в разделе «Условия»).
  • Выбрать следующий шаг (branch_result): обработать пустой, единственный, множественный или неполный результат поиска.
  • Выбрать шаг по значению (branch_value): например, при updated подтвердить заявку, а при conflict предложить перечитать её состояние.
  • Исход действия: перейти к отдельной реакции при успехе, конфликте, отсутствии записи или ошибке, если действие поддерживает такой исход. Как выбрать ветки.
  • Вызвать блок (call_block): передать входы в общий расчёт и получить объявленные выходы в текущую реакцию. Библиотека блоков и версии.

Для работы с данными можно собрать цепочку: Поиск по коллекции → Выбрать следующий шаг → кнопки → Найти связанные записи. Если список пришёл из внешнего сервиса, подойдут Обработать список → Группы и итоги. Укажите имя для сохранения результата каждого действия, затем выберите его в следующем действии.

Практические уроки по новым действиям показывают обе цепочки на примерах занятий и заявок.

При настройке выбирайте данные предыдущих шагов, чтобы не запоминать пути вручную. Перед сохранением проверьте текущий черновик на учебных данных: сравните ветки и предполагаемые сообщения. После сохранения отдельно пройдите пользовательский путь через подключённого бота и канал, где выполняются реальные действия.

Что дальше