Telegram bot with image/emoji CAPTCHA challenge/response.

• Show CAPTCHA for new members.
• Ban channels except for the linked one (if set) [optional].
• Change bot language for a group (only English and Russian available at the time).
• Set custom greeting.

This bot loads environment variables from a .env file.
Copy .example.env to .env, read comments and edit file accordingly.

In a group use /settings commands to show and change bot settings.

List of available settings:

Use /greeting command to change greeting for newcomers.
Note that greeting text must include "{user_tag}" substring.

http {
    upstream guardian {
        server WEBHOOK_ADDR fail_timeout=0;
    }

    server {
        # ...

        location /webhook {
            set $token SECRET_TOKEN;

            if ($http_x_telegram_bot_api_secret_token = $token) {
                proxy_pass http://guardian$request_uri;
            }
        }

        location / {
            return 403;
        }
    }
}

where WEBHOOK_ADDR is the same address:port as WEBHOOK_ADDR value in your .env file, and SECRET_TOKEN is your bot's token with ":" replaced to "_".

• Translate /help output and error messages sent to user.
• Limit number of new chat members per minute, don't show captcha if limit has reached.
• Periodicly delete expired ignore set key/scores in Redis.
• /stats command to show bot statistics: number of users passed/not passed captcha for a group, etc.
• Add more emojis.

• Emoji Meanings Encyclopedia