Groups Commands

Manage Signal group membership and discovery.

!groups

List all Signal groups the bot is a member of, sorted by size.

!groups

Response:

Signal Groups (Sorted by Size):

1. Main Community Chat
   Members: 150

2. Tech Discussion
   Members: 75

3. Book Club
   Members: 30

────────────────
Total: 3 groups
Member slots: 255 (180 unique users)
 = Bot has admin rights
 = Bot is regular member

Bot can add users to 2 group(s)
Use !addto <group-number> @user to add users

Security: Must be used in a group chat, not DMs.

---

!join

Self-service group joining for community members.

!join
!join <group-number>

Features:

• Shows list of joinable groups when used without arguments
• Only shows groups where bot has admin rights
• User must be a verified community member
• Some groups may be restricted

Example:

!join 3

---

!refreshgroups

Force refresh the cached group list from signal-cli.

!refreshgroups

Use Case: When groups have changed but the bot’s cache is stale.

---

!addto (Admin Only)

Add a user to a specific group by mentioning them.

!addto <group-number> @user

Example:

!addto 3 @JohnDoe

Requirements:

• Admin permission required
• Bot must have admin rights in the target group
• User must be mentioned (not phone number)

Response:

Adding @JohnDoe to Book Club...
User added successfully!

---

!leave

Leave a dice game or breakout room.

!leave

Note: This command is used in the context of dice games and breakout rooms, not for leaving Signal groups.

---

How Group Permissions Work

The bot tracks two types of access:

1. Bot Admin Status () - Bot can add/remove users in these groups
2. Bot Member Status () - Bot can only read and send messages

For !addto to work:

• Bot needs admin rights in the target group
• The requesting user must be a bot admin
• The target user must be mentioned (not their phone number)