Реакции: основы
Как научить бота отвечать на команду, нажатие кнопки или другое событие. Создание реакции, порядок проверки и переходы между реакциями.
На этой странице
Реакция задаёт одно правило поведения бота. Например: «Когда человек напишет /price, отправить ему прайс». Или: «Когда оплатит заказ, поставить метку “Оплатил” и выдать доступ».
Настройте событие, дополнительные условия и действия в разделе Реакции. Бот проверяет правила сверху вниз и выполняет первое подходящее. Поэтому частные правила обычно ставят выше общего ответа на любое сообщение.
Из чего состоит реакция
Для примера с прайсом достаточно выбрать команду /price и добавить сообщение с ценами. Остальные настройки нужны, если правило должно работать только для определённых людей или чатов. У редактора четыре вкладки:
| Вкладка | На какой вопрос отвечает | Пример |
|---|---|---|
| Триггер | Когда запускать: текст, команда, медиа, кнопка, событие или расписание | Человек написал /price |
| В чатах | Где работает реакция: личный чат, обращение в группе, конкретные чаты; учитывает состояние пользователя | Только в личной переписке |
| Условия | Что дополнительно проверить: метки, параметры, время, число сообщений | У человека есть метка «Оплатил» |
| Действия | Что сделать: отправить сообщение, изменить метки, записать данные, вызвать ИИ | Отправить прайс |
Создание и редактирование
Нажмите Создать реакцию или откройте существующую. Вверху редактора задаются обязательное название, номер #N, описание и переключатель Активна. Слева выбирают разделы Триггер / В чатах / Условия / Действия, в центре заполняют форму. Справа показан предварительный просмотр сообщения в Telegram с блоками, кнопками и меню. Нажмите Сохранить.
У сохранённой реакции редактор показывает панель статистики: число срабатываний, график и последние события.
История изменений и восстановление
У сохранённой реакции откройте История изменений. Здесь видны последние 20 изменений, время, автор, источник правки и различия «Было / Стало». Можно вернуть состояние до выбранного изменения: сначала просмотрите различия, затем подтвердите восстановление.
Восстановление заменяет несохранённые правки и само записывается в историю. Оно возвращает настройки реакции, но не отменяет уже отправленные сообщения или изменения данных. Если после просмотра реакцию успел изменить другой участник, обновите различия.
Пошаговый разбор и упражнение.
Порядок и приоритет
Реакции в списке можно перетаскивать в ручном порядке без поиска, фильтров и выбранной папки: порядок определяет приоритет. На событие срабатывает первая подходящая реакция, после чего перебор останавливается. Чтобы продолжить перебор и дать сработать следующим подходящим реакциям, добавьте действие Следующая реакция (goto_next).
Поиск, фильтры и группировка
Над списком есть поиск по названию и номеру, а также фильтры:
- Состояние: все, только активные или только неактивные реакции.
- Создана от / до: календарные дни в вашем часовом поясе, оба дня включительно.
- Порядок: ручной (как при проверке ботом), сначала новые или сначала старые.
- Группировка: по дням или по месяцам создания. Группы работают только в порядке по дате. Если включить группировку при ручном порядке, список переключится на «Сначала новые»; уже выбранный порядок «Сначала новые» или «Сначала старые» сохранится. Выбор ручного порядка выключает группировку.
Фильтры применяются ко всем реакциям, а не только к открытой странице, и сочетаются с поиском и папками. Счётчик показывает, сколько реакций найдено. Состояние фильтров сохраняется в адресе страницы: его можно обновить, отправить ссылкой или вернуться к нему кнопкой «Назад». Сбросить фильтры очищает поиск, фильтры, порядок и группировку, но оставляет выбранную папку.
Фильтры и сортировка меняют только вид списка: порядок проверки реакций ботом остаётся прежним.
Включение и отключение
Переключатель в строке списка (или Активна в редакторе) включает и выключает реакцию, не удаляя её. Выключенные реакции в переборе пропускаются.
Дублирование и удаление
В строке списка есть кнопки Дублировать (создаёт копию) и Удалить. Дублирование удобно, когда нужно сделать похожую реакцию с небольшими отличиями.
Импорт и экспорт
Реакцию можно выгрузить в JSON (кнопка Экспорт в редакторе) и загрузить обратно (Импорт в списке). Это переносит реакцию между ботами и позволяет хранить версии вне платформы.
Рассылка реакции
Кнопка Рассылка в строке реакции (иконка «отправить») разошлёт эту реакцию всем активным подписчикам бота: удобно для анонсов и оповещений. Аудиторию можно сузить по меткам. Подробнее: Рассылки.
Цепочки и диалоги
Например, первая реакция показывает каталог, кнопка запускает вторую с карточкой товара, а та спрашивает адрес доставки. Переходы между реакциями настраиваются несколькими способами:
- Цепная реакция (
chain): действие, которое запускает другую реакцию по ходу выполнения. - Следующая реакция (
goto_next): передаёт управление следующей подходящей реакции в списке. - Шаги диалога: блок сообщения может ждать ответ пользователя (с проверкой формата), ставя сценарий на паузу. См. Сообщения и кнопки.
- Ветка «иначе»: если условия реакции не выполнились, можно запустить другую реакцию (поле в разделе «Условия»).
- Выбрать следующий шаг (
branch_result): обработать пустой, единственный, множественный или неполный результат поиска. - Выбрать шаг по значению (
branch_value): например, приupdatedподтвердить заявку, а приconflictпредложить перечитать её состояние. - Исход действия: перейти к отдельной реакции при успехе, конфликте, отсутствии записи или ошибке, если действие поддерживает такой исход. Как выбрать ветки.
- Вызвать блок (
call_block): передать входы в общий расчёт и получить объявленные выходы в текущую реакцию. Библиотека блоков и версии.
Для работы с данными можно собрать цепочку: Поиск по коллекции → Выбрать следующий шаг → кнопки → Найти связанные записи. Если список пришёл из внешнего сервиса, подойдут Обработать список → Группы и итоги. Укажите имя для сохранения результата каждого действия, затем выберите его в следующем действии.
Практические уроки по новым действиям показывают обе цепочки на примерах занятий и заявок.
При настройке выбирайте данные предыдущих шагов, чтобы не запоминать пути вручную. Перед сохранением проверьте текущий черновик на учебных данных: сравните ветки и предполагаемые сообщения. После сохранения отдельно пройдите пользовательский путь через подключённого бота и канал, где выполняются реальные действия.
Что дальше
- Триггеры: все типы срабатываний.
- Условия и чаты: фильтры и область действия.
- Действия: полный список действий.
- Сообщения и кнопки: конструктор ответов.