Group Buddy

A powerful WhatsApp bot for efficient group management

Features

Member Management

  • • Track member activity
  • • Identify inactive members
  • • Automatic member purging
  • • Member statistics

Group Administration

  • • Group rules management
  • • Configurable settings
  • • Member removal
  • • Activity tracking

Utility Features

  • • Tag all members
  • • Activity statistics
  • • Top members ranking
  • • Automated cleanup

Getting Started

1. Add the Bot to Your Group

Add the bot's phone number to your WhatsApp group and make it admin.

2. Register Your Group

Use the /register command in your group to activate the bot.

3. Configure Settings

Use /config commands to customize the bot for your group's needs.

Commands Reference

⚙️ /config <setting> <value>

Edit group configuration

Available settings:
  • • maxInactiveDays: Set maximum days of inactivity allowed
  • • addRule: Add a new group rule
  • • removeRule: Remove an existing rule
  • • maxAutoPurge: Set the maximum number of inactive members that can be automatically removed per cleanup (e.g. /config maxAutoPurge 5)

📊 /stats

Get detailed group statistics including member activity and message counts

🏆 /top [number]

Display top active members (default: 10, max: 50)

👥 /inactive [days]

List inactive members. Optional: specify number of days (default: 30)

🧹 /purge [limit] [days]

Remove inactive members

Parameters:
  • • limit: Maximum number of members to remove
  • • days: Days of inactivity (default: 30)

🚫 /kick <username or number>

Remove a specific member from the group using their username, phone number, @mention, or by quoting their message.
Examples:
/kick @username — Remove by @mention
/kick 1234567890 — Remove by phone number
/kick (as a reply to a user's message) — Remove the quoted user

🔔 /tagall

Mention all group members with optional custom message and quoted message support.
Examples:
/tagall — Tag everyone with default message
/tagall Hello everyone! — Tag everyone with custom message
/tagall (as a reply to a message) — Tag everyone and include the quoted message

❓ /help

Display all available commands

Configuration Options

Inactive Member Management

Configure how the bot handles inactive members:

  • • Set maximum days of inactivity allowed
  • • Configure automatic member removal
  • • Set member removal limits per cleanup (maxAutoPurge)

    • How do I limit the number of inactive members removed by the bot?

    Use /config maxAutoPurge <number> to set the maximum number of inactive members that can be automatically removed in a single cleanup. This helps prevent accidental removal of all group members.

Group Rules

Manage your group's rules:

  • • Add new rules using /config addRule
  • • Remove existing rules using /config removeRule
  • • Rules are displayed to members when requested

Activity Tracking

The bot automatically tracks:

  • • Member message counts
  • • Last active timestamps
  • • Group total messages
  • • Member join/leave events

Frequently Asked Questions

Who can use the bot commands?

Only group administrators can use the bot's commands.

How does inactive member detection work?

The bot tracks the last message sent by each member. Members who haven't sent messages for longer than the configured inactive days are considered inactive.

Can the bot remove group admins?

No, the bot cannot remove group administrators, even if they are inactive.

Is there a limit to how many groups can use the bot?

Yes, there is a limit to ensure optimal performance. Contact the bot administrator if you need to register a new group.