01Что это
Спам-боты любят открытые каналы и группы. Когда они уже внутри, их приходится искать и удалять вручную.
Заявки на вступление останавливают их на входе. Когда человек просится в чат, Telegram не впускает его сразу, а создаёт заявку. Бот пишет этому человеку в личный чат — ещё до того, как он стал участником.
Чаще всего так проверяют эмодзи-капчей:
- Человек нажал нужный эмодзи — бот одобряет заявку, и человек внутри.
- Человек ошибся или не ответил — бот отклоняет заявку.
Живые люди входят за несколько секунд. Боты ваш чат так и не увидят.
Работает и для каналов, и для групп.
02Что нужно настроить в Telegram
До того как собирать сценарий, настройте в Telegram две вещи:
- Сделайте бота администратором канала или группы с правом добавлять участников (приглашать пользователей).
- Включите одобрение заявок. Включите для чата «Одобрять новых участников» или раздавайте ссылку-приглашение, для которой включено одобрение администратором.
Без одобрения люди вступают сразу, и проверять нечего.
03Как включить
- Откройте сценарий, который будет проверять новичков.
- Нажмите на блок Стартовый шаг, затем Добавить триггер.
- В поле Тип выберите Заявка на вступление (канал или группа).
Этот же триггер есть в модуле Telegram, в группе Установленные модули: Telegram — заявка на вступление. Подойдёт любой из двух.
Теперь каждая новая заявка в чат, где бот — администратор, запускает этот сценарий. Сценарий идёт в личном чате с тем, кто подал заявку.
Telegram разрешает писать ему 5 минут после заявки или пока заявка не обработана. Поэтому проверка должна быть короткой.
04Как собрать проверку: капча, затем одобрение или отказ
Обычно после Стартового шага стоят три блока «Действие».
- Капча. Добавьте блок «Действие» и выберите Эмодзи-капча. В поле Лимит времени, сек укажите
300— это те самые 5 минут. Можно написать свой Вступительный текст (необязательно) или оставить поле пустым, тогда будет стандартное приветствие. Настройки в разделе В группах здесь не действуют: проверка идёт в личном чате. - Одобрение. Соедините выход Далее у блока с капчей с новым блоком «Действие». В группе Модули выберите Одобрить заявку на вступление.
- Отказ. Соедините выход Неудача у блока с капчей с ещё одним блоком «Действие». Выберите Отклонить заявку на вступление.
У обоих действий одинаковые поля:
| Поле | Что указать |
|---|---|
| Канал или группа | Значение триггера join_chat_id. Нажмите {} в поле и выберите его. |
| ID заявителя | Уже заполнено: `{{sysvar |
Одобрение и отказ — это действия модуля Telegram. Если их нет в группе Модули, сначала установите модуль Telegram на странице Модули. Подробнее — в статье Модули: Таблицы, AI, платежи и другие сервисы.
Чтобы проверить, опубликуйте бота и подайте заявку в чат со второго аккаунта Telegram.
05Что триггер передаёт в сценарий
Эти значения можно вставить в любое поле дальше по сценарию через {}. Например, обратиться к человеку по имени или назвать чат, в который он просится.
| Значение | Что в нём |
|---|---|
join_chat_id | ID канала или группы, куда человек просится |
join_chat_title | Название чата |
join_chat_username | @username чата, если он есть |
join_chat_type | Канал это или группа |
member_user_id | Telegram ID человека |
member_username | Его @username |
member_first_name | Его имя |
member_last_name | Его фамилия |
join_request_bio | Описание из его профиля |
invite_link | Ссылка-приглашение, по которой он пришёл |
date | Когда подана заявка |
06Чего эта функция не делает
- Только Telegram. В других каналах связи заявок на вступление нет.
- Старые заявки не приходят. Заявки, которые уже ждали решения до того, как бот начал получать заявки, в сценарий не попадут. Одобрите или отклоните их вручную в Telegram.
- После 5 минут бот молчит. Если человек не ответил за 5 минут, бот больше не может ему написать. Лимит капчи в 300 секунд отправит его по ветке Неудача, и заявка будет отклонена.
- Отказ — это не бан. Человек может подать заявку снова, и проверка начнётся заново.
- Заявки, обработанные вручную. Если администратор уже одобрил или отклонил заявку в Telegram, действие бота не сработает.
- Спящий бот отвечает чуть медленнее. Бот, которым давно не пользовались, засыпает. Заявка его будит, поэтому первое сообщение может прийти на несколько секунд позже.
- Тех, кто уже в чате, это не касается. Заявки — только для тех, кто ещё не вступил. Чтобы проверять новых участников группы, используйте триггер Новый участник чата с эмодзи-капчей, а в поле Когда попытки закончились выберите Удалить из группы. В каналах так не получится: подписчики не могут там писать, значит, и капчу пройти не могут. Для этого и нужны заявки.
07Что дальше
Проверка готова. Осталось запустить её: Тест и публикация бота.