Обработчики команд

Что это такое

Обработчики команд — это механизм, который позволяет боту реагировать на текстовые сообщения пользователей. Это самый популярный тип обработчиков, с которого обычно начинается знакомство с ботом (например, команда /start).

Telegram имеет встроенную поддержку команд — слов, начинающихся с символа /. Однако обработчики EnotPro позволяют работать не только с ними, но и с обычным текстом, и даже со сложными регулярными выражениями.

Доступные подтипы

Команда

Обработчик «Команда» срабатывает, когда пользователь отправляет сообщение, начинающееся с символа /.

Особенности работы в группах

В групповых чатах Telegram ведёт себя особенным образом:

• Пользователь может отправить команду с упоминанием бота: /start@MyBot
• Telegram автоматически удаляет упоминание из текста перед передачей боту
• В переменной ${update.message.text} вы получите чистую команду: /start

💡 Что это даёт: вам не нужно прописывать варианты с упоминанием — бот сам их обработает.

Примеры команд

Настройка

Пример использования

Задача: приветствовать пользователя при запуске бота

1. Тип обработчика: Команда
2. Команда: /start
3. Реакция: SendMessage → «Привет, ${user.name}! Я бот-помощник.»

Текст

Обработчик «Текст» срабатывает на любое текстовое сообщение (кроме команд, начинающихся с /). Если вы хотите, чтобы бот отвечал на определённые фразы («Привет», «Пока», «Спасибо») — используйте этот тип.

⚠️ Внимание:

• Обработчики типа «Текст» не срабатывают на команды (начинающиеся с /). Для команд используйте отдельный подтип.
• Если вам нужно, чтобы обработчик срабатывал и на команды, и на текст — используйте «Регулярное выражение» с соответствующим шаблоном.

Примеры текстов

Настройка

Пример использования

Задача: бот отвечает «И тебе привет!» на любое приветствие

• Тип обработчика: Текст
• Команда: привет
• Игнорировать регистр: ✅
• Реакция: SendMessage → «И тебе привет!»

Примечание: обработчик сработает только на точное слово «привет». На фразу «Привет, как дела?» — нет, так как там есть дополнительные слова. Для таких случаев используйте «Регулярное выражение».

Регулярное выражение

Описание

Обработчик «Регулярное выражение» срабатывает, когда текст сообщения соответствует заданному шаблону. Это самый гибкий, но и самый сложный подтип.

Когда использовать

• Текст может меняться, но содержит определённую структуру (номер заказа, email, телефон)
• Нужно извлечь часть сообщения (например, цифры из фразы «Мой возраст 25 лет»)
• Фраза может быть в разных падежах или с дополнительными словами (например, «привет» и «привет, как дела»)

Правила составления

💡 Совет: Если вам нужно очень длинное выражение (например, для сложной валидации), разбейте его на несколько последовательных обработчиков или используйте макрос !{regex.match} внутри общего триггера.

Примеры регулярных выражений

Извлечение данных (группы)

Если в регулярном выражении есть группы ( ), вы можете использовать их в реакциях.

Пример: обработчик на Мой возраст (\d+)

• Пользователь пишет: «Мой возраст 25»
• В переменной ${update.match.1} будет значение 25

Доступные переменные:

Настройка

Пример использования

Задача: бот извлекает номер заказа и отвечает «Ваш заказ №12345678 принят»

Тест: пользователь пишет «Заказ №12345678» → бот отвечает «Ваш заказ №12345678 принят»

Настройки, общие для всех подтипов

Для всех обработчиков команд доступны следующие настройки (расположены в интерфейсе ниже поля ввода условия):

Ограничения и важные замечания

Частые ошибки и их решение

Примеры готовых обработчиков

Пример 1: команда /start

Тип: Команда
Условие: /start
Приоритет: 100 (самый высокий)
Реакции:
  - SendMessage: «Привет! Я бот. Напиши /help для списка команд.»
  - SetVarCloud: started = true

Пример 2: текст «спасибо»

Тип: Текст
Условие: спасибо
Игнорировать регистр: ✅
Приоритет: 0
Реакции:
  - SendMessage: «Пожалуйста! Всегда рад помочь.»

Пример 3: извлечение номера телефона

Тип: Регулярное выражение
Условие: (\+7|8)?\s*\(?\d{3}\)?\s*\d{3}[-]?\d{2}[-]?\d{2}
Приоритет: 0
Реакции:
  - SendMessage: «Вы отправили номер: ${update.match.0}»
  - SetVarCloud: phone = ${update.match.0}

Пример 4: извлечение возраста

Тип: Регулярное выражение
Условие: (?:мне |возраст |лет )?(\d{1,3})(?:\s*лет)?
Приоритет: 0
Реакции:
  - SendMessage: «Ваш возраст: ${update.match.1}»
  - SetVarCloud: age = ${update.match.1}

Как это работает на разных фразах:

• «Мне 25 лет» → 25
• «возраст 30» → 30
• «42» → 42

Резюме

💡 Совет: Если вы только начинаете — используйте Команды и Текст. Регулярные выражения подключайте по мере усложнения логики бота.

🔗 Связанные разделы

• Обработчики вложений — для работы с фото, видео, документами
• Обработчики системных сообщений — для отслеживания событий в чатах
• Макрос regex — для работы с регулярными выражениями внутри реакций