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

```bash
# 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

```bash
# 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

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

### Add users

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

CSV format: `username,name`

### Rename a group

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

### Create a topic (forum group)

```bash
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