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

Реакция — главный строительный блок бота: правило, которое описывает когда сработать, при каких условиях и что сделать. Бот — это упорядоченный список реакций; на каждое входящее событие платформа идёт по списку сверху вниз и применяет первую подходящую реакцию. Раздел — Реакции в меню слева.

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

У реакции четыре части (вкладки редактора):

  • Триггер — событие, на которое реакция откликается: текст, команда, медиа, нажатие кнопки, системное событие, расписание и т. д. См. Триггеры.
  • В чатах — где реакция работает: личный чат, группы при обращении к боту, конкретные чаты; плюс фильтры по состоянию пользователя.
  • Условия — дополнительные фильтры (метки, параметры, время, число сообщений и др.). См. Условия и чаты.
  • Действия — что бот делает при срабатывании: отправляет сообщение, ставит метки, пишет в коллекцию, вызывает ИИ и т. д. См. Действия.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Из нескольких реакций собираются сценарии:

  • Цепная реакция (chain) — действие, которое запускает другую реакцию по ходу выполнения.
  • Следующая реакция (goto_next) — передаёт управление следующей подходящей реакции в списке.
  • Шаги диалога — блок сообщения может ждать ответ пользователя (с проверкой формата), ставя сценарий на паузу. См. Сообщения и кнопки.
  • Ветка «иначе» — если условия реакции не выполнились, можно запустить другую реакцию (поле в разделе «Условия»).

Что дальше