Telegram Group Mention Bot

A Telegram bot that allows users to create mention groups and mention all members of a group at once.

Features

• Create mention groups in any chat
• Join/leave mention groups
• Mention all members of a group at once
• Support for users with and without usernames
• List group members without mentioning them
• Delete empty groups

Commands

Command	Description
/new <name>	Create a new mention group
/join <name>	Join an existing mention group
/leave <name>	Leave a mention group
/mention <name>, /m <name>, /call <name>	Mention all members of a group
/show <name>	Show all members of a group without mentioning them
/del <name>	Delete a group (only if it has no members)
/list	Show all groups in this chat
/my	Show groups you've joined in this chat
/help	Show this help message

Getting Started

From source

1. Create a .env file with the following variables:

   TELEGRAM_BOT_TOKEN=your_bot_token_here
   DATABASE_PATH=data.sqlite
   

2. Run the bot:

   go run main.go
   

Using Docker

You can also run the bot using Docker:

docker run -d \
  -e TELEGRAM_BOT_TOKEN=your_bot_token_here \
  -v ./data:/data \
  skobkin/telegram-group-mention-bot

Configuration

Variable	Description	Default
TELEGRAM_BOT_TOKEN	Your Telegram bot token from @BotFather	(required)
DATABASE_PATH	Path to the SQLite database file	data.sqlite
LOG_LEVEL	Logging level (debug, info, warn, error)	warn

You can also control logging verbosity using command-line flags:

• -v - Enable verbose logging (LevelInfo)
• -vv - Enable very verbose logging (LevelDebug)

Note: Command-line flags take precedence over the LOG_LEVEL environment variable.

Requirements

• Go 1.16 or later
• SQLite3
• Telegram Bot Token (get it from @BotFather)

Dependencies

• telego - Telegram Bot API library
• gorm - ORM library
• godotenv - Environment variables loader