gfsolone/telegram-chat-id-bot repository overview

⁠Telegram Group/Channel ID Bot

A simple Telegram bot that sends you the ID of any group or channel when you add it.

⁠Features

• Automatically detects when added to a group or channel
• Sends a private message with the chat ID to the user who added it
• Works with both groups and channels
• Simple /start command for instructions
• Dedicated /chatid command for the current chat ID
• Dedicated /myid command for the numeric user ID

⁠Commands

• /start - Get bot instructions
• /chatid - Get the current chat ID (works in groups, channels, and private chats)
• /getid - Backward-compatible alias for /chatid
• /myid - Get your numeric Telegram user ID

⁠Setup

1. Create a bot via @BotFather⁠
2. Copy the bot token
3. Create .env file with your token:

TELEGRAM_BOT_TOKEN=your_token_here

⁠Running with Docker

docker-compose up -d

⁠Important Notes

Privacy Requirement: Users must start the bot privately with /start before adding it to a group. Otherwise, Telegram will block the bot from sending private messages.

Recommended Workflow:

1. User starts bot with /start command
2. User adds bot to group/channel
3. Bot sends group/channel ID via private message

⁠Usage

1. Start the bot with /start command in private chat
2. Add the bot to any group or channel
3. Receive the group/channel ID in your private chat with the bot
4. Use /chatid whenever you need the current chat ID
5. Use /myid whenever you need your numeric user ID