Skip to content

A Telegram bot to guard against low-effort spambots in large groups.

License

Notifications You must be signed in to change notification settings

OzuYatamutsu/tg-big-boofer

Repository files navigation

tg-big-boofer Build Status

A Telegram bot to guard against low-effort spambots in large groups.


To add to your group

Add @BigBooferBot to your group. For enforcement to work (see below), they must be an admin of the group they are a part of.

a friend

Once added to the group, if you are an admin, promote @BigBooferBot to an admin, and configure the passphrase via /setchannel <channel_url> <passphrase>:

a friend

@BigBooferBot will then begin enforcement.

When a new user joins your group...

  • They will be welcomed by a big friend, @BigBooferBot, and will be directed to a separate channel, containing a passphrase (and whatever else you want, e.g. rules). a friend

  • Until they reply in the channel with the passphrase, all of their messages will either not be allowed to be posted, or deleted as soon as they are posted. a friend

  • If they don't reply with the passphrase within 5 minutes, @BigBooferBot will (regretably) remove them from the group. a friend

  • ...but admins can manually approve new users at any time. a friend

To run

BigBoofer uses go modules, so it requires Go >= 1.11.0.

Contact @BotFather on Telegram for an API key. Then, set your API key in config.go and run:

go build

It should pull in all required dependencies and produce a binary ready for you to run.

To test

go test -v bigboofer/test

About

A Telegram bot to guard against low-effort spambots in large groups.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages