Group Management Tools

​

Overview

​

whatsapp_group_create

​

Parameters

​

Returns

{
  "group_id": "[email protected]",
  "title": "Project Team",
  "members": 3
}

​

Example Usage

Create a WhatsApp group named "Project Team"

Create a group named "Family" with participants 628123456789 and 628987654321

{
  "name": "whatsapp_group_create",
  "arguments": {
    "title": "Book Club",
    "participants": ["628123456789", "628987654321", "628555555555"]
  }
}

​

Hints

• Read-only: false
• Destructive: true (creates new group)
• Idempotent: false (creates new group each time)

​

Implementation Reference

​

whatsapp_group_join_via_link

​

Parameters

​

Invite Link Formats

• https://chat.whatsapp.com/ABC123xyz
• chat.whatsapp.com/ABC123xyz
• ABC123xyz (just the code)

​

Returns

{
  "group_id": "[email protected]",
  "invite_link": "https://chat.whatsapp.com/ABC123xyz"
}

​

Example Usage

Join WhatsApp group using link https://chat.whatsapp.com/ABC123xyz

​

Hints

• Read-only: false
• Destructive: true (joins group)
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_leave

​

Parameters

​

Returns

Left group [email protected]

​

Example Usage

Leave WhatsApp group [email protected]

​

Hints

• Read-only: false
• Destructive: true
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_participants

​

Parameters

​

Returns

{
  "group_id": "[email protected]",
  "participants": [
    {
      "jid": "[email protected]",
      "is_admin": true,
      "is_super_admin": true
    },
    {
      "jid": "[email protected]",
      "is_admin": false,
      "is_super_admin": false
    }
  ]
}

​

Participant Roles

• Super Admin: Creator of the group (cannot be demoted)
• Admin: Can add/remove members, change settings
• Member: Regular participant

​

Hints

• Read-only: true
• Destructive: false
• Idempotent: true

​

Implementation Reference

​

whatsapp_group_manage_participants

​

Parameters

​

Actions

​

Returns

{
  "success": true,
  "action": "add",
  "affected_count": 2
}

​

Example Usage

Add 628123456789 and 628987654321 to group [email protected]

Remove 628555555555 from group [email protected]

Promote 628123456789 to admin in group [email protected]

Demote 628987654321 in group [email protected]

​

Hints

• Read-only: false
• Destructive: true
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_invite_link

​

Parameters

​

Returns

{
  "invite_link": "https://chat.whatsapp.com/ABC123xyz"
}

​

Reset Behavior

• Old invite link is invalidated
• New invite link is generated
• Anyone with old link can no longer join

​

Example Usage

Get invite link for group [email protected]

Reset invite link for group [email protected]

​

Hints

• Read-only: false
• Destructive: true (when reset=true)
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_info

​

Parameters

​

Returns

{
  "group_id": "[email protected]",
  "name": "Project Team",
  "topic": "Discuss project updates and deadlines",
  "owner": "[email protected]",
  "created_at": "2026-01-15T10:00:00Z",
  "participant_count": 15,
  "is_locked": false,
  "is_announce": false
}

​

Group Settings

• is_locked: If true, only admins can edit group info
• is_announce: If true, only admins can send messages

​

Hints

• Read-only: true
• Destructive: false
• Idempotent: true

​

Implementation Reference

​

whatsapp_group_set_name

​

Parameters

​

Returns

Updated group [email protected] name to Team Alpha

​

Example Usage

Rename group [email protected] to "Team Alpha"

​

Hints

• Read-only: false
• Destructive: true
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_set_topic

​

Parameters

​

Returns

Updated group [email protected] topic

​

Example Usage

Set topic for group [email protected] to "Weekly standup meetings and updates"

​

Hints

• Read-only: false
• Destructive: true
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_set_locked

​

Parameters

​

Locked State

• Only admins can change group name
• Only admins can change group icon
• Only admins can change group description

• All participants can edit group info

​

Returns

Group [email protected] is now locked

​

Example Usage

Lock group [email protected]

Unlock group [email protected]

​

Hints

• Read-only: false
• Destructive: true
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_set_announce

​

Parameters

​

Announce Mode

• Only admins can send messages
• Regular members can only read messages
• Useful for broadcast/announcement groups

• All participants can send messages
• Regular group chat behavior

​

Returns

Group [email protected] is now in announcement-only mode

​

Example Usage

Set group [email protected] to announcement-only mode

Disable announcement mode for group [email protected]

​

Hints

• Read-only: false
• Destructive: true
• Idempotent: false

​

Implementation Reference

​

whatsapp_group_join_requests

​

Parameters

​

Returns

[
  {
    "jid": "[email protected]",
    "requested_at": "2026-03-04T10:30:00Z"
  },
  {
    "jid": "[email protected]",
    "requested_at": "2026-03-04T11:15:00Z"
  }
]

​

When Join Requests Occur

• Group requires admin approval for new members
• User clicks invite link but cannot auto-join

​

Hints

• Read-only: true
• Destructive: false
• Idempotent: true

​

Implementation Reference

​

whatsapp_group_manage_join_requests

​

Parameters

​

Returns

{
  "success": true,
  "action": "approve",
  "affected_count": 2
}

​

Example Usage

Approve join requests for 628123456789 and 628987654321 in group [email protected]

Reject join request for 628555555555 in group [email protected]

​

Hints

• Read-only: false
• Destructive: true
• Idempotent: false

​

Implementation Reference

​

Helper Functions

​

Participant Change Parser

func parseParticipantChange(action string) (whatsmeow.ParticipantChange, error) {
    switch strings.ToLower(strings.TrimSpace(action)) {
    case "add":     return whatsmeow.ParticipantChangeAdd, nil
    case "remove":  return whatsmeow.ParticipantChangeRemove, nil
    case "promote": return whatsmeow.ParticipantChangePromote, nil
    case "demote":  return whatsmeow.ParticipantChangeDemote, nil
    default:        return "", fmt.Errorf("invalid participant action: %s", action)
    }
}

​

Join Request Action Parser

func parseParticipantRequestChange(action string) (whatsmeow.ParticipantRequestChange, error) {
    switch strings.ToLower(strings.TrimSpace(action)) {
    case "approve": return whatsmeow.ParticipantChangeApprove, nil
    case "reject":  return whatsmeow.ParticipantChangeReject, nil
    default:        return "", fmt.Errorf("invalid join request action: %s", action)
    }
}

​

String Array Parser

func toStringSlice(raw any) ([]string, error) {
    // Handles []string, []any with string items
    // Trims whitespace from all items
}

​

Best Practices

1. Check permissions: Verify you’re an admin before attempting admin-only actions
2. Validate participants: Ensure phone numbers exist before adding to groups
3. Handle errors gracefully: Some operations may fail due to WhatsApp restrictions
4. Reset links carefully: Resetting invite links invalidates all existing links
5. Test with small groups: Validate changes on test groups before production use

​

Common Errors

​

Next Steps