telegram-groups

name	telegram-groups
description	Posting, members, Telegram group management

Telegram Groups

Operations with Telegram groups: listing, posting, members, management

When to use

• "show my telegram groups"
• "post in a group"
• "add users to a group"
• "list group members"
• "rename a group"
• "create a topic"

Tool

$TG_TOOLS_PATH/tools/tg_groups.py

How to run

List groups

# Groups only
python3 $TG_TOOLS_PATH/tools/tg_groups.py list

# Groups + channels
python3 $TG_TOOLS_PATH/tools/tg_groups.py list --all

Post in a group

# Text directly
python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message "Hello!"

# From file
python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message-file msg.txt

# In a specific topic (forum group)
python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message "Hello!" --topic 123

Group Name -- search by substring (case-insensitive).

List members

python3 $TG_TOOLS_PATH/tools/tg_groups.py members "Group Name"

Add users

python3 $TG_TOOLS_PATH/tools/tg_groups.py add-users "Group Name" --input users.csv

CSV format: username,name

Rename a group

python3 $TG_TOOLS_PATH/tools/tg_groups.py rename "Group Name" --name "New Name"

Create a topic (forum group)

python3 $TG_TOOLS_PATH/tools/tg_groups.py topics "Group Name" --add "Topic Title"
python3 $TG_TOOLS_PATH/tools/tg_groups.py topics "Group Name" --add "Topic" --color 6FB9F0

Limitations

• add-users: requires admin rights, mutual contact, privacy settings
• rename: requires admin rights
• topics: only for forum groups
• 2 sec delay between adding users (rate limit)

Related skills

• telegram-send -- DM sending (not to a group)
• telegram-scrape -- searching channels/groups