Эмодзи-капча

Подойдёт, если нужно защитить бота или Telegram-группу от ботов и спама капчей «нажми правильный эмодзи» — после /start в личке или при вступлении новых участников в группу.

Превью сценария

Капча после /startЗащита группы капчей

Обзор

Проверка «вы не робот» встроенным действием «Капча»: капча после /start в личке и защита группы, где новичок остаётся в муте, пока не нажмёт правильный эмодзи.

Для кого

Подойдёт, если нужно защитить бота или Telegram-группу от ботов и спама капчей «нажми правильный эмодзи» — после /start в личке или при вступлении новых участников в группу.

Что нужно для запуска

  • Капча нужна в личке после /start, при вступлении в группу или и там, и там?
  • Сколько попыток даётся до провала?
  • Что делать при провале: удалить из группы, замутить или просто пойти по ветке ошибки?
  • Для защиты группы: добавьте бота в группу админом с правом «Ограничение участников».
  • Опубликуйте сценарии и проверьте: /start в личке, затем вступление тестового аккаунта в группу.
  • Настройте действие под себя: число эмодзи, ширину сетки, попытки, лимит времени и действие при провале.

Разбор узлов

  • Срабатывает триггер: /start в личке или событие вступления в группу
  • Одно действие «Капча» (в блоке действий) делает всё само: отправляет «Нажми на ➡️ Яблоко» с перемешанной сеткой эмодзи, проверяет нажатие, показывает новую сетку при ошибке, считает попытки и применяет лимит времени
  • Групповые нюансы — это настройки действия, а не дополнительные блоки: мут на время проверки, удаление/мут при провале, очистка сообщения
  • Ветка успеха блока действий продолжает сценарий после прохождения (приветствие); ветка ошибки обрабатывает отклонённых

Подробности

Полезно знать

  • «Капча» — встроенный тип действия (как «Задержка» или «Установить переменную»). Разместите её в отдельном блоке действий; два пути блока задаются через create_link с conditionBranch: TRUE/без ветки = пройдена (успех), FALSE = не пройдена (ошибка). Не собирайте капчу из SET_VARIABLE/CONDITION/динамических кнопок.
  • Всё поведение — конфиг действия: optionsCount (4-9 эмодзи), buttonsPerRow (ширина сетки, по умолчанию 3), maxAttempts, timeoutSeconds (автопровал без ответа), failAction NONE/KICK/MUTE, muteWhileVerifying, deleteOnFinish и необязательный promptText.
  • Текст задания и названия эмодзи локализуются автоматически (русский/английский) по языку Telegram пользователя.
  • Для защиты группы бот должен быть админом с правом «Ограничение участников».
  • Ограничение группового варианта: контакт сценария — сама группа, поэтому одновременно может идти только одна капча на группу. Нажатия чужих участников действие игнорирует само. Для активных групп лучше капча в личке.

Что важно помнить

  • Не собирайте капчу из SET_VARIABLE/CONDITION/динамических кнопок — действие «Капча» само ведёт весь цикл «задание → проверка → повтор».
  • Не добавляйте отдельные блоки ограничения/снятия ограничений вокруг капчи — muteWhileVerifying и failAction уже это делают.
  • Не обещайте, что защита группы работает без прав администратора.