https://github.com/mxssl/tg-captcha-bot

Telegram Сaptcha Bot
https://github.com/mxssl/tg-captcha-bot

bot captcha go golang socks5 telegram telegram-bot

Last synced: 7 days ago
JSON representation

Telegram Сaptcha Bot

• Host: GitHub
• URL: https://github.com/mxssl/tg-captcha-bot
• Owner: mxssl
• License: mit
• Created: 2018-06-10T15:59:36.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2025-01-13T14:55:51.000Z (20 days ago)
• Last Synced: 2025-01-19T16:02:31.249Z (14 days ago)
• Topics: bot, captcha, go, golang, socks5, telegram, telegram-bot
• Language: Go
• Homepage: https://t.me/cloud_tg_captcha_bot
• Size: 2.57 MB
• Stars: 268
• Watchers: 14
• Forks: 87
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        














# Telegram Captcha Bot

Telegram bot that validates new users that enter supergroup. Validation works like a simple captcha. Bot written in Go (Golang).

This bot has been tested on several supergroups (2000+ people) for a long time and has shown its effectiveness against spammers.

## Cloud hosted instance of the bot

[@cloud_tg_captcha_bot](https://t.me/cloud_tg_captcha_bot)

## How it works

1. Add the bot to your supergroup

2. Promote the bot for administrator privileges

3. A new user enters your supergroup

4. Bot restricts the user's ability to send messages

5. Bot shows a welcome message and a captcha button to the user

6. If the user doesn't press the button within 30 seconds then the user is banned by the bot

## If you want to run your own instance of the bot

- [Option 1 (the easiest one)](./INSTALL-1.md): docker-compose + already built docker container

- [Option 2](./INSTALL-2.md): docker-compose + build your own docker container

- [Option 3](./INSTALL-3.md): systemd

## Commands

`/healthz` - check that the bot is working correctly

## Сustomization

You can change several bot's settings (welcome message, ban duration, socks5 proxy server) through the configuration file `config.toml`

## Alternatives / Forks

- [momai/tg-captcha-bot](https://github.com/momai/tg-captcha-bot) - fork of `tg-captcha-bot` with interesting additional features.