Get rid of the unwanted spam joins out of the box
Basically, that what happens, if the bot is set up in your chat:
- Triggered on the events, which introduces new chat members (invite, join, etc). Also works with join requests.
- Restrict newcomer to be read-only.
- Set up a challenge for the newcomer, which is a simple task as shown on the image above, but yet, unsolvable for the vast majority of automated spam robots.
- If the newcomer succeeds in choosing the right answer - restrictions gets fully lifted, challenge ends.
- Otherwise - newcomer gets banned for 10 minutes (There is a "false-positive" chance, rememeber? Most robots aint coming back, anyway).
- If the newcomer struggles to answer in a set period of time (defaults to 3 minutes) - challenge automatically fails the same way, as in p.5.
- After the challenge bot cleans up all related messages, only leaving join notification for the newcomers, that made it. There are no traces of unsuccesful joins left, and that is awesome.
Don't hesitate to contact me
Ok, I've got something for ya.
- Invite the Quarantino into your chat group.
- Promote him to Admin with at least Ban, Delete, and Invite permissions enabled.
- (optional) Message
/lang ru
to change chat language. - ...
- PROFIT.
I respect your privacy, so I do NOT log messages nor collecting personal data. This bot is hosted on my personal VDS instance, and it's completely private. Happy chatting!
- Create a bot via BotFather.
- Finally, enable group messages access for your bot, it's essential for your bot to be able to see newcomers.
- Memorize the unique token string of your bot.
- Have recent version of Docker.
- Obtain code either via
git clone
↗️ or by downloading zip and extracting it. - Open terminal app of your choice and navigate into the code folder.
- Run this command, replacing the T with the actual token string
docker compose build --build-arg NG_TOKEN=<REPLACE_THIS> docker compose up -d --no-recreate
- Add your bot to chat, give him permissions to Ban, Delete, and Invite.
- Change bot language for this chat, if needed.
/lang ru
(see below for the complete list of available languages)
docker compose stop
to stop botdocker compose start
to get it up and running again.docker compose down
to remove bot's artifacs.rm ~/.ngbot/bot.db
to start clean.
NG_DIR=${GOPATH-$HOME/go}/src/github.com/iamwavecut/ngbot
git clone git@github.com:iamwavecut/ngbot.git ${NG_DIR}
cd ${NG_DIR}
NG_TOKEN=<REPLACE_THIS>
docker build . --build-arg NG_TOKEN=$NG_TOKEN -t ngbot
// token gets baked into container, so you just simply
docker run ngbot
Override baked variables by providing them as runtime flags
docker run -e NG_TOKEN=<ANOTHER_TOKEN> ngbot
NG_DIR=${GOPATH-$HOME/go}/src/github.com/iamwavecut/ngbot
git clone git@github.com:iamwavecut/ngbot.git ${NG_DIR}
cd ${NG_DIR}
NG_TOKEN=<REPLACE_THIS>
NG_LANG=en
NG_HANDLERS=admin,gatekeeper
NG_LOG_LEVEL=6
CGO_ENABLE=1 go run .
All configuration is meant to be passed as build time arguments, however, you are free to modify env vars at runtime at your own risk.
Required | Variable name | Description | Default | Options |
---|---|---|---|---|
✔️ | NG_TOKEN |
Telegram BOT API token | ||
❌ | NG_LANG |
Default language to use in new chats. | en |
be, bg , cs , da , de , el , en , es , et , fi , fr , hu , id , it , ja , ko , lt , lv , nb , nl , pl , pt , ro , ru , sk , sl , sv , tr , uk , zh |
❌ | NG_HANDLERS |
If for some silly reason you want to get rid of admin or gateway function. Or if you are awesome and want to add yours. Or to change an invocation order. Go for it! | admin,gatekeeper |
any combination of comma-separated default items. |
❌ | NG_LOG_LEVEL |
Limits the logs spam, maximum verbosity by default. | 6 |
0 =Panic, 1 =Fatal, 2 =Error, 3 =Warn, 4 =Info, 5 =Debug, 6 =Trace |
- Improve thread safety.
- Individual chat's settings (behaviours, timeouts, custom welcome messages, etc).
- Interactive handy chat settings UI in private.
- Dynamic plugin system.
- Handy web UI for chat owners.
Feel free to add your requests in issues.