Превью сценария
Капча после /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 уже это делают.
- Не обещайте, что защита группы работает без прав администратора.
