diff --git a/.claude/skills/prd/SKILL.md b/.claude/skills/prd/SKILL.md
new file mode 100644
index 0000000000000..9db3bd7b0839f
--- /dev/null
+++ b/.claude/skills/prd/SKILL.md
@@ -0,0 +1,240 @@
+---
+name: prd
+description: "Generate a Product Requirements Document (PRD) for a new feature. Use when planning a feature, starting a new project, or when asked to create a PRD. Triggers on: create a prd, write prd for, plan this feature, requirements for, spec out."
+---
+
+# PRD Generator
+
+Create detailed Product Requirements Documents that are clear, actionable, and suitable for implementation.
+
+---
+
+## The Job
+
+1. Receive a feature description from the user
+2. Ask 3-5 essential clarifying questions (with lettered options)
+3. Generate a structured PRD based on answers
+4. Save to `tasks/prd-[feature-name].md`
+
+**Important:** Do NOT start implementing. Just create the PRD.
+
+---
+
+## Step 1: Clarifying Questions
+
+Ask only critical questions where the initial prompt is ambiguous. Focus on:
+
+- **Problem/Goal:** What problem does this solve?
+- **Core Functionality:** What are the key actions?
+- **Scope/Boundaries:** What should it NOT do?
+- **Success Criteria:** How do we know it's done?
+
+### Format Questions Like This:
+
+```
+1. What is the primary goal of this feature?
+   A. Improve user onboarding experience
+   B. Increase user retention
+   C. Reduce support burden
+   D. Other: [please specify]
+
+2. Who is the target user?
+   A. New users only
+   B. Existing users only
+   C. All users
+   D. Admin users only
+
+3. What is the scope?
+   A. Minimal viable version
+   B. Full-featured implementation
+   C. Just the backend/API
+   D. Just the UI
+```
+
+This lets users respond with "1A, 2C, 3B" for quick iteration. Remember to indent the options.
+
+---
+
+## Step 2: PRD Structure
+
+Generate the PRD with these sections:
+
+### 1. Introduction/Overview
+Brief description of the feature and the problem it solves.
+
+### 2. Goals
+Specific, measurable objectives (bullet list).
+
+### 3. User Stories
+Each story needs:
+- **Title:** Short descriptive name
+- **Description:** "As a [user], I want [feature] so that [benefit]"
+- **Acceptance Criteria:** Verifiable checklist of what "done" means
+
+Each story should be small enough to implement in one focused session.
+
+**Format:**
+```markdown
+### US-001: [Title]
+**Description:** As a [user], I want [feature] so that [benefit].
+
+**Acceptance Criteria:**
+- [ ] Specific verifiable criterion
+- [ ] Another criterion
+- [ ] Typecheck/lint passes
+- [ ] **[UI stories only]** Verify in browser using dev-browser skill
+```
+
+**Important:** 
+- Acceptance criteria must be verifiable, not vague. "Works correctly" is bad. "Button shows confirmation dialog before deleting" is good.
+- **For any story with UI changes:** Always include "Verify in browser using dev-browser skill" as acceptance criteria. This ensures visual verification of frontend work.
+
+### 4. Functional Requirements
+Numbered list of specific functionalities:
+- "FR-1: The system must allow users to..."
+- "FR-2: When a user clicks X, the system must..."
+
+Be explicit and unambiguous.
+
+### 5. Non-Goals (Out of Scope)
+What this feature will NOT include. Critical for managing scope.
+
+### 6. Design Considerations (Optional)
+- UI/UX requirements
+- Link to mockups if available
+- Relevant existing components to reuse
+
+### 7. Technical Considerations (Optional)
+- Known constraints or dependencies
+- Integration points with existing systems
+- Performance requirements
+
+### 8. Success Metrics
+How will success be measured?
+- "Reduce time to complete X by 50%"
+- "Increase conversion rate by 10%"
+
+### 9. Open Questions
+Remaining questions or areas needing clarification.
+
+---
+
+## Writing for Junior Developers
+
+The PRD reader may be a junior developer or AI agent. Therefore:
+
+- Be explicit and unambiguous
+- Avoid jargon or explain it
+- Provide enough detail to understand purpose and core logic
+- Number requirements for easy reference
+- Use concrete examples where helpful
+
+---
+
+## Output
+
+- **Format:** Markdown (`.md`)
+- **Location:** `tasks/`
+- **Filename:** `prd-[feature-name].md` (kebab-case)
+
+---
+
+## Example PRD
+
+```markdown
+# PRD: Task Priority System
+
+## Introduction
+
+Add priority levels to tasks so users can focus on what matters most. Tasks can be marked as high, medium, or low priority, with visual indicators and filtering to help users manage their workload effectively.
+
+## Goals
+
+- Allow assigning priority (high/medium/low) to any task
+- Provide clear visual differentiation between priority levels
+- Enable filtering and sorting by priority
+- Default new tasks to medium priority
+
+## User Stories
+
+### US-001: Add priority field to database
+**Description:** As a developer, I need to store task priority so it persists across sessions.
+
+**Acceptance Criteria:**
+- [ ] Add priority column to tasks table: 'high' | 'medium' | 'low' (default 'medium')
+- [ ] Generate and run migration successfully
+- [ ] Typecheck passes
+
+### US-002: Display priority indicator on task cards
+**Description:** As a user, I want to see task priority at a glance so I know what needs attention first.
+
+**Acceptance Criteria:**
+- [ ] Each task card shows colored priority badge (red=high, yellow=medium, gray=low)
+- [ ] Priority visible without hovering or clicking
+- [ ] Typecheck passes
+- [ ] Verify in browser using dev-browser skill
+
+### US-003: Add priority selector to task edit
+**Description:** As a user, I want to change a task's priority when editing it.
+
+**Acceptance Criteria:**
+- [ ] Priority dropdown in task edit modal
+- [ ] Shows current priority as selected
+- [ ] Saves immediately on selection change
+- [ ] Typecheck passes
+- [ ] Verify in browser using dev-browser skill
+
+### US-004: Filter tasks by priority
+**Description:** As a user, I want to filter the task list to see only high-priority items when I'm focused.
+
+**Acceptance Criteria:**
+- [ ] Filter dropdown with options: All | High | Medium | Low
+- [ ] Filter persists in URL params
+- [ ] Empty state message when no tasks match filter
+- [ ] Typecheck passes
+- [ ] Verify in browser using dev-browser skill
+
+## Functional Requirements
+
+- FR-1: Add `priority` field to tasks table ('high' | 'medium' | 'low', default 'medium')
+- FR-2: Display colored priority badge on each task card
+- FR-3: Include priority selector in task edit modal
+- FR-4: Add priority filter dropdown to task list header
+- FR-5: Sort by priority within each status column (high to medium to low)
+
+## Non-Goals
+
+- No priority-based notifications or reminders
+- No automatic priority assignment based on due date
+- No priority inheritance for subtasks
+
+## Technical Considerations
+
+- Reuse existing badge component with color variants
+- Filter state managed via URL search params
+- Priority stored in database, not computed
+
+## Success Metrics
+
+- Users can change priority in under 2 clicks
+- High-priority tasks immediately visible at top of lists
+- No regression in task list performance
+
+## Open Questions
+
+- Should priority affect task ordering within a column?
+- Should we add keyboard shortcuts for priority changes?
+```
+
+---
+
+## Checklist
+
+Before saving the PRD:
+
+- [ ] Asked clarifying questions with lettered options
+- [ ] Incorporated user's answers
+- [ ] User stories are small and specific
+- [ ] Functional requirements are numbered and unambiguous
+- [ ] Non-goals section defines clear boundaries
+- [ ] Saved to `tasks/prd-[feature-name].md`
diff --git a/.claude/skills/ralph/SKILL.md b/.claude/skills/ralph/SKILL.md
new file mode 100644
index 0000000000000..c17043c681a40
--- /dev/null
+++ b/.claude/skills/ralph/SKILL.md
@@ -0,0 +1,257 @@
+---
+name: ralph
+description: "Convert PRDs to prd.json format for the Ralph autonomous agent system. Use when you have an existing PRD and need to convert it to Ralph's JSON format. Triggers on: convert this prd, turn this into ralph format, create prd.json from this, ralph json."
+---
+
+# Ralph PRD Converter
+
+Converts existing PRDs to the prd.json format that Ralph uses for autonomous execution.
+
+---
+
+## The Job
+
+Take a PRD (markdown file or text) and convert it to `prd.json` in your ralph directory.
+
+---
+
+## Output Format
+
+```json
+{
+  "project": "[Project Name]",
+  "branchName": "ralph/[feature-name-kebab-case]",
+  "description": "[Feature description from PRD title/intro]",
+  "userStories": [
+    {
+      "id": "US-001",
+      "title": "[Story title]",
+      "description": "As a [user], I want [feature] so that [benefit]",
+      "acceptanceCriteria": [
+        "Criterion 1",
+        "Criterion 2",
+        "Typecheck passes"
+      ],
+      "priority": 1,
+      "passes": false,
+      "notes": ""
+    }
+  ]
+}
+```
+
+---
+
+## Story Size: The Number One Rule
+
+**Each story must be completable in ONE Ralph iteration (one context window).**
+
+Ralph spawns a fresh Amp instance per iteration with no memory of previous work. If a story is too big, the LLM runs out of context before finishing and produces broken code.
+
+### Right-sized stories:
+- Add a database column and migration
+- Add a UI component to an existing page
+- Update a server action with new logic
+- Add a filter dropdown to a list
+
+### Too big (split these):
+- "Build the entire dashboard" - Split into: schema, queries, UI components, filters
+- "Add authentication" - Split into: schema, middleware, login UI, session handling
+- "Refactor the API" - Split into one story per endpoint or pattern
+
+**Rule of thumb:** If you cannot describe the change in 2-3 sentences, it is too big.
+
+---
+
+## Story Ordering: Dependencies First
+
+Stories execute in priority order. Earlier stories must not depend on later ones.
+
+**Correct order:**
+1. Schema/database changes (migrations)
+2. Server actions / backend logic
+3. UI components that use the backend
+4. Dashboard/summary views that aggregate data
+
+**Wrong order:**
+1. UI component (depends on schema that does not exist yet)
+2. Schema change
+
+---
+
+## Acceptance Criteria: Must Be Verifiable
+
+Each criterion must be something Ralph can CHECK, not something vague.
+
+### Good criteria (verifiable):
+- "Add `status` column to tasks table with default 'pending'"
+- "Filter dropdown has options: All, Active, Completed"
+- "Clicking delete shows confirmation dialog"
+- "Typecheck passes"
+- "Tests pass"
+
+### Bad criteria (vague):
+- "Works correctly"
+- "User can do X easily"
+- "Good UX"
+- "Handles edge cases"
+
+### Always include as final criterion:
+```
+"Typecheck passes"
+```
+
+For stories with testable logic, also include:
+```
+"Tests pass"
+```
+
+### For stories that change UI, also include:
+```
+"Verify in browser using dev-browser skill"
+```
+
+Frontend stories are NOT complete until visually verified. Ralph will use the dev-browser skill to navigate to the page, interact with the UI, and confirm changes work.
+
+---
+
+## Conversion Rules
+
+1. **Each user story becomes one JSON entry**
+2. **IDs**: Sequential (US-001, US-002, etc.)
+3. **Priority**: Based on dependency order, then document order
+4. **All stories**: `passes: false` and empty `notes`
+5. **branchName**: Derive from feature name, kebab-case, prefixed with `ralph/`
+6. **Always add**: "Typecheck passes" to every story's acceptance criteria
+
+---
+
+## Splitting Large PRDs
+
+If a PRD has big features, split them:
+
+**Original:**
+> "Add user notification system"
+
+**Split into:**
+1. US-001: Add notifications table to database
+2. US-002: Create notification service for sending notifications
+3. US-003: Add notification bell icon to header
+4. US-004: Create notification dropdown panel
+5. US-005: Add mark-as-read functionality
+6. US-006: Add notification preferences page
+
+Each is one focused change that can be completed and verified independently.
+
+---
+
+## Example
+
+**Input PRD:**
+```markdown
+# Task Status Feature
+
+Add ability to mark tasks with different statuses.
+
+## Requirements
+- Toggle between pending/in-progress/done on task list
+- Filter list by status
+- Show status badge on each task
+- Persist status in database
+```
+
+**Output prd.json:**
+```json
+{
+  "project": "TaskApp",
+  "branchName": "ralph/task-status",
+  "description": "Task Status Feature - Track task progress with status indicators",
+  "userStories": [
+    {
+      "id": "US-001",
+      "title": "Add status field to tasks table",
+      "description": "As a developer, I need to store task status in the database.",
+      "acceptanceCriteria": [
+        "Add status column: 'pending' | 'in_progress' | 'done' (default 'pending')",
+        "Generate and run migration successfully",
+        "Typecheck passes"
+      ],
+      "priority": 1,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-002",
+      "title": "Display status badge on task cards",
+      "description": "As a user, I want to see task status at a glance.",
+      "acceptanceCriteria": [
+        "Each task card shows colored status badge",
+        "Badge colors: gray=pending, blue=in_progress, green=done",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 2,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-003",
+      "title": "Add status toggle to task list rows",
+      "description": "As a user, I want to change task status directly from the list.",
+      "acceptanceCriteria": [
+        "Each row has status dropdown or toggle",
+        "Changing status saves immediately",
+        "UI updates without page refresh",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 3,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-004",
+      "title": "Filter tasks by status",
+      "description": "As a user, I want to filter the list to see only certain statuses.",
+      "acceptanceCriteria": [
+        "Filter dropdown: All | Pending | In Progress | Done",
+        "Filter persists in URL params",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 4,
+      "passes": false,
+      "notes": ""
+    }
+  ]
+}
+```
+
+---
+
+## Archiving Previous Runs
+
+**Before writing a new prd.json, check if there is an existing one from a different feature:**
+
+1. Read the current `prd.json` if it exists
+2. Check if `branchName` differs from the new feature's branch name
+3. If different AND `progress.txt` has content beyond the header:
+   - Create archive folder: `archive/YYYY-MM-DD-feature-name/`
+   - Copy current `prd.json` and `progress.txt` to archive
+   - Reset `progress.txt` with fresh header
+
+**The ralph.sh script handles this automatically** when you run it, but if you are manually updating prd.json between runs, archive first.
+
+---
+
+## Checklist Before Saving
+
+Before writing prd.json, verify:
+
+- [ ] **Previous run archived** (if prd.json exists with different branchName, archive it first)
+- [ ] Each story is completable in one iteration (small enough)
+- [ ] Stories are ordered by dependency (schema to backend to UI)
+- [ ] Every story has "Typecheck passes" as criterion
+- [ ] UI stories have "Verify in browser using dev-browser skill" as criterion
+- [ ] Acceptance criteria are verifiable (not vague)
+- [ ] No story depends on a later story
diff --git a/.claude/skills/ralph/scripts/ralph.sh b/.claude/skills/ralph/scripts/ralph.sh
new file mode 100755
index 0000000000000..baff052ac36f0
--- /dev/null
+++ b/.claude/skills/ralph/scripts/ralph.sh
@@ -0,0 +1,113 @@
+#!/bin/bash
+# Ralph Wiggum - Long-running AI agent loop
+# Usage: ./ralph.sh [--tool amp|claude] [max_iterations]
+
+set -e
+
+# Parse arguments
+TOOL="amp"  # Default to amp for backwards compatibility
+MAX_ITERATIONS=10
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --tool)
+      TOOL="$2"
+      shift 2
+      ;;
+    --tool=*)
+      TOOL="${1#*=}"
+      shift
+      ;;
+    *)
+      # Assume it's max_iterations if it's a number
+      if [[ "$1" =~ ^[0-9]+$ ]]; then
+        MAX_ITERATIONS="$1"
+      fi
+      shift
+      ;;
+  esac
+done
+
+# Validate tool choice
+if [[ "$TOOL" != "amp" && "$TOOL" != "claude" ]]; then
+  echo "Error: Invalid tool '$TOOL'. Must be 'amp' or 'claude'."
+  exit 1
+fi
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PRD_FILE="$SCRIPT_DIR/prd.json"
+PROGRESS_FILE="$SCRIPT_DIR/progress.txt"
+ARCHIVE_DIR="$SCRIPT_DIR/archive"
+LAST_BRANCH_FILE="$SCRIPT_DIR/.last-branch"
+
+# Archive previous run if branch changed
+if [ -f "$PRD_FILE" ] && [ -f "$LAST_BRANCH_FILE" ]; then
+  CURRENT_BRANCH=$(jq -r '.branchName // empty' "$PRD_FILE" 2>/dev/null || echo "")
+  LAST_BRANCH=$(cat "$LAST_BRANCH_FILE" 2>/dev/null || echo "")
+  
+  if [ -n "$CURRENT_BRANCH" ] && [ -n "$LAST_BRANCH" ] && [ "$CURRENT_BRANCH" != "$LAST_BRANCH" ]; then
+    # Archive the previous run
+    DATE=$(date +%Y-%m-%d)
+    # Strip "ralph/" prefix from branch name for folder
+    FOLDER_NAME=$(echo "$LAST_BRANCH" | sed 's|^ralph/||')
+    ARCHIVE_FOLDER="$ARCHIVE_DIR/$DATE-$FOLDER_NAME"
+    
+    echo "Archiving previous run: $LAST_BRANCH"
+    mkdir -p "$ARCHIVE_FOLDER"
+    [ -f "$PRD_FILE" ] && cp "$PRD_FILE" "$ARCHIVE_FOLDER/"
+    [ -f "$PROGRESS_FILE" ] && cp "$PROGRESS_FILE" "$ARCHIVE_FOLDER/"
+    echo "   Archived to: $ARCHIVE_FOLDER"
+    
+    # Reset progress file for new run
+    echo "# Ralph Progress Log" > "$PROGRESS_FILE"
+    echo "Started: $(date)" >> "$PROGRESS_FILE"
+    echo "---" >> "$PROGRESS_FILE"
+  fi
+fi
+
+# Track current branch
+if [ -f "$PRD_FILE" ]; then
+  CURRENT_BRANCH=$(jq -r '.branchName // empty' "$PRD_FILE" 2>/dev/null || echo "")
+  if [ -n "$CURRENT_BRANCH" ]; then
+    echo "$CURRENT_BRANCH" > "$LAST_BRANCH_FILE"
+  fi
+fi
+
+# Initialize progress file if it doesn't exist
+if [ ! -f "$PROGRESS_FILE" ]; then
+  echo "# Ralph Progress Log" > "$PROGRESS_FILE"
+  echo "Started: $(date)" >> "$PROGRESS_FILE"
+  echo "---" >> "$PROGRESS_FILE"
+fi
+
+echo "Starting Ralph - Tool: $TOOL - Max iterations: $MAX_ITERATIONS"
+
+for i in $(seq 1 $MAX_ITERATIONS); do
+  echo ""
+  echo "==============================================================="
+  echo "  Ralph Iteration $i of $MAX_ITERATIONS ($TOOL)"
+  echo "==============================================================="
+
+  # Run the selected tool with the ralph prompt
+  if [[ "$TOOL" == "amp" ]]; then
+    OUTPUT=$(cat "$SCRIPT_DIR/prompt.md" | amp --dangerously-allow-all 2>&1 | tee /dev/stderr) || true
+  else
+    # Claude Code: use --dangerously-skip-permissions for autonomous operation, --print for output
+    OUTPUT=$(claude --dangerously-skip-permissions --print < "$SCRIPT_DIR/CLAUDE.md" 2>&1 | tee /dev/stderr) || true
+  fi
+  
+  # Check for completion signal
+  if echo "$OUTPUT" | grep -q "<promise>COMPLETE</promise>"; then
+    echo ""
+    echo "Ralph completed all tasks!"
+    echo "Completed at iteration $i of $MAX_ITERATIONS"
+    exit 0
+  fi
+  
+  echo "Iteration $i complete. Continuing..."
+  sleep 2
+done
+
+echo ""
+echo "Ralph reached max iterations ($MAX_ITERATIONS) without completing all tasks."
+echo "Check $PROGRESS_FILE for status."
+exit 1
diff --git a/AGENTS.md b/AGENTS.md
index 301633d7f1569..f3a4065d17550 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -102,3 +102,108 @@ Practical checklist for any change impacting core logic or public APIs
 ## Branding / White-labeling note
 
 - For user-facing strings that currently contain "Chatwoot" but should adapt to branded/self-hosted installs, prefer applying `replaceInstallationName` from `shared/composables/useBranding` in the UI layer (for example tooltip and suggestion labels) instead of adding hardcoded brand-specific copy.
+
+# Ralph Agent Instructions
+
+You are an autonomous coding agent working on a software project.
+
+## Your Task
+
+1. Read the PRD at `prd.json` (in the same directory as this file)
+2. Read the progress log at `progress.txt` (check Codebase Patterns section first)
+3. Check you're on the correct branch from PRD `branchName`. If not, check it out or create from main.
+4. Pick the **highest priority** user story where `passes: false`
+5. Implement that single user story
+6. Run quality checks (e.g., typecheck, lint, test - use whatever your project requires)
+7. Update CLAUDE.md files if you discover reusable patterns (see below)
+8. If checks pass, commit ALL changes with message: `feat: [Story ID] - [Story Title]`
+9. Update the PRD to set `passes: true` for the completed story
+10. Append your progress to `progress.txt`
+
+## Progress Report Format
+
+APPEND to progress.txt (never replace, always append):
+```
+## [Date/Time] - [Story ID]
+- What was implemented
+- Files changed
+- **Learnings for future iterations:**
+  - Patterns discovered (e.g., "this codebase uses X for Y")
+  - Gotchas encountered (e.g., "don't forget to update Z when changing W")
+  - Useful context (e.g., "the evaluation panel is in component X")
+---
+```
+
+The learnings section is critical - it helps future iterations avoid repeating mistakes and understand the codebase better.
+
+## Consolidate Patterns
+
+If you discover a **reusable pattern** that future iterations should know, add it to the `## Codebase Patterns` section at the TOP of progress.txt (create it if it doesn't exist). This section should consolidate the most important learnings:
+
+```
+## Codebase Patterns
+- Example: Use `sql<number>` template for aggregations
+- Example: Always use `IF NOT EXISTS` for migrations
+- Example: Export types from actions.ts for UI components
+```
+
+Only add patterns that are **general and reusable**, not story-specific details.
+
+## Update CLAUDE.md Files
+
+Before committing, check if any edited files have learnings worth preserving in nearby CLAUDE.md files:
+
+1. **Identify directories with edited files** - Look at which directories you modified
+2. **Check for existing CLAUDE.md** - Look for CLAUDE.md in those directories or parent directories
+3. **Add valuable learnings** - If you discovered something future developers/agents should know:
+   - API patterns or conventions specific to that module
+   - Gotchas or non-obvious requirements
+   - Dependencies between files
+   - Testing approaches for that area
+   - Configuration or environment requirements
+
+**Examples of good CLAUDE.md additions:**
+- "When modifying X, also update Y to keep them in sync"
+- "This module uses pattern Z for all API calls"
+- "Tests require the dev server running on PORT 3000"
+- "Field names must match the template exactly"
+
+**Do NOT add:**
+- Story-specific implementation details
+- Temporary debugging notes
+- Information already in progress.txt
+
+Only update CLAUDE.md if you have **genuinely reusable knowledge** that would help future work in that directory.
+
+## Quality Requirements
+
+- ALL commits must pass your project's quality checks (typecheck, lint, test)
+- Do NOT commit broken code
+- Keep changes focused and minimal
+- Follow existing code patterns
+
+## Browser Testing (If Available)
+
+For any story that changes UI, verify it works in the browser if you have browser testing tools configured (e.g., via MCP):
+
+1. Navigate to the relevant page
+2. Verify the UI changes work as expected
+3. Take a screenshot if helpful for the progress log
+
+If no browser tools are available, note in your progress report that manual browser verification is needed.
+
+## Stop Condition
+
+After completing a user story, check if ALL stories have `passes: true`.
+
+If ALL stories are complete and passing, reply with:
+<promise>COMPLETE</promise>
+
+If there are still stories with `passes: false`, end your response normally (another iteration will pick up the next story).
+
+## Important
+
+- Work on ONE story per iteration
+- Commit frequently
+- Keep CI green
+- Read the Codebase Patterns section in progress.txt before starting
diff --git a/app/controllers/api/v1/accounts/contacts/group_invites_controller.rb b/app/controllers/api/v1/accounts/contacts/group_invites_controller.rb
new file mode 100644
index 0000000000000..7bc304f350c1d
--- /dev/null
+++ b/app/controllers/api/v1/accounts/contacts/group_invites_controller.rb
@@ -0,0 +1,33 @@
+class Api::V1::Accounts::Contacts::GroupInvitesController < Api::V1::Accounts::Contacts::BaseController
+  def show
+    authorize @contact, :show?
+    code = channel.group_invite_code(@contact.identifier)
+    render json: invite_response(code)
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  def revoke
+    authorize @contact, :update?
+    code = channel.revoke_group_invite(@contact.identifier)
+    render json: invite_response(code)
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  private
+
+  def channel
+    @channel ||= group_conversation.inbox.channel
+  end
+
+  def group_conversation
+    @group_conversation ||= Current.account.conversations
+                                   .where(contact_id: @contact.id, group_type: :group, status: %i[open pending])
+                                   .first
+  end
+
+  def invite_response(code)
+    { invite_code: code, invite_url: "https://chat.whatsapp.com/#{code}" }
+  end
+end
diff --git a/app/controllers/api/v1/accounts/contacts/group_join_requests_controller.rb b/app/controllers/api/v1/accounts/contacts/group_join_requests_controller.rb
new file mode 100644
index 0000000000000..1b69ea751cdd8
--- /dev/null
+++ b/app/controllers/api/v1/accounts/contacts/group_join_requests_controller.rb
@@ -0,0 +1,29 @@
+class Api::V1::Accounts::Contacts::GroupJoinRequestsController < Api::V1::Accounts::Contacts::BaseController
+  def index
+    authorize @contact, :show?
+    requests = channel.group_join_requests(@contact.identifier)
+    render json: { payload: requests }
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  def handle
+    authorize @contact, :update?
+    channel.handle_group_join_requests(@contact.identifier, params[:participants], params[:request_action])
+    head :ok
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  private
+
+  def channel
+    @channel ||= group_conversation.inbox.channel
+  end
+
+  def group_conversation
+    @group_conversation ||= Current.account.conversations
+                                   .where(contact_id: @contact.id, group_type: :group, status: %i[open pending])
+                                   .first
+  end
+end
diff --git a/app/controllers/api/v1/accounts/contacts/group_members_controller.rb b/app/controllers/api/v1/accounts/contacts/group_members_controller.rb
index 40943efe240af..a66af5266cbef 100644
--- a/app/controllers/api/v1/accounts/contacts/group_members_controller.rb
+++ b/app/controllers/api/v1/accounts/contacts/group_members_controller.rb
@@ -5,7 +5,7 @@ def index
     Contacts::SyncGroupService.new(contact: @contact).perform
 
     conversations = Current.account.conversations
-                           .where(contact_id: @contact.id, conversation_type: :group, status: %i[open pending])
+                           .where(contact_id: @contact.id, group_type: :group, status: %i[open pending])
 
     @group_members = ConversationGroupMember.active
                                             .where(conversation: conversations)
@@ -13,4 +13,77 @@ def index
   rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
     render_internal_server_error(e.message)
   end
+
+  def create
+    authorize @contact, :update?
+
+    channel.update_group_participants(@contact.identifier, format_participants(params[:participants]), 'add')
+    add_group_members(params[:participants])
+    head :ok
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  def update
+    authorize @contact, :update?
+
+    member = group_conversation_members.find(params[:member_id])
+    action = params[:role] == 'admin' ? 'promote' : 'demote'
+    channel.update_group_participants(@contact.identifier, [jid_for_member(member)], action)
+    member.update!(role: params[:role])
+    head :ok
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  def destroy
+    authorize @contact, :update?
+
+    member = group_conversation_members.find(params[:id])
+    channel.update_group_participants(@contact.identifier, [jid_for_member(member)], 'remove')
+    member.update!(is_active: false)
+    head :ok
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  private
+
+  def group_conversation
+    @group_conversation ||= Current.account.conversations
+                                   .where(contact_id: @contact.id, group_type: :group, status: %i[open pending])
+                                   .first
+  end
+
+  def group_conversation_members
+    ConversationGroupMember.where(conversation: group_conversation)
+  end
+
+  def channel
+    group_conversation.inbox.channel
+  end
+
+  def format_participants(phone_numbers)
+    Array(phone_numbers).map { |phone| "#{phone.to_s.delete('+')}@s.whatsapp.net" }
+  end
+
+  def jid_for_member(member)
+    "#{member.contact.phone_number.to_s.delete('+')}@s.whatsapp.net"
+  end
+
+  def add_group_members(phone_numbers)
+    inbox = group_conversation.inbox
+    Array(phone_numbers).each do |phone|
+      normalized = phone.start_with?('+') ? phone : "+#{phone}"
+      contact_inbox = ::ContactInboxWithContactBuilder.new(
+        source_id: normalized.delete('+'),
+        inbox: inbox,
+        contact_attributes: { name: normalized, phone_number: normalized }
+      ).perform
+      next if contact_inbox.blank?
+
+      member = ConversationGroupMember.find_or_initialize_by(conversation: group_conversation, contact: contact_inbox.contact)
+      member.update!(role: :member, is_active: true) unless member.persisted? && member.is_active?
+    end
+  end
 end
diff --git a/app/controllers/api/v1/accounts/contacts/group_metadata_controller.rb b/app/controllers/api/v1/accounts/contacts/group_metadata_controller.rb
new file mode 100644
index 0000000000000..8354a087c09c4
--- /dev/null
+++ b/app/controllers/api/v1/accounts/contacts/group_metadata_controller.rb
@@ -0,0 +1,32 @@
+class Api::V1::Accounts::Contacts::GroupMetadataController < Api::V1::Accounts::Contacts::BaseController
+  def update
+    authorize @contact, :update?
+    update_subject if params[:subject].present?
+    update_description if params[:description].present?
+    render json: { id: @contact.id, name: @contact.name, additional_attributes: @contact.additional_attributes }
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  private
+
+  def update_subject
+    channel.update_group_subject(@contact.identifier, params[:subject])
+    @contact.update!(name: params[:subject])
+  end
+
+  def update_description
+    channel.update_group_description(@contact.identifier, params[:description])
+    @contact.update!(additional_attributes: @contact.additional_attributes.merge('description' => params[:description]))
+  end
+
+  def channel
+    @channel ||= group_conversation.inbox.channel
+  end
+
+  def group_conversation
+    @group_conversation ||= Current.account.conversations
+                                   .where(contact_id: @contact.id, group_type: :group, status: %i[open pending])
+                                   .first
+  end
+end
diff --git a/app/controllers/api/v1/accounts/contacts_controller.rb b/app/controllers/api/v1/accounts/contacts_controller.rb
index c3b9f638db0f6..871fdd92cc38e 100644
--- a/app/controllers/api/v1/accounts/contacts_controller.rb
+++ b/app/controllers/api/v1/accounts/contacts_controller.rb
@@ -85,7 +85,7 @@ def destroy_custom_attributes
   def sync_group
     authorize @contact, :sync_group?
     @contact = Contacts::SyncGroupService.new(contact: @contact).perform
-    group_conversation = @contact.conversations.where(conversation_type: :group, status: %i[open pending]).order(created_at: :desc).first
+    group_conversation = @contact.conversations.where(group_type: :group, status: %i[open pending]).order(created_at: :desc).first
     @group_members = group_conversation ? ConversationGroupMember.active.where(conversation: group_conversation).includes(:contact) : []
   rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
     render_internal_server_error(e.message)
diff --git a/app/controllers/api/v1/accounts/groups_controller.rb b/app/controllers/api/v1/accounts/groups_controller.rb
new file mode 100644
index 0000000000000..6f453fe5264ce
--- /dev/null
+++ b/app/controllers/api/v1/accounts/groups_controller.rb
@@ -0,0 +1,20 @@
+class Api::V1::Accounts::GroupsController < Api::V1::Accounts::BaseController
+  def create
+    inbox = Current.account.inboxes.find_by(id: params[:inbox_id])
+    return render json: { error: 'Access Denied' }, status: :forbidden unless inbox_accessible?(inbox)
+
+    @conversation = Groups::CreateService.new(
+      inbox: inbox,
+      subject: params[:subject],
+      participants: Array(params[:participants])
+    ).perform
+  rescue Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError => e
+    render json: { error: e.message }, status: :unprocessable_entity
+  end
+
+  private
+
+  def inbox_accessible?(inbox)
+    inbox.present? && Current.user.assigned_inboxes.exists?(id: inbox.id)
+  end
+end
diff --git a/app/finders/conversation_finder.rb b/app/finders/conversation_finder.rb
index d43ed31e787ac..cd4f91206557f 100644
--- a/app/finders/conversation_finder.rb
+++ b/app/finders/conversation_finder.rb
@@ -64,6 +64,7 @@ def set_up
 
     find_all_conversations
     filter_by_status unless params[:q]
+    filter_by_group_type
     filter_by_team
     filter_by_labels
     filter_by_query
@@ -118,6 +119,12 @@ def filter_by_assignee_type
     @conversations
   end
 
+  def filter_by_group_type
+    return unless params[:group_type].present? && params[:group_type] != 'all'
+
+    @conversations = @conversations.where(group_type: params[:group_type])
+  end
+
   def filter_by_conversation_type
     case @params[:conversation_type]
     when 'mention'
diff --git a/app/helpers/filters/filter_helper.rb b/app/helpers/filters/filter_helper.rb
index fe03dae289219..2bf4929159e0a 100644
--- a/app/helpers/filters/filter_helper.rb
+++ b/app/helpers/filters/filter_helper.rb
@@ -100,6 +100,10 @@ def conversation_priority_values(values)
     values.map { |x| Conversation.priorities[x.to_sym] }
   end
 
+  def conversation_group_type_values(values)
+    values.map { |x| Conversation.group_types[x.to_sym] }
+  end
+
   def message_type_values(values)
     values.map { |x| Message.message_types[x.to_sym] }
   end
diff --git a/app/javascript/dashboard/api/groupMembers.js b/app/javascript/dashboard/api/groupMembers.js
new file mode 100644
index 0000000000000..937b83357589a
--- /dev/null
+++ b/app/javascript/dashboard/api/groupMembers.js
@@ -0,0 +1,61 @@
+/* global axios */
+import ApiClient from './ApiClient';
+
+class GroupMembersAPI extends ApiClient {
+  constructor() {
+    super('contacts', { accountScoped: true });
+  }
+
+  getGroupMembers(contactId) {
+    return axios.get(`${this.url}/${contactId}/group_members`);
+  }
+
+  syncGroup(contactId) {
+    return axios.get(`${this.url}/${contactId}/sync_group`);
+  }
+
+  createGroup(params) {
+    return axios.post(`${this.baseUrl()}/groups`, params);
+  }
+
+  updateGroupMetadata(contactId, params) {
+    return axios.patch(`${this.url}/${contactId}/group_metadata`, params);
+  }
+
+  addMembers(contactId, participants) {
+    return axios.post(`${this.url}/${contactId}/group_members`, {
+      participants,
+    });
+  }
+
+  removeMembers(contactId, memberId) {
+    return axios.delete(`${this.url}/${contactId}/group_members/${memberId}`);
+  }
+
+  updateMemberRole(contactId, memberId, role) {
+    return axios.patch(`${this.url}/${contactId}/group_members/${memberId}`, {
+      role,
+    });
+  }
+
+  getInviteLink(contactId) {
+    return axios.get(`${this.url}/${contactId}/group_invite`);
+  }
+
+  revokeInviteLink(contactId) {
+    return axios.post(`${this.url}/${contactId}/group_invite/revoke`);
+  }
+
+  getPendingRequests(contactId) {
+    return axios.get(`${this.url}/${contactId}/group_join_requests`);
+  }
+
+  handleJoinRequest(contactId, params) {
+    return axios.post(
+      `${this.url}/${contactId}/group_join_requests/handle`,
+      params
+    );
+  }
+}
+
+export default new GroupMembersAPI();
diff --git a/app/javascript/dashboard/api/inbox/conversation.js b/app/javascript/dashboard/api/inbox/conversation.js
index f94fca4529f92..ea2802cae4af5 100644
--- a/app/javascript/dashboard/api/inbox/conversation.js
+++ b/app/javascript/dashboard/api/inbox/conversation.js
@@ -16,6 +16,7 @@ class ConversationApi extends ApiClient {
     conversationType,
     sortBy,
     updatedWithin,
+    groupType,
   }) {
     return axios.get(this.url, {
       params: {
@@ -28,6 +29,7 @@ class ConversationApi extends ApiClient {
         conversation_type: conversationType,
         sort_by: sortBy,
         updated_within: updatedWithin,
+        group_type: groupType,
       },
     });
   }
diff --git a/app/javascript/dashboard/components-next/filter/helper/filterHelper.js b/app/javascript/dashboard/components-next/filter/helper/filterHelper.js
index 274eecb49511f..c0317975e3603 100644
--- a/app/javascript/dashboard/components-next/filter/helper/filterHelper.js
+++ b/app/javascript/dashboard/components-next/filter/helper/filterHelper.js
@@ -14,6 +14,7 @@ export const CONVERSATION_ATTRIBUTES = {
   REFERER: 'referer',
   CREATED_AT: 'created_at',
   LAST_ACTIVITY_AT: 'last_activity_at',
+  GROUP_TYPE: 'group_type',
 };
 
 export const CONTACT_ATTRIBUTES = {
diff --git a/app/javascript/dashboard/components-next/filter/provider.js b/app/javascript/dashboard/components-next/filter/provider.js
index fc418b1327dfb..82c7eafa7d963 100644
--- a/app/javascript/dashboard/components-next/filter/provider.js
+++ b/app/javascript/dashboard/components-next/filter/provider.js
@@ -247,6 +247,20 @@ export function useConversationFilterContext() {
       filterOperators: dateOperators.value,
       attributeModel: 'standard',
     },
+    {
+      attributeKey: CONVERSATION_ATTRIBUTES.GROUP_TYPE,
+      value: CONVERSATION_ATTRIBUTES.GROUP_TYPE,
+      attributeName: t('FILTER.ATTRIBUTES.GROUP_TYPE'),
+      label: t('FILTER.ATTRIBUTES.GROUP_TYPE'),
+      inputType: 'multiSelect',
+      options: ['individual', 'group'].map(id => ({
+        id,
+        name: t(`GROUP.FILTER.${id.toUpperCase()}`),
+      })),
+      dataType: 'text',
+      filterOperators: equalityOperators.value,
+      attributeModel: 'standard',
+    },
     ...customFilterTypes.value,
   ]);
 
diff --git a/app/javascript/dashboard/components/ChatList.vue b/app/javascript/dashboard/components/ChatList.vue
index 3b2a66929ff09..1fbc00e185467 100644
--- a/app/javascript/dashboard/components/ChatList.vue
+++ b/app/javascript/dashboard/components/ChatList.vue
@@ -98,6 +98,7 @@ provide('contextMenuElementTarget', conversationDynamicScroller);
 const activeAssigneeTab = ref(wootConstants.ASSIGNEE_TYPE.ME);
 const activeStatus = ref(wootConstants.STATUS_TYPE.OPEN);
 const activeSortBy = ref(wootConstants.SORT_BY_TYPE.LAST_ACTIVITY_AT_DESC);
+const activeGroupType = ref('');
 const showAdvancedFilters = ref(false);
 // chatsOnView is to store the chats that are currently visible on the screen,
 // which mirrors the conversationList.
@@ -285,6 +286,7 @@ const conversationFilters = computed(() => {
     labels: props.label ? [props.label] : undefined,
     teamId: props.teamId || undefined,
     conversationType: props.conversationType || undefined,
+    groupType: activeGroupType.value || undefined,
   };
 });
 
@@ -373,13 +375,14 @@ const uniqueInboxes = computed(() => {
 // ---------------------- Methods -----------------------
 function setFiltersFromUISettings() {
   const { conversations_filter_by: filterBy = {} } = uiSettings.value;
-  const { status, order_by: orderBy } = filterBy;
+  const { status, order_by: orderBy, group_type: groupType } = filterBy;
   activeStatus.value = status || wootConstants.STATUS_TYPE.OPEN;
   activeSortBy.value = Object.values(wootConstants.SORT_BY_TYPE).includes(
     orderBy
   )
     ? orderBy
     : wootConstants.SORT_BY_TYPE.LAST_ACTIVITY_AT_DESC;
+  activeGroupType.value = groupType || '';
 }
 
 function emitConversationLoaded() {
@@ -488,6 +491,10 @@ function setParamsForEditFolderModal() {
       { id: 'high', name: t('CONVERSATION.PRIORITY.OPTIONS.HIGH') },
       { id: 'urgent', name: t('CONVERSATION.PRIORITY.OPTIONS.URGENT') },
     ],
+    group_type: [
+      { id: 'individual', name: t('GROUP.FILTER.INDIVIDUAL') },
+      { id: 'group', name: t('GROUP.FILTER.GROUP') },
+    ],
     filterTypes: advancedFilterTypes.value,
     allCustomAttributes: conversationCustomAttributes.value,
   };
@@ -632,6 +639,8 @@ function updateAssigneeTab(selectedTab) {
 function onBasicFilterChange(value, type) {
   if (type === 'status') {
     activeStatus.value = value;
+  } else if (type === 'group_type') {
+    activeGroupType.value = value;
   } else {
     activeSortBy.value = value;
   }
@@ -829,6 +838,7 @@ onMounted(() => {
   setFiltersFromUISettings();
   store.dispatch('setChatStatusFilter', activeStatus.value);
   store.dispatch('setChatSortFilter', activeSortBy.value);
+  store.dispatch('setChatGroupTypeFilter', activeGroupType.value);
   resetAndFetchData();
   if (hasActiveFolders.value) {
     store.dispatch('campaigns/get');
diff --git a/app/javascript/dashboard/components/widgets/conversation/ConversationBasicFilter.vue b/app/javascript/dashboard/components/widgets/conversation/ConversationBasicFilter.vue
index d699923f57539..199b3a0cea117 100644
--- a/app/javascript/dashboard/components/widgets/conversation/ConversationBasicFilter.vue
+++ b/app/javascript/dashboard/components/widgets/conversation/ConversationBasicFilter.vue
@@ -25,6 +25,7 @@ const { updateUISettings } = useUISettings();
 
 const chatStatusFilter = useMapGetter('getChatStatusFilter');
 const chatSortFilter = useMapGetter('getChatSortFilter');
+const chatGroupTypeFilter = useMapGetter('getChatGroupTypeFilter');
 
 const [showActionsDropdown, toggleDropdown] = useToggle();
 
@@ -38,6 +39,8 @@ const currentSortBy = computed(() => {
   );
 });
 
+const currentGroupType = computed(() => chatGroupTypeFilter.value || '');
+
 const chatStatusOptions = computed(() => [
   {
     label: t('CHAT_LIST.CHAT_STATUS_FILTER_ITEMS.open.TEXT'),
@@ -96,6 +99,12 @@ const chatSortOptions = computed(() => [
   },
 ]);
 
+const chatGroupTypeOptions = computed(() => [
+  { label: t('GROUP.FILTER.ALL'), value: '' },
+  { label: t('GROUP.FILTER.INDIVIDUAL'), value: 'individual' },
+  { label: t('GROUP.FILTER.GROUP'), value: 'group' },
+]);
+
 const activeChatStatusLabel = computed(
   () =>
     chatStatusOptions.value.find(m => m.value === chatStatusFilter.value)
@@ -108,11 +117,18 @@ const activeChatSortLabel = computed(
     ''
 );
 
+const activeGroupTypeLabel = computed(
+  () =>
+    chatGroupTypeOptions.value.find(m => m.value === chatGroupTypeFilter.value)
+      ?.label || t('GROUP.FILTER.ALL')
+);
+
 const saveSelectedFilter = (type, value) => {
   updateUISettings({
     conversations_filter_by: {
       status: type === 'status' ? value : currentStatusFilter.value,
       order_by: type === 'sort' ? value : currentSortBy.value,
+      group_type: type === 'group_type' ? value : currentGroupType.value,
     },
   });
 };
@@ -128,6 +144,12 @@ const handleSortChange = value => {
   store.dispatch('setChatSortFilter', value);
   saveSelectedFilter('sort', value);
 };
+
+const handleGroupTypeChange = value => {
+  emit('changeFilter', value, 'group_type');
+  store.dispatch('setChatGroupTypeFilter', value);
+  saveSelectedFilter('group_type', value);
+};
 </script>
 
 <template>
@@ -173,6 +195,18 @@ const handleSortChange = value => {
           @update:model-value="handleSortChange"
         />
       </div>
+      <div class="flex items-center justify-between last:mt-4 gap-2">
+        <span class="text-sm truncate text-n-slate-12">
+          {{ $t('GROUP.FILTER.TYPE_LABEL') }}
+        </span>
+        <SelectMenu
+          :model-value="chatGroupTypeFilter"
+          :options="chatGroupTypeOptions"
+          :label="activeGroupTypeLabel"
+          :sub-menu-position="isOnExpandedLayout ? 'left' : 'right'"
+          @update:model-value="handleGroupTypeChange"
+        />
+      </div>
     </div>
   </div>
 </template>
diff --git a/app/javascript/dashboard/components/widgets/conversation/advancedFilterItems/index.js b/app/javascript/dashboard/components/widgets/conversation/advancedFilterItems/index.js
index 2c3c2fd13503f..b3d26e0f017f4 100644
--- a/app/javascript/dashboard/components/widgets/conversation/advancedFilterItems/index.js
+++ b/app/javascript/dashboard/components/widgets/conversation/advancedFilterItems/index.js
@@ -110,6 +110,14 @@ const filterTypes = [
     filterOperators: OPERATOR_TYPES_5,
     attributeModel: 'standard',
   },
+  {
+    attributeKey: 'group_type',
+    attributeI18nKey: 'GROUP_TYPE',
+    inputType: 'multi_select',
+    dataType: 'text',
+    filterOperators: OPERATOR_TYPES_1,
+    attributeModel: 'standard',
+  },
 ];
 
 export const filterAttributeGroups = [
@@ -153,6 +161,10 @@ export const filterAttributeGroups = [
         key: 'last_activity_at',
         i18nKey: 'LAST_ACTIVITY',
       },
+      {
+        key: 'group_type',
+        i18nKey: 'GROUP_TYPE',
+      },
     ],
   },
   {
diff --git a/app/javascript/dashboard/helper/automationHelper.js b/app/javascript/dashboard/helper/automationHelper.js
index 206501f19df4b..7de9b3ba385a4 100644
--- a/app/javascript/dashboard/helper/automationHelper.js
+++ b/app/javascript/dashboard/helper/automationHelper.js
@@ -151,6 +151,10 @@ export const getConditionOptions = ({
     country_code: countries,
     message_type: messageTypeOptions,
     priority: priorityOptions,
+    group_type: [
+      { id: 'individual', name: 'Individual' },
+      { id: 'group', name: 'Group' },
+    ],
     labels: generateConditionOptions(labels, 'title'),
   };
 
diff --git a/app/javascript/dashboard/helper/customViewsHelper.js b/app/javascript/dashboard/helper/customViewsHelper.js
index c837ce613d69f..414b046b3254d 100644
--- a/app/javascript/dashboard/helper/customViewsHelper.js
+++ b/app/javascript/dashboard/helper/customViewsHelper.js
@@ -73,6 +73,10 @@ const getValuesForPriority = (values, priority) => {
   return priority.filter(option => values.includes(option.id));
 };
 
+const getValuesForGroupType = (values, groupType) => {
+  return groupType.filter(option => values.includes(option.id));
+};
+
 export const getValuesForFilter = (filter, params) => {
   const { attribute_key, values } = filter;
   const {
@@ -84,6 +88,7 @@ export const getValuesForFilter = (filter, params) => {
     campaigns,
     labels,
     priority,
+    group_type: groupType,
   } = params;
   switch (attribute_key) {
     case 'status':
@@ -104,6 +109,8 @@ export const getValuesForFilter = (filter, params) => {
       return getValuesForLanguages(values, languages);
     case 'country_code':
       return getValuesForCountries(values, countries);
+    case 'group_type':
+      return getValuesForGroupType(values, groupType);
     default:
       return { id: values[0], name: values[0] };
   }
diff --git a/app/javascript/dashboard/i18n/locale/en/advancedFilters.json b/app/javascript/dashboard/i18n/locale/en/advancedFilters.json
index a991cb25bce28..ab022c8c93a89 100644
--- a/app/javascript/dashboard/i18n/locale/en/advancedFilters.json
+++ b/app/javascript/dashboard/i18n/locale/en/advancedFilters.json
@@ -62,7 +62,8 @@
       "CUSTOM_ATTRIBUTE_LINK": "Link",
       "CUSTOM_ATTRIBUTE_CHECKBOX": "Checkbox",
       "CREATED_AT": "Created at",
-      "LAST_ACTIVITY": "Last activity"
+      "LAST_ACTIVITY": "Last activity",
+      "GROUP_TYPE": "Group type"
     },
     "ERRORS": {
       "VALUE_REQUIRED": "Value is required",
diff --git a/app/javascript/dashboard/i18n/locale/en/groups.json b/app/javascript/dashboard/i18n/locale/en/groups.json
new file mode 100644
index 0000000000000..9bbc1137bb58e
--- /dev/null
+++ b/app/javascript/dashboard/i18n/locale/en/groups.json
@@ -0,0 +1,77 @@
+{
+  "GROUP": {
+    "SIDEBAR_TITLE": "Group",
+    "INFO": {
+      "HEADER": "Group Info",
+      "MEMBER_COUNT": "{count} members",
+      "MEMBER_LIST_TITLE": "Members",
+      "ADMIN_BADGE": "Admin",
+      "SYNC_BUTTON": "Sync",
+      "SYNC_SUCCESS": "Group members synced successfully.",
+      "SYNC_ERROR": "Failed to sync group members. Please try again.",
+      "EMPTY_STATE": "No members found."
+    },
+    "FILTER": {
+      "TYPE_LABEL": "Type",
+      "ALL": "All",
+      "INDIVIDUAL": "Individual",
+      "GROUP": "Group"
+    },
+    "CREATE": {
+      "TITLE": "Create New Group",
+      "INBOX_LABEL": "Inbox",
+      "INBOX_PLACEHOLDER": "Select a WhatsApp inbox",
+      "NAME_LABEL": "Group Name",
+      "NAME_PLACEHOLDER": "Enter group name",
+      "PARTICIPANTS_LABEL": "Participants",
+      "PARTICIPANTS_PLACEHOLDER": "Search contacts to add",
+      "SUBMIT_BUTTON": "Create Group",
+      "SUCCESS_MESSAGE": "Group created successfully.",
+      "ERROR_MESSAGE": "Failed to create group. Please try again."
+    },
+    "METADATA": {
+      "EDIT_NAME_LABEL": "Group Name",
+      "EDIT_NAME_PLACEHOLDER": "Enter group name",
+      "EDIT_DESCRIPTION_LABEL": "Description",
+      "EDIT_DESCRIPTION_PLACEHOLDER": "Enter group description",
+      "EDIT_AVATAR_LABEL": "Group Photo",
+      "SAVE_SUCCESS": "Group info updated successfully.",
+      "SAVE_ERROR": "Failed to update group info. Please try again."
+    },
+    "INVITE": {
+      "SECTION_TITLE": "Invite Link",
+      "COPY_BUTTON": "Copy Link",
+      "COPY_SUCCESS": "Invite link copied to clipboard.",
+      "REVOKE_BUTTON": "Revoke & Regenerate",
+      "REVOKE_SUCCESS": "Invite link revoked and regenerated.",
+      "REVOKE_ERROR": "Failed to revoke invite link. Please try again.",
+      "FETCH_ERROR": "Failed to load invite link."
+    },
+    "MEMBERS": {
+      "ADD_BUTTON": "Add Member",
+      "ADD_SUCCESS": "Member added successfully.",
+      "ADD_ERROR": "Failed to add member. Please try again.",
+      "REMOVE_BUTTON": "Remove",
+      "REMOVE_SUCCESS": "Member removed successfully.",
+      "REMOVE_ERROR": "Failed to remove member. Please try again.",
+      "PROMOTE_BUTTON": "Promote to Admin",
+      "PROMOTE_SUCCESS": "Member promoted to admin.",
+      "PROMOTE_ERROR": "Failed to promote member. Please try again.",
+      "DEMOTE_BUTTON": "Demote to Member",
+      "DEMOTE_SUCCESS": "Member demoted to member.",
+      "DEMOTE_ERROR": "Failed to demote member. Please try again."
+    },
+    "JOIN_REQUESTS": {
+      "SECTION_TITLE": "Pending Requests",
+      "PENDING_COUNT": "{count} pending",
+      "APPROVE_BUTTON": "Approve",
+      "REJECT_BUTTON": "Reject",
+      "APPROVE_SUCCESS": "Join request approved.",
+      "REJECT_SUCCESS": "Join request rejected.",
+      "ACTION_ERROR": "Failed to process join request. Please try again."
+    },
+    "MENTION": {
+      "DROPDOWN_HEADER": "Group Members"
+    }
+  }
+}
diff --git a/app/javascript/dashboard/i18n/locale/en/index.js b/app/javascript/dashboard/i18n/locale/en/index.js
index a55f541658585..9d8225bb67432 100644
--- a/app/javascript/dashboard/i18n/locale/en/index.js
+++ b/app/javascript/dashboard/i18n/locale/en/index.js
@@ -1,4 +1,5 @@
 import advancedFilters from './advancedFilters.json';
+import groups from './groups.json';
 import agentBots from './agentBots.json';
 import agentMgmt from './agentMgmt.json';
 import attributesMgmt from './attributesMgmt.json';
@@ -42,6 +43,7 @@ import yearInReview from './yearInReview.json';
 
 export default {
   ...advancedFilters,
+  ...groups,
   ...agentBots,
   ...agentMgmt,
   ...attributesMgmt,
diff --git a/app/javascript/dashboard/i18n/locale/pt_BR/advancedFilters.json b/app/javascript/dashboard/i18n/locale/pt_BR/advancedFilters.json
index 7958f4c145858..e8fd5d3b03da5 100644
--- a/app/javascript/dashboard/i18n/locale/pt_BR/advancedFilters.json
+++ b/app/javascript/dashboard/i18n/locale/pt_BR/advancedFilters.json
@@ -62,7 +62,8 @@
       "CUSTOM_ATTRIBUTE_LINK": "Link",
       "CUSTOM_ATTRIBUTE_CHECKBOX": "Checkbox",
       "CREATED_AT": "Criado em",
-      "LAST_ACTIVITY": "Última atividade"
+      "LAST_ACTIVITY": "Última atividade",
+      "GROUP_TYPE": "Tipo de conversa"
     },
     "ERRORS": {
       "VALUE_REQUIRED": "Valor obrigatório",
diff --git a/app/javascript/dashboard/i18n/locale/pt_BR/groups.json b/app/javascript/dashboard/i18n/locale/pt_BR/groups.json
new file mode 100644
index 0000000000000..94021bf52a0fb
--- /dev/null
+++ b/app/javascript/dashboard/i18n/locale/pt_BR/groups.json
@@ -0,0 +1,77 @@
+{
+  "GROUP": {
+    "SIDEBAR_TITLE": "Grupo",
+    "INFO": {
+      "HEADER": "Informações do Grupo",
+      "MEMBER_COUNT": "{count} membros",
+      "MEMBER_LIST_TITLE": "Membros",
+      "ADMIN_BADGE": "Admin",
+      "SYNC_BUTTON": "Sincronizar",
+      "SYNC_SUCCESS": "Membros do grupo sincronizados com sucesso.",
+      "SYNC_ERROR": "Falha ao sincronizar membros do grupo. Por favor, tente novamente.",
+      "EMPTY_STATE": "Nenhum membro encontrado."
+    },
+    "FILTER": {
+      "TYPE_LABEL": "Tipo",
+      "ALL": "Todos",
+      "INDIVIDUAL": "Individual",
+      "GROUP": "Grupo"
+    },
+    "CREATE": {
+      "TITLE": "Criar Novo Grupo",
+      "INBOX_LABEL": "Caixa de entrada",
+      "INBOX_PLACEHOLDER": "Selecione uma caixa de entrada do WhatsApp",
+      "NAME_LABEL": "Nome do Grupo",
+      "NAME_PLACEHOLDER": "Digite o nome do grupo",
+      "PARTICIPANTS_LABEL": "Participantes",
+      "PARTICIPANTS_PLACEHOLDER": "Pesquisar contatos para adicionar",
+      "SUBMIT_BUTTON": "Criar Grupo",
+      "SUCCESS_MESSAGE": "Grupo criado com sucesso.",
+      "ERROR_MESSAGE": "Falha ao criar grupo. Por favor, tente novamente."
+    },
+    "METADATA": {
+      "EDIT_NAME_LABEL": "Nome do Grupo",
+      "EDIT_NAME_PLACEHOLDER": "Digite o nome do grupo",
+      "EDIT_DESCRIPTION_LABEL": "Descrição",
+      "EDIT_DESCRIPTION_PLACEHOLDER": "Digite a descrição do grupo",
+      "EDIT_AVATAR_LABEL": "Foto do Grupo",
+      "SAVE_SUCCESS": "Informações do grupo atualizadas com sucesso.",
+      "SAVE_ERROR": "Falha ao atualizar informações do grupo. Por favor, tente novamente."
+    },
+    "INVITE": {
+      "SECTION_TITLE": "Link de Convite",
+      "COPY_BUTTON": "Copiar Link",
+      "COPY_SUCCESS": "Link de convite copiado para a área de transferência.",
+      "REVOKE_BUTTON": "Revogar e Regenerar",
+      "REVOKE_SUCCESS": "Link de convite revogado e regenerado.",
+      "REVOKE_ERROR": "Falha ao revogar o link de convite. Por favor, tente novamente.",
+      "FETCH_ERROR": "Falha ao carregar o link de convite."
+    },
+    "MEMBERS": {
+      "ADD_BUTTON": "Adicionar Membro",
+      "ADD_SUCCESS": "Membro adicionado com sucesso.",
+      "ADD_ERROR": "Falha ao adicionar membro. Por favor, tente novamente.",
+      "REMOVE_BUTTON": "Remover",
+      "REMOVE_SUCCESS": "Membro removido com sucesso.",
+      "REMOVE_ERROR": "Falha ao remover membro. Por favor, tente novamente.",
+      "PROMOTE_BUTTON": "Promover a Admin",
+      "PROMOTE_SUCCESS": "Membro promovido a admin.",
+      "PROMOTE_ERROR": "Falha ao promover membro. Por favor, tente novamente.",
+      "DEMOTE_BUTTON": "Rebaixar para Membro",
+      "DEMOTE_SUCCESS": "Membro rebaixado para membro.",
+      "DEMOTE_ERROR": "Falha ao rebaixar membro. Por favor, tente novamente."
+    },
+    "JOIN_REQUESTS": {
+      "SECTION_TITLE": "Solicitações Pendentes",
+      "PENDING_COUNT": "{count} pendentes",
+      "APPROVE_BUTTON": "Aprovar",
+      "REJECT_BUTTON": "Rejeitar",
+      "APPROVE_SUCCESS": "Solicitação de entrada aprovada.",
+      "REJECT_SUCCESS": "Solicitação de entrada rejeitada.",
+      "ACTION_ERROR": "Falha ao processar solicitação de entrada. Por favor, tente novamente."
+    },
+    "MENTION": {
+      "DROPDOWN_HEADER": "Membros do Grupo"
+    }
+  }
+}
diff --git a/app/javascript/dashboard/i18n/locale/pt_BR/index.js b/app/javascript/dashboard/i18n/locale/pt_BR/index.js
index 213387d0cab9b..4cf5ff2ca0533 100644
--- a/app/javascript/dashboard/i18n/locale/pt_BR/index.js
+++ b/app/javascript/dashboard/i18n/locale/pt_BR/index.js
@@ -1,4 +1,5 @@
 import advancedFilters from './advancedFilters.json';
+import groups from './groups.json';
 import agentBots from './agentBots.json';
 import agentMgmt from './agentMgmt.json';
 import attributesMgmt from './attributesMgmt.json';
@@ -38,6 +39,7 @@ import whatsappTemplates from './whatsappTemplates.json';
 
 export default {
   ...advancedFilters,
+  ...groups,
   ...agentBots,
   ...agentMgmt,
   ...attributesMgmt,
diff --git a/app/javascript/dashboard/routes/dashboard/conversation/ContactPanel.vue b/app/javascript/dashboard/routes/dashboard/conversation/ContactPanel.vue
index c148625fa35c4..fb5c063294e7c 100644
--- a/app/javascript/dashboard/routes/dashboard/conversation/ContactPanel.vue
+++ b/app/javascript/dashboard/routes/dashboard/conversation/ContactPanel.vue
@@ -14,6 +14,7 @@ import ContactConversations from './ContactConversations.vue';
 import ConversationAction from './ConversationAction.vue';
 import ConversationParticipant from './ConversationParticipant.vue';
 import ContactInfo from './contact/ContactInfo.vue';
+import GroupContactInfo from './contact/GroupContactInfo.vue';
 import ContactNotes from './contact/ContactNotes.vue';
 import ScheduledMessages from './scheduledMessages/ScheduledMessages.vue';
 import ConversationInfo from './ConversationInfo.vue';
@@ -88,6 +89,14 @@ const conversationAdditionalAttributes = computed(
 );
 
 const channelType = computed(() => currentChat.value.meta?.channel);
+const isGroupConversation = computed(
+  () => currentChat.value.group_type === 'group'
+);
+const sidebarTitle = computed(() =>
+  isGroupConversation.value
+    ? 'GROUP.INFO.SIDEBAR_TITLE'
+    : 'CONVERSATION.SIDEBAR.CONTACT'
+);
 
 const contactGetter = useMapGetter('contacts/getContact');
 const contactId = computed(() => currentChat.value.meta?.sender?.id);
@@ -134,10 +143,11 @@ onMounted(() => {
 <template>
   <div class="w-full">
     <SidebarActionsHeader
-      :title="$t('CONVERSATION.SIDEBAR.CONTACT')"
+      :title="$t(sidebarTitle)"
       @close="closeContactPanel"
     />
-    <ContactInfo :contact="contact" :channel-type="channelType" />
+    <GroupContactInfo v-if="isGroupConversation" :contact="contact" />
+    <ContactInfo v-else :contact="contact" :channel-type="channelType" />
     <div class="px-2 pb-8 list-group">
       <Draggable
         :list="conversationSidebarItems"
diff --git a/app/javascript/dashboard/routes/dashboard/conversation/contact/GroupContactInfo.vue b/app/javascript/dashboard/routes/dashboard/conversation/contact/GroupContactInfo.vue
new file mode 100644
index 0000000000000..93ea058cbce97
--- /dev/null
+++ b/app/javascript/dashboard/routes/dashboard/conversation/contact/GroupContactInfo.vue
@@ -0,0 +1,133 @@
+<script setup>
+import { computed, onMounted } from 'vue';
+import { useStore, useMapGetter } from 'dashboard/composables/store';
+import { useAlert } from 'dashboard/composables';
+import { useI18n } from 'vue-i18n';
+import Avatar from 'next/avatar/Avatar.vue';
+import NextButton from 'dashboard/components-next/button/Button.vue';
+
+const props = defineProps({
+  contact: {
+    type: Object,
+    default: () => ({}),
+  },
+});
+
+const store = useStore();
+const { t } = useI18n();
+const uiFlags = useMapGetter('groupMembers/getUIFlags');
+const getGroupMembers = useMapGetter('groupMembers/getGroupMembers');
+
+const members = computed(() => {
+  const allMembers = getGroupMembers.value(props.contact.id) || [];
+  return allMembers.filter(m => m.is_active);
+});
+
+const memberCount = computed(() => members.value.length);
+
+const isFetching = computed(() => uiFlags.value.isFetching);
+const isSyncing = computed(() => uiFlags.value.isSyncing);
+
+const onSync = async () => {
+  try {
+    await store.dispatch('groupMembers/sync', {
+      contactId: props.contact.id,
+    });
+    useAlert(t('GROUP.INFO.SYNC_SUCCESS'));
+  } catch {
+    useAlert(t('GROUP.INFO.SYNC_ERROR'));
+  }
+};
+
+onMounted(() => {
+  if (props.contact.id) {
+    store.dispatch('groupMembers/fetch', { contactId: props.contact.id });
+  }
+});
+</script>
+
+<template>
+  <div class="relative items-center w-full p-4">
+    <div class="flex flex-col w-full gap-2 text-left rtl:text-right">
+      <!-- Group header: avatar, name, member count -->
+      <div class="flex flex-row items-start gap-3">
+        <Avatar
+          :src="contact.thumbnail"
+          :name="contact.name"
+          :size="48"
+          rounded-full
+        />
+        <div class="flex flex-col min-w-0">
+          <h3
+            class="my-0 text-base font-medium capitalize break-words text-n-slate-12"
+          >
+            {{ contact.name }}
+          </h3>
+          <span class="text-sm text-n-slate-11">
+            {{ t('GROUP.INFO.MEMBER_COUNT', { count: memberCount }) }}
+          </span>
+        </div>
+      </div>
+
+      <!-- Members section -->
+      <div class="mt-3">
+        <div class="flex items-center justify-between mb-2">
+          <h4 class="text-sm font-semibold text-n-slate-11">
+            {{ t('GROUP.INFO.MEMBER_LIST_TITLE') }}
+          </h4>
+          <NextButton
+            :label="t('GROUP.INFO.SYNC_BUTTON')"
+            icon="i-lucide-refresh-cw"
+            variant="ghost"
+            size="xs"
+            :is-loading="isSyncing"
+            :disabled="isSyncing"
+            @click="onSync"
+          />
+        </div>
+
+        <!-- Skeleton loading -->
+        <div v-if="isFetching" class="flex flex-col gap-3">
+          <div v-for="i in 4" :key="i" class="flex items-center gap-3">
+            <div class="rounded-full size-8 bg-n-slate-3 animate-pulse" />
+            <div class="flex flex-col flex-1 gap-1">
+              <div class="w-2/5 h-4 rounded bg-n-slate-3 animate-pulse" />
+            </div>
+          </div>
+        </div>
+
+        <!-- Empty state -->
+        <p v-else-if="members.length === 0" class="text-sm text-n-slate-11">
+          {{ t('GROUP.INFO.EMPTY_STATE') }}
+        </p>
+
+        <!-- Member list -->
+        <div v-else class="flex flex-col gap-2">
+          <div
+            v-for="member in members"
+            :key="member.id"
+            class="flex items-center gap-3 py-1"
+          >
+            <Avatar
+              :src="member.contact.thumbnail"
+              :name="member.contact.name"
+              :size="32"
+              rounded-full
+            />
+            <div class="flex items-center flex-1 min-w-0 gap-2">
+              <span class="text-sm truncate text-n-slate-12">
+                {{ member.contact.name }}
+              </span>
+              <span
+                v-if="member.role === 'admin'"
+                class="px-1.5 py-0.5 text-xs font-medium rounded bg-n-amber-3 text-n-amber-11"
+              >
+                {{ t('GROUP.INFO.ADMIN_BADGE') }}
+              </span>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
diff --git a/app/javascript/dashboard/store/index.js b/app/javascript/dashboard/store/index.js
index 1b150c916f3db..af17fca8d0edf 100755
--- a/app/javascript/dashboard/store/index.js
+++ b/app/javascript/dashboard/store/index.js
@@ -32,6 +32,7 @@ import customViews from './modules/customViews';
 import dashboardApps from './modules/dashboardApps';
 import draftMessages from './modules/draftMessages';
 import globalConfig from 'shared/store/globalConfig';
+import groupMembers from './modules/groupMembers';
 import inboxAssignableAgents from './modules/inboxAssignableAgents';
 import inboxes from './modules/inboxes';
 import inboxMembers from './modules/inboxMembers';
@@ -96,6 +97,7 @@ export default createStore({
     dashboardApps,
     draftMessages,
     globalConfig,
+    groupMembers,
     inboxAssignableAgents,
     inboxes,
     inboxMembers,
diff --git a/app/javascript/dashboard/store/modules/conversations/actions.js b/app/javascript/dashboard/store/modules/conversations/actions.js
index 1bc6e8aae136f..0aed3c6c37f66 100644
--- a/app/javascript/dashboard/store/modules/conversations/actions.js
+++ b/app/javascript/dashboard/store/modules/conversations/actions.js
@@ -440,6 +440,10 @@ const actions = {
     commit(types.CHANGE_CHAT_SORT_FILTER, data);
   },
 
+  setChatGroupTypeFilter({ commit }, data) {
+    commit(types.CHANGE_CHAT_GROUP_TYPE_FILTER, data);
+  },
+
   updateAssignee({ commit }, data) {
     commit(types.UPDATE_ASSIGNEE, data);
   },
diff --git a/app/javascript/dashboard/store/modules/conversations/getters.js b/app/javascript/dashboard/store/modules/conversations/getters.js
index 9f5744fbbcb4b..bad4a58146849 100644
--- a/app/javascript/dashboard/store/modules/conversations/getters.js
+++ b/app/javascript/dashboard/store/modules/conversations/getters.js
@@ -141,6 +141,7 @@ const getters = {
   },
   getChatStatusFilter: ({ chatStatusFilter }) => chatStatusFilter,
   getChatSortFilter: ({ chatSortFilter }) => chatSortFilter,
+  getChatGroupTypeFilter: ({ chatGroupTypeFilter }) => chatGroupTypeFilter,
   getSelectedInbox: ({ currentInbox }) => currentInbox,
   getConversationById: _state => conversationId => {
     return _state.allConversations.find(
diff --git a/app/javascript/dashboard/store/modules/conversations/index.js b/app/javascript/dashboard/store/modules/conversations/index.js
index 84be116fe9fd7..838d8c22fbd75 100644
--- a/app/javascript/dashboard/store/modules/conversations/index.js
+++ b/app/javascript/dashboard/store/modules/conversations/index.js
@@ -14,6 +14,7 @@ const state = {
   listLoadingStatus: true,
   chatStatusFilter: wootConstants.STATUS_TYPE.OPEN,
   chatSortFilter: wootConstants.SORT_BY_TYPE.LATEST,
+  chatGroupTypeFilter: '',
   currentInbox: null,
   selectedChatId: null,
   appliedFilters: [],
@@ -285,6 +286,10 @@ export const mutations = {
     _state.chatSortFilter = data;
   },
 
+  [types.CHANGE_CHAT_GROUP_TYPE_FILTER](_state, data) {
+    _state.chatGroupTypeFilter = data;
+  },
+
   // Update assignee on action cable message
   [types.UPDATE_ASSIGNEE](_state, payload) {
     const chat = getConversationById(_state)(payload.id);
diff --git a/app/javascript/dashboard/store/modules/groupMembers.js b/app/javascript/dashboard/store/modules/groupMembers.js
new file mode 100644
index 0000000000000..75cc7d059a50d
--- /dev/null
+++ b/app/javascript/dashboard/store/modules/groupMembers.js
@@ -0,0 +1,106 @@
+import types from '../mutation-types';
+import GroupMembersAPI from '../../api/groupMembers';
+
+export const state = {
+  records: {},
+  uiFlags: {
+    isFetching: false,
+    isSyncing: false,
+    isUpdating: false,
+  },
+};
+
+export const getters = {
+  getGroupMembers: _state => contactId => {
+    return _state.records[contactId] || [];
+  },
+  getUIFlags(_state) {
+    return _state.uiFlags;
+  },
+};
+
+export const actions = {
+  async fetch({ commit }, { contactId }) {
+    commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isFetching: true });
+    try {
+      const { data } = await GroupMembersAPI.getGroupMembers(contactId);
+      commit(types.SET_GROUP_MEMBERS, { contactId, members: data.payload });
+    } catch (error) {
+      throw new Error(error);
+    } finally {
+      commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isFetching: false });
+    }
+  },
+
+  async sync({ commit, dispatch }, { contactId }) {
+    commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isSyncing: true });
+    try {
+      await GroupMembersAPI.syncGroup(contactId);
+      await dispatch('fetch', { contactId });
+    } catch (error) {
+      throw new Error(error);
+    } finally {
+      commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isSyncing: false });
+    }
+  },
+
+  async addMembers({ commit, dispatch }, { contactId, participants }) {
+    commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isUpdating: true });
+    try {
+      await GroupMembersAPI.addMembers(contactId, participants);
+      await dispatch('fetch', { contactId });
+    } catch (error) {
+      throw new Error(error);
+    } finally {
+      commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isUpdating: false });
+    }
+  },
+
+  async removeMembers({ commit, dispatch }, { contactId, memberId }) {
+    commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isUpdating: true });
+    try {
+      await GroupMembersAPI.removeMembers(contactId, memberId);
+      await dispatch('fetch', { contactId });
+    } catch (error) {
+      throw new Error(error);
+    } finally {
+      commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isUpdating: false });
+    }
+  },
+
+  async updateMemberRole({ commit, dispatch }, { contactId, memberId, role }) {
+    commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isUpdating: true });
+    try {
+      await GroupMembersAPI.updateMemberRole(contactId, memberId, role);
+      await dispatch('fetch', { contactId });
+    } catch (error) {
+      throw new Error(error);
+    } finally {
+      commit(types.SET_GROUP_MEMBERS_UI_FLAG, { isUpdating: false });
+    }
+  },
+};
+
+export const mutations = {
+  [types.SET_GROUP_MEMBERS_UI_FLAG](_state, data) {
+    _state.uiFlags = {
+      ..._state.uiFlags,
+      ...data,
+    };
+  },
+
+  [types.SET_GROUP_MEMBERS](_state, { contactId, members }) {
+    _state.records = {
+      ..._state.records,
+      [contactId]: members,
+    };
+  },
+};
+
+export default {
+  namespaced: true,
+  state,
+  getters,
+  actions,
+  mutations,
+};
diff --git a/app/javascript/dashboard/store/modules/groupMembers.spec.js b/app/javascript/dashboard/store/modules/groupMembers.spec.js
new file mode 100644
index 0000000000000..65d05f80a420a
--- /dev/null
+++ b/app/javascript/dashboard/store/modules/groupMembers.spec.js
@@ -0,0 +1,140 @@
+import axios from 'axios';
+import { actions, getters, mutations, state } from './groupMembers';
+import * as types from '../mutation-types';
+
+const commit = vi.fn();
+const dispatch = vi.fn();
+global.axios = axios;
+vi.mock('axios');
+vi.mock('../../api/groupMembers', () => ({
+  default: {
+    getGroupMembers: vi.fn(),
+    syncGroup: vi.fn(),
+    addMembers: vi.fn(),
+    removeMembers: vi.fn(),
+    updateMemberRole: vi.fn(),
+  },
+}));
+
+import GroupMembersAPI from '../../api/groupMembers';
+
+const sampleMembers = [
+  { id: 1, role: 'admin', is_active: true, contact: { id: 10, name: 'Alice' } },
+  { id: 2, role: 'member', is_active: true, contact: { id: 11, name: 'Bob' } },
+];
+
+describe('groupMembers store', () => {
+  beforeEach(() => {
+    commit.mockClear();
+    dispatch.mockClear();
+  });
+
+  describe('getters', () => {
+    it('getGroupMembers returns members for a contactId', () => {
+      const localState = { records: { 42: sampleMembers } };
+      expect(getters.getGroupMembers(localState)(42)).toEqual(sampleMembers);
+    });
+
+    it('getGroupMembers returns empty array for unknown contactId', () => {
+      const localState = { records: {} };
+      expect(getters.getGroupMembers(localState)(99)).toEqual([]);
+    });
+
+    it('getUIFlags returns uiFlags', () => {
+      const localState = {
+        uiFlags: { isFetching: true, isSyncing: false, isUpdating: false },
+      };
+      expect(getters.getUIFlags(localState)).toEqual(localState.uiFlags);
+    });
+  });
+
+  describe('mutations', () => {
+    it('SET_GROUP_MEMBERS_UI_FLAG merges flags', () => {
+      const localState = { ...state };
+      mutations[types.default.SET_GROUP_MEMBERS_UI_FLAG](localState, {
+        isFetching: true,
+      });
+      expect(localState.uiFlags.isFetching).toBe(true);
+    });
+
+    it('SET_GROUP_MEMBERS stores members keyed by contactId', () => {
+      const localState = { records: {} };
+      mutations[types.default.SET_GROUP_MEMBERS](localState, {
+        contactId: 42,
+        members: sampleMembers,
+      });
+      expect(localState.records[42]).toEqual(sampleMembers);
+    });
+  });
+
+  describe('actions', () => {
+    describe('fetch', () => {
+      it('commits SET_GROUP_MEMBERS on success', async () => {
+        GroupMembersAPI.getGroupMembers.mockResolvedValue({
+          data: { payload: sampleMembers },
+        });
+        await actions.fetch({ commit }, { contactId: 42 });
+        expect(commit.mock.calls).toEqual([
+          [types.default.SET_GROUP_MEMBERS_UI_FLAG, { isFetching: true }],
+          [
+            types.default.SET_GROUP_MEMBERS,
+            { contactId: 42, members: sampleMembers },
+          ],
+          [types.default.SET_GROUP_MEMBERS_UI_FLAG, { isFetching: false }],
+        ]);
+      });
+
+      it('throws on API error', async () => {
+        GroupMembersAPI.getGroupMembers.mockRejectedValue(new Error('fail'));
+        await expect(
+          actions.fetch({ commit }, { contactId: 42 })
+        ).rejects.toThrow(Error);
+      });
+    });
+
+    describe('sync', () => {
+      it('calls syncGroup and then re-fetches on success', async () => {
+        GroupMembersAPI.syncGroup.mockResolvedValue({});
+        dispatch.mockResolvedValue();
+        await actions.sync({ commit, dispatch }, { contactId: 42 });
+        expect(dispatch).toHaveBeenCalledWith('fetch', { contactId: 42 });
+      });
+    });
+
+    describe('addMembers', () => {
+      it('calls addMembers and re-fetches on success', async () => {
+        GroupMembersAPI.addMembers.mockResolvedValue({});
+        dispatch.mockResolvedValue();
+        await actions.addMembers(
+          { commit, dispatch },
+          { contactId: 42, participants: ['+5511999'] }
+        );
+        expect(dispatch).toHaveBeenCalledWith('fetch', { contactId: 42 });
+      });
+    });
+
+    describe('removeMembers', () => {
+      it('calls removeMembers and re-fetches on success', async () => {
+        GroupMembersAPI.removeMembers.mockResolvedValue({});
+        dispatch.mockResolvedValue();
+        await actions.removeMembers(
+          { commit, dispatch },
+          { contactId: 42, memberId: 1 }
+        );
+        expect(dispatch).toHaveBeenCalledWith('fetch', { contactId: 42 });
+      });
+    });
+
+    describe('updateMemberRole', () => {
+      it('calls updateMemberRole and re-fetches on success', async () => {
+        GroupMembersAPI.updateMemberRole.mockResolvedValue({});
+        dispatch.mockResolvedValue();
+        await actions.updateMemberRole(
+          { commit, dispatch },
+          { contactId: 42, memberId: 1, role: 'admin' }
+        );
+        expect(dispatch).toHaveBeenCalledWith('fetch', { contactId: 42 });
+      });
+    });
+  });
+});
diff --git a/app/javascript/dashboard/store/mutation-types.js b/app/javascript/dashboard/store/mutation-types.js
index 26e33cdd2ec62..602e7d1c91365 100644
--- a/app/javascript/dashboard/store/mutation-types.js
+++ b/app/javascript/dashboard/store/mutation-types.js
@@ -18,6 +18,7 @@ export default {
   CLEAR_ALL_MESSAGES_LOADED: 'CLEAR_ALL_MESSAGES_LOADED',
   CHANGE_CHAT_STATUS_FILTER: 'CHANGE_CHAT_STATUS_FILTER',
   CHANGE_CHAT_SORT_FILTER: 'CHANGE_CHAT_SORT_FILTER',
+  CHANGE_CHAT_GROUP_TYPE_FILTER: 'CHANGE_CHAT_GROUP_TYPE_FILTER',
   UPDATE_ASSIGNEE: 'UPDATE_ASSIGNEE',
   UPDATE_CONVERSATION_CONTACT: 'UPDATE_CONVERSATION_CONTACT',
   CLEAR_CONTACT_CONVERSATIONS: 'CLEAR_CONTACT_CONVERSATIONS',
@@ -237,6 +238,10 @@ export default {
   EDIT_CAMPAIGN: 'EDIT_CAMPAIGN',
   DELETE_CAMPAIGN: 'DELETE_CAMPAIGN',
 
+  // Group members
+  SET_GROUP_MEMBERS_UI_FLAG: 'SET_GROUP_MEMBERS_UI_FLAG',
+  SET_GROUP_MEMBERS: 'SET_GROUP_MEMBERS',
+
   // Contact notes
   SET_CONTACT_NOTES_UI_FLAG: 'SET_CONTACT_NOTES_UI_FLAG',
   SET_CONTACT_NOTES: 'SET_CONTACT_NOTES',
diff --git a/app/models/channel/whatsapp.rb b/app/models/channel/whatsapp.rb
index 5098f6d638020..d88fb9d172f3c 100644
--- a/app/models/channel/whatsapp.rb
+++ b/app/models/channel/whatsapp.rb
@@ -171,6 +171,14 @@ def sync_group(conversation)
   delegate :sync_templates, to: :provider_service
   delegate :media_url, to: :provider_service
   delegate :api_headers, to: :provider_service
+  delegate :create_group, to: :provider_service
+  delegate :update_group_subject, to: :provider_service
+  delegate :update_group_description, to: :provider_service
+  delegate :update_group_participants, to: :provider_service
+  delegate :group_invite_code, to: :provider_service
+  delegate :revoke_group_invite, to: :provider_service
+  delegate :group_join_requests, to: :provider_service
+  delegate :handle_group_join_requests, to: :provider_service
 
   def setup_webhooks
     perform_webhook_setup
diff --git a/app/models/concerns/group_conversation_handler.rb b/app/models/concerns/group_conversation_handler.rb
index 592f20cc9fa11..04f3cb243eac0 100644
--- a/app/models/concerns/group_conversation_handler.rb
+++ b/app/models/concerns/group_conversation_handler.rb
@@ -60,7 +60,7 @@ def find_or_create_group_conversation(group_contact_inbox)
       inbox_id: inbox.id,
       contact_id: group_contact_inbox.contact_id,
       contact_inbox_id: group_contact_inbox.id,
-      conversation_type: :group
+      group_type: :group
     )
   end
 
diff --git a/app/models/conversation.rb b/app/models/conversation.rb
index 3ce4552d7d570..af685f2692e43 100644
--- a/app/models/conversation.rb
+++ b/app/models/conversation.rb
@@ -8,9 +8,9 @@
 #  assignee_last_seen_at  :datetime
 #  cached_label_list      :text
 #  contact_last_seen_at   :datetime
-#  conversation_type      :integer          default("individual"), not null
 #  custom_attributes      :jsonb
 #  first_reply_created_at :datetime
+#  group_type             :integer          default("individual"), not null
 #  identifier             :string
 #  last_activity_at       :datetime         not null
 #  priority               :integer
@@ -28,30 +28,36 @@
 #  contact_inbox_id       :bigint
 #  display_id             :integer          not null
 #  inbox_id               :integer          not null
+#  kanban_task_id         :bigint
 #  sla_policy_id          :bigint
 #  team_id                :bigint
 #
 # Indexes
 #
-#  conv_acid_inbid_stat_asgnid_idx                          (account_id,inbox_id,status,assignee_id)
-#  index_conversations_on_account_id                        (account_id)
-#  index_conversations_on_account_id_and_conversation_type  (account_id,conversation_type)
-#  index_conversations_on_account_id_and_display_id         (account_id,display_id) UNIQUE
-#  index_conversations_on_assignee_id_and_account_id        (assignee_id,account_id)
-#  index_conversations_on_campaign_id                       (campaign_id)
-#  index_conversations_on_contact_id                        (contact_id)
-#  index_conversations_on_contact_inbox_id                  (contact_inbox_id)
-#  index_conversations_on_first_reply_created_at            (first_reply_created_at)
-#  index_conversations_on_id_and_account_id                 (account_id,id)
-#  index_conversations_on_identifier_and_account_id         (identifier,account_id)
-#  index_conversations_on_inbox_id                          (inbox_id)
-#  index_conversations_on_inbox_id_and_conversation_type    (inbox_id,conversation_type)
-#  index_conversations_on_priority                          (priority)
-#  index_conversations_on_status_and_account_id             (status,account_id)
-#  index_conversations_on_status_and_priority               (status,priority)
-#  index_conversations_on_team_id                           (team_id)
-#  index_conversations_on_uuid                              (uuid) UNIQUE
-#  index_conversations_on_waiting_since                     (waiting_since)
+#  conv_acid_inbid_stat_asgnid_idx                    (account_id,inbox_id,status,assignee_id)
+#  index_conversations_on_account_id                  (account_id)
+#  index_conversations_on_account_id_and_display_id   (account_id,display_id) UNIQUE
+#  index_conversations_on_account_id_and_group_type   (account_id,group_type)
+#  index_conversations_on_assignee_id_and_account_id  (assignee_id,account_id)
+#  index_conversations_on_campaign_id                 (campaign_id)
+#  index_conversations_on_contact_id                  (contact_id)
+#  index_conversations_on_contact_inbox_id            (contact_inbox_id)
+#  index_conversations_on_first_reply_created_at      (first_reply_created_at)
+#  index_conversations_on_id_and_account_id           (account_id,id)
+#  index_conversations_on_identifier_and_account_id   (identifier,account_id)
+#  index_conversations_on_inbox_id                    (inbox_id)
+#  index_conversations_on_inbox_id_and_group_type     (inbox_id,group_type)
+#  index_conversations_on_kanban_task_id              (kanban_task_id)
+#  index_conversations_on_priority                    (priority)
+#  index_conversations_on_status_and_account_id       (status,account_id)
+#  index_conversations_on_status_and_priority         (status,priority)
+#  index_conversations_on_team_id                     (team_id)
+#  index_conversations_on_uuid                        (uuid) UNIQUE
+#  index_conversations_on_waiting_since               (waiting_since)
+#
+# Foreign Keys
+#
+#  fk_rails_...  (kanban_task_id => kanban_tasks.id)
 #
 
 class Conversation < ApplicationRecord
@@ -77,7 +83,7 @@ class Conversation < ApplicationRecord
 
   enum status: { open: 0, resolved: 1, pending: 2, snoozed: 3 }
   enum priority: { low: 0, medium: 1, high: 2, urgent: 3 }
-  enum conversation_type: { individual: 0, group: 1 }, _prefix: true
+  enum group_type: { individual: 0, group: 1 }, _prefix: true
 
   scope :unassigned, -> { where(assignee_id: nil) }
   scope :assigned, -> { where.not(assignee_id: nil) }
diff --git a/app/services/filter_service.rb b/app/services/filter_service.rb
index e4cef7941215c..2bf86e6bd6b56 100644
--- a/app/services/filter_service.rb
+++ b/app/services/filter_service.rb
@@ -48,6 +48,7 @@ def filter_values(query_hash)
 
     return conversation_status_values(values) if attribute_key == 'status'
     return conversation_priority_values(values) if attribute_key == 'priority'
+    return conversation_group_type_values(values) if attribute_key == 'group_type'
     return message_type_values(values) if attribute_key == 'message_type'
     return downcase_array_values(values) if attribute_key == 'content'
 
diff --git a/app/services/groups/create_service.rb b/app/services/groups/create_service.rb
new file mode 100644
index 0000000000000..aa725b8805e49
--- /dev/null
+++ b/app/services/groups/create_service.rb
@@ -0,0 +1,62 @@
+class Groups::CreateService
+  pattr_initialize [:inbox!, :subject!, :participants!]
+
+  def perform
+    group_data = channel.create_group(subject, format_participants)
+    group_jid = group_data[:id]
+    raise Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Group JID missing from response' if group_jid.blank?
+
+    create_group_conversation(group_jid)
+  end
+
+  private
+
+  def channel
+    inbox.channel
+  end
+
+  def format_participants
+    participants.map { |phone| "#{phone.delete('+')}@s.whatsapp.net" }
+  end
+
+  def create_group_conversation(group_jid)
+    contact_inbox = ::ContactInboxWithContactBuilder.new(
+      source_id: group_jid,
+      inbox: inbox,
+      contact_attributes: {
+        name: subject,
+        identifier: group_jid,
+        group_type: :group
+      }
+    ).perform
+
+    conversation = contact_inbox.conversations.where(status: %i[open pending], group_type: :group).last
+    conversation ||= ::Conversation.create!(
+      account_id: inbox.account_id,
+      inbox_id: inbox.id,
+      contact_id: contact_inbox.contact_id,
+      contact_inbox_id: contact_inbox.id,
+      group_type: :group
+    )
+
+    add_initial_members(conversation, contact_inbox)
+    conversation
+  end
+
+  def add_initial_members(conversation, _group_contact_inbox)
+    return if participants.blank?
+
+    participants.each do |phone|
+      normalized = phone.start_with?('+') ? phone : "+#{phone}"
+      contact_inbox = ::ContactInboxWithContactBuilder.new(
+        source_id: normalized.delete('+'),
+        inbox: inbox,
+        contact_attributes: { name: normalized, phone_number: normalized }
+      ).perform
+      next if contact_inbox.blank?
+
+      member = ConversationGroupMember.find_or_initialize_by(conversation: conversation, contact: contact_inbox.contact)
+      member.update!(role: :member, is_active: true) unless member.persisted? && member.is_active?
+    end
+  end
+end
diff --git a/app/services/messages/mention_service.rb b/app/services/messages/mention_service.rb
index 43bc17fb84f11..1c4c72f67a2e7 100644
--- a/app/services/messages/mention_service.rb
+++ b/app/services/messages/mention_service.rb
@@ -2,7 +2,14 @@ class Messages::MentionService
   pattr_initialize [:message!]
 
   def perform
-    return unless valid_mention_message?(message)
+    process_user_team_mentions
+    process_contact_mentions
+  end
+
+  private
+
+  def process_user_team_mentions
+    return unless valid_user_mention_message?
 
     validated_mentioned_ids = filter_mentioned_ids_by_inbox
     return if validated_mentioned_ids.blank?
@@ -12,12 +19,23 @@ def perform
     add_mentioned_users_as_participants(validated_mentioned_ids)
   end
 
-  private
+  def process_contact_mentions
+    contact_ids = contact_mentioned_ids
+    return if contact_ids.blank?
 
-  def valid_mention_message?(message)
+    message.update!(content_attributes: message.content_attributes.merge('mentioned_contacts' => contact_ids))
+  end
+
+  def valid_user_mention_message?
     message.private? && message.content.present? && mentioned_ids.present?
   end
 
+  def contact_mentioned_ids
+    return [] if message.content.blank?
+
+    message.content.scan(%r{\(mention://contact/(\d+)/(.+?)\)}).map(&:first).uniq
+  end
+
   def mentioned_ids
     user_mentions = message.content.scan(%r{\(mention://user/(\d+)/(.+?)\)}).map(&:first)
     team_mentions = message.content.scan(%r{\(mention://team/(\d+)/(.+?)\)}).map(&:first)
diff --git a/app/services/whatsapp/providers/base_service.rb b/app/services/whatsapp/providers/base_service.rb
index 42a71367db968..9038bb1fac834 100644
--- a/app/services/whatsapp/providers/base_service.rb
+++ b/app/services/whatsapp/providers/base_service.rb
@@ -27,6 +27,38 @@ def validate_provider_config
     raise 'Overwrite this method in child class'
   end
 
+  def create_group(_subject, _participants)
+    raise 'Overwrite this method in child class'
+  end
+
+  def update_group_subject(_group_jid, _subject)
+    raise 'Overwrite this method in child class'
+  end
+
+  def update_group_description(_group_jid, _description)
+    raise 'Overwrite this method in child class'
+  end
+
+  def update_group_participants(_group_jid, _participants, _action)
+    raise 'Overwrite this method in child class'
+  end
+
+  def group_invite_code(_group_jid)
+    raise 'Overwrite this method in child class'
+  end
+
+  def revoke_group_invite(_group_jid)
+    raise 'Overwrite this method in child class'
+  end
+
+  def group_join_requests(_group_jid)
+    raise 'Overwrite this method in child class'
+  end
+
+  def handle_group_join_requests(_group_jid, _participants, _action)
+    raise 'Overwrite this method in child class'
+  end
+
   def error_message
     raise 'Overwrite this method in child class'
   end
diff --git a/app/services/whatsapp/providers/whatsapp_baileys_service.rb b/app/services/whatsapp/providers/whatsapp_baileys_service.rb
index 6bca69c2eaff8..df83d23d5f791 100644
--- a/app/services/whatsapp/providers/whatsapp_baileys_service.rb
+++ b/app/services/whatsapp/providers/whatsapp_baileys_service.rb
@@ -82,6 +82,98 @@ def send_template(phone_number, template_info); end
 
   def sync_templates; end
 
+  def create_group(subject, participants)
+    response = HTTParty.post(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-create",
+      headers: api_headers,
+      body: { subject: subject, participants: participants }.to_json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+
+    response.parsed_response&.deep_symbolize_keys
+  end
+
+  def update_group_subject(group_jid, subject)
+    response = HTTParty.patch(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-subject",
+      headers: api_headers,
+      body: { jid: group_jid, subject: subject }.to_json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+  end
+
+  def update_group_description(group_jid, description)
+    response = HTTParty.patch(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-description",
+      headers: api_headers,
+      body: { jid: group_jid, description: description }.to_json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+  end
+
+  def update_group_participants(group_jid, participants, action)
+    response = HTTParty.patch(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-participants",
+      headers: api_headers,
+      body: { jid: group_jid, participants: participants, action: action }.to_json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+
+    response.parsed_response
+  end
+
+  def group_invite_code(group_jid)
+    response = HTTParty.get(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-invite-code",
+      headers: api_headers,
+      query: { jid: group_jid },
+      format: :json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+
+    response.parsed_response&.dig('data', 'code')
+  end
+
+  def revoke_group_invite(group_jid)
+    response = HTTParty.post(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-revoke-invite",
+      headers: api_headers,
+      body: { jid: group_jid }.to_json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+
+    response.parsed_response&.dig('data', 'code')
+  end
+
+  def group_join_requests(group_jid)
+    response = HTTParty.get(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-join-requests",
+      headers: api_headers,
+      query: { jid: group_jid },
+      format: :json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+
+    response.parsed_response&.dig('data') || []
+  end
+
+  def handle_group_join_requests(group_jid, participants, action)
+    response = HTTParty.post(
+      "#{provider_url}/connections/#{whatsapp_channel.phone_number}/group-join-requests-handle",
+      headers: api_headers,
+      body: { jid: group_jid, participants: participants, action: action }.to_json
+    )
+
+    raise ProviderUnavailableError unless process_response(response)
+  end
+
   def sync_group(conversation)
     group_contact = conversation.contact
     inbox = conversation.inbox
diff --git a/app/views/api/v1/accounts/groups/create.json.jbuilder b/app/views/api/v1/accounts/groups/create.json.jbuilder
new file mode 100644
index 0000000000000..c273dd3c6a6af
--- /dev/null
+++ b/app/views/api/v1/accounts/groups/create.json.jbuilder
@@ -0,0 +1 @@
+json.partial! 'api/v1/conversations/partials/conversation', formats: [:json], conversation: @conversation
diff --git a/app/views/api/v1/conversations/partials/_conversation.json.jbuilder b/app/views/api/v1/conversations/partials/_conversation.json.jbuilder
index 4cb13f543baab..9ff9cd06ffe04 100644
--- a/app/views/api/v1/conversations/partials/_conversation.json.jbuilder
+++ b/app/views/api/v1/conversations/partials/_conversation.json.jbuilder
@@ -56,6 +56,7 @@ json.first_reply_created_at conversation.first_reply_created_at.to_i
 json.unread_count conversation.unread_incoming_messages.count
 json.last_non_activity_message conversation.messages.where(account_id: conversation.account_id).non_activity_messages.first.try(:push_event_data)
 json.last_activity_at conversation.last_activity_at.to_i
+json.group_type conversation.group_type
 json.priority conversation.priority
 json.waiting_since conversation.waiting_since.to_i.to_i
 json.sla_policy_id conversation.sla_policy_id
diff --git a/app/views/api/v1/models/_contact.json.jbuilder b/app/views/api/v1/models/_contact.json.jbuilder
index 809452a4511fd..a47fb9b4cbf5a 100644
--- a/app/views/api/v1/models/_contact.json.jbuilder
+++ b/app/views/api/v1/models/_contact.json.jbuilder
@@ -10,6 +10,7 @@ json.thumbnail resource.avatar_url
 json.custom_attributes resource.custom_attributes
 json.last_activity_at resource.last_activity_at.to_i if resource[:last_activity_at].present?
 json.created_at resource.created_at.to_i if resource[:created_at].present?
+json.group_type resource.group_type
 json.account_id resource.account_id
 # we only want to output contact inbox when its /contacts endpoints
 if defined?(with_contact_inboxes) && with_contact_inboxes.present?
diff --git a/config/routes.rb b/config/routes.rb
index a9890b36941f3..b0afb3cc7f679 100644
--- a/config/routes.rb
+++ b/config/routes.rb
@@ -175,6 +175,7 @@
               get :search
             end
           end
+          resources :groups, only: [:create]
           resources :contacts, only: [:index, :show, :update, :create, :destroy] do
             collection do
               get :active
@@ -192,7 +193,16 @@
             scope module: :contacts do
               resources :conversations, only: [:index]
               resources :contact_inboxes, only: [:create]
-              resources :group_members, only: [:index]
+              resources :group_members, only: [:index, :create, :destroy] do
+                patch ':member_id', to: 'group_members#update', on: :collection
+              end
+              resource :group_metadata, only: [:update]
+              resource :group_invite, only: [:show] do
+                post :revoke, on: :member
+              end
+              resources :group_join_requests, only: [:index] do
+                post :handle, on: :collection
+              end
               resources :labels, only: [:create, :index]
               resources :notes
               post :call, on: :member, to: 'calls#create' if ChatwootApp.enterprise?
diff --git a/db/migrate/20260227135739_rename_conversation_type_to_group_type_on_conversations.rb b/db/migrate/20260227135739_rename_conversation_type_to_group_type_on_conversations.rb
new file mode 100644
index 0000000000000..ae61095067e18
--- /dev/null
+++ b/db/migrate/20260227135739_rename_conversation_type_to_group_type_on_conversations.rb
@@ -0,0 +1,29 @@
+class RenameConversationTypeToGroupTypeOnConversations < ActiveRecord::Migration[7.1]
+  def up
+    rename_column :conversations, :conversation_type, :group_type
+
+    execute <<-SQL.squish
+      ALTER INDEX IF EXISTS index_conversations_on_account_id_and_conversation_type
+      RENAME TO index_conversations_on_account_id_and_group_type;
+    SQL
+
+    execute <<-SQL.squish
+      ALTER INDEX IF EXISTS index_conversations_on_inbox_id_and_conversation_type
+      RENAME TO index_conversations_on_inbox_id_and_group_type;
+    SQL
+  end
+
+  def down
+    rename_column :conversations, :group_type, :conversation_type
+
+    execute <<-SQL.squish
+      ALTER INDEX IF EXISTS index_conversations_on_account_id_and_group_type
+      RENAME TO index_conversations_on_account_id_and_conversation_type;
+    SQL
+
+    execute <<-SQL.squish
+      ALTER INDEX IF EXISTS index_conversations_on_inbox_id_and_group_type
+      RENAME TO index_conversations_on_inbox_id_and_conversation_type;
+    SQL
+  end
+end
diff --git a/db/schema.rb b/db/schema.rb
index f23aaea26e8cc..faa0cb4a9d9fb 100644
--- a/db/schema.rb
+++ b/db/schema.rb
@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.1].define(version: 2026_02_11_200624) do
+ActiveRecord::Schema[7.1].define(version: 2026_02_27_135739) do
   # These extensions should be enabled to support this database
   enable_extension "pg_stat_statements"
   enable_extension "pg_trgm"
@@ -591,7 +591,7 @@
     t.bigint "account_id", null: false
     t.datetime "created_at", null: false
     t.datetime "updated_at", null: false
-    t.integer "contacts_count"
+    t.integer "contacts_count", default: 0, null: false
     t.index ["account_id", "domain"], name: "index_companies_on_account_and_domain", unique: true, where: "(domain IS NOT NULL)"
     t.index ["account_id"], name: "index_companies_on_account_id"
     t.index ["name", "account_id"], name: "index_companies_on_name_and_account_id"
@@ -698,9 +698,10 @@
     t.datetime "waiting_since"
     t.text "cached_label_list"
     t.bigint "assignee_agent_bot_id"
-    t.integer "conversation_type", default: 0, null: false
-    t.index ["account_id", "conversation_type"], name: "index_conversations_on_account_id_and_conversation_type"
+    t.bigint "kanban_task_id"
+    t.integer "group_type", default: 0, null: false
     t.index ["account_id", "display_id"], name: "index_conversations_on_account_id_and_display_id", unique: true
+    t.index ["account_id", "group_type"], name: "index_conversations_on_account_id_and_group_type"
     t.index ["account_id", "id"], name: "index_conversations_on_id_and_account_id"
     t.index ["account_id", "inbox_id", "status", "assignee_id"], name: "conv_acid_inbid_stat_asgnid_idx"
     t.index ["account_id"], name: "index_conversations_on_account_id"
@@ -710,8 +711,9 @@
     t.index ["contact_inbox_id"], name: "index_conversations_on_contact_inbox_id"
     t.index ["first_reply_created_at"], name: "index_conversations_on_first_reply_created_at"
     t.index ["identifier", "account_id"], name: "index_conversations_on_identifier_and_account_id"
-    t.index ["inbox_id", "conversation_type"], name: "index_conversations_on_inbox_id_and_conversation_type"
+    t.index ["inbox_id", "group_type"], name: "index_conversations_on_inbox_id_and_group_type"
     t.index ["inbox_id"], name: "index_conversations_on_inbox_id"
+    t.index ["kanban_task_id"], name: "index_conversations_on_kanban_task_id"
     t.index ["priority"], name: "index_conversations_on_priority"
     t.index ["status", "account_id"], name: "index_conversations_on_status_and_account_id"
     t.index ["status", "priority"], name: "index_conversations_on_status_and_priority"
@@ -875,6 +877,18 @@
     t.index ["inbox_id"], name: "index_inbox_members_on_inbox_id"
   end
 
+  create_table "inbox_signatures", force: :cascade do |t|
+    t.bigint "user_id", null: false
+    t.bigint "inbox_id", null: false
+    t.text "message_signature", null: false
+    t.string "signature_position", default: "top", null: false
+    t.string "signature_separator", default: "blank", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["inbox_id"], name: "index_inbox_signatures_on_inbox_id"
+    t.index ["user_id", "inbox_id"], name: "index_inbox_signatures_on_user_id_and_inbox_id", unique: true
+  end
+
   create_table "inboxes", id: :serial, force: :cascade do |t|
     t.integer "channel_id", null: false
     t.integer "account_id", null: false
@@ -926,6 +940,121 @@
     t.jsonb "settings", default: {}
   end
 
+  create_table "kanban_account_user_preferences", force: :cascade do |t|
+    t.bigint "account_user_id", null: false
+    t.jsonb "preferences", default: {}, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["account_user_id"], name: "index_kanban_account_user_preferences_on_account_user_id", unique: true
+  end
+
+  create_table "kanban_audit_events", force: :cascade do |t|
+    t.bigint "account_id", null: false
+    t.bigint "task_id", null: false
+    t.bigint "performed_by_id"
+    t.string "action", null: false
+    t.jsonb "metadata", default: {}, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["account_id", "created_at"], name: "index_kanban_audit_events_on_account_id_and_created_at"
+    t.index ["account_id"], name: "index_kanban_audit_events_on_account_id"
+    t.index ["performed_by_id"], name: "index_kanban_audit_events_on_performed_by_id"
+    t.index ["task_id"], name: "index_kanban_audit_events_on_task_id"
+  end
+
+  create_table "kanban_board_agents", force: :cascade do |t|
+    t.bigint "board_id", null: false
+    t.bigint "agent_id", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["agent_id"], name: "index_kanban_board_agents_on_agent_id"
+    t.index ["board_id", "agent_id"], name: "index_kanban_board_agents_on_board_id_and_agent_id", unique: true
+    t.index ["board_id"], name: "index_kanban_board_agents_on_board_id"
+  end
+
+  create_table "kanban_board_inboxes", force: :cascade do |t|
+    t.bigint "board_id", null: false
+    t.bigint "inbox_id", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["board_id", "inbox_id"], name: "index_kanban_board_inboxes_on_board_id_and_inbox_id", unique: true
+    t.index ["board_id"], name: "index_kanban_board_inboxes_on_board_id"
+    t.index ["inbox_id"], name: "index_kanban_board_inboxes_on_inbox_id"
+  end
+
+  create_table "kanban_board_steps", force: :cascade do |t|
+    t.bigint "board_id", null: false
+    t.string "name", null: false
+    t.text "description"
+    t.string "color", default: "#475569", null: false
+    t.integer "tasks_count", default: 0, null: false
+    t.boolean "cancelled", default: false, null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["board_id"], name: "index_kanban_board_steps_on_board_id"
+  end
+
+  create_table "kanban_boards", force: :cascade do |t|
+    t.bigint "account_id", null: false
+    t.string "name", null: false
+    t.text "description"
+    t.jsonb "settings", default: {}, null: false
+    t.integer "steps_order", default: [], array: true
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["account_id", "created_at"], name: "index_kanban_boards_on_account_id_and_created_at"
+    t.index ["account_id", "name"], name: "index_kanban_boards_on_account_id_and_name", unique: true
+    t.index ["account_id", "updated_at"], name: "index_kanban_boards_on_account_id_and_updated_at"
+    t.index ["account_id"], name: "index_kanban_boards_on_account_id"
+  end
+
+  create_table "kanban_task_agents", force: :cascade do |t|
+    t.bigint "task_id", null: false
+    t.bigint "agent_id", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["agent_id"], name: "index_kanban_task_agents_on_agent_id"
+    t.index ["task_id", "agent_id"], name: "index_kanban_task_agents_on_task_id_and_agent_id", unique: true
+    t.index ["task_id"], name: "index_kanban_task_agents_on_task_id"
+  end
+
+  create_table "kanban_task_contacts", force: :cascade do |t|
+    t.bigint "task_id", null: false
+    t.bigint "contact_id", null: false
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["contact_id"], name: "index_kanban_task_contacts_on_contact_id"
+    t.index ["task_id", "contact_id"], name: "index_kanban_task_contacts_on_task_id_and_contact_id", unique: true
+    t.index ["task_id"], name: "index_kanban_task_contacts_on_task_id"
+  end
+
+  create_table "kanban_tasks", force: :cascade do |t|
+    t.bigint "account_id", null: false
+    t.bigint "board_id", null: false
+    t.bigint "board_step_id", null: false
+    t.bigint "created_by_id"
+    t.string "title", null: false
+    t.text "description"
+    t.string "priority"
+    t.datetime "start_date"
+    t.datetime "due_date"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.text "cached_label_list"
+    t.datetime "step_changed_at"
+    t.index ["account_id", "created_at"], name: "index_kanban_tasks_on_account_id_and_created_at"
+    t.index ["account_id"], name: "index_kanban_tasks_on_account_id"
+    t.index ["board_id", "board_step_id"], name: "index_kanban_tasks_on_board_id_and_board_step_id"
+    t.index ["board_id", "priority"], name: "index_kanban_tasks_on_board_id_and_priority"
+    t.index ["board_id"], name: "index_kanban_tasks_on_board_id"
+    t.index ["board_step_id", "created_at"], name: "index_kanban_tasks_on_step_and_created_at"
+    t.index ["board_step_id", "priority"], name: "index_kanban_tasks_on_board_step_id_and_priority"
+    t.index ["board_step_id"], name: "index_kanban_tasks_on_board_step_id"
+    t.index ["created_by_id"], name: "index_kanban_tasks_on_created_by_id"
+    t.index ["due_date"], name: "index_kanban_tasks_on_due_date"
+    t.index ["priority"], name: "index_kanban_tasks_on_priority"
+  end
+
   create_table "labels", force: :cascade do |t|
     t.string "title"
     t.text "description"
@@ -1278,7 +1407,7 @@
     t.text "message_signature"
     t.string "otp_secret"
     t.integer "consumed_timestep"
-    t.boolean "otp_required_for_login", default: false
+    t.boolean "otp_required_for_login", default: false, null: false
     t.text "otp_backup_codes"
     t.index ["email"], name: "index_users_on_email"
     t.index ["otp_required_for_login"], name: "index_users_on_otp_required_for_login"
@@ -1320,7 +1449,26 @@
   add_foreign_key "active_storage_variant_records", "active_storage_blobs", column: "blob_id"
   add_foreign_key "conversation_group_members", "contacts"
   add_foreign_key "conversation_group_members", "conversations"
+  add_foreign_key "conversations", "kanban_tasks"
   add_foreign_key "inboxes", "portals"
+  add_foreign_key "kanban_account_user_preferences", "account_users"
+  add_foreign_key "kanban_audit_events", "accounts"
+  add_foreign_key "kanban_audit_events", "kanban_tasks", column: "task_id"
+  add_foreign_key "kanban_audit_events", "users", column: "performed_by_id"
+  add_foreign_key "kanban_board_agents", "kanban_boards", column: "board_id"
+  add_foreign_key "kanban_board_agents", "users", column: "agent_id"
+  add_foreign_key "kanban_board_inboxes", "inboxes"
+  add_foreign_key "kanban_board_inboxes", "kanban_boards", column: "board_id"
+  add_foreign_key "kanban_board_steps", "kanban_boards", column: "board_id"
+  add_foreign_key "kanban_boards", "accounts"
+  add_foreign_key "kanban_task_agents", "kanban_tasks", column: "task_id"
+  add_foreign_key "kanban_task_agents", "users", column: "agent_id"
+  add_foreign_key "kanban_task_contacts", "contacts"
+  add_foreign_key "kanban_task_contacts", "kanban_tasks", column: "task_id"
+  add_foreign_key "kanban_tasks", "accounts"
+  add_foreign_key "kanban_tasks", "kanban_board_steps", column: "board_step_id"
+  add_foreign_key "kanban_tasks", "kanban_boards", column: "board_id"
+  add_foreign_key "kanban_tasks", "users", column: "created_by_id", on_delete: :nullify
   add_foreign_key "scheduled_messages", "accounts"
   add_foreign_key "scheduled_messages", "conversations"
   add_foreign_key "scheduled_messages", "inboxes"
diff --git a/lib/filters/filter_keys.yml b/lib/filters/filter_keys.yml
index bfaf393257155..3334e36bb118f 100644
--- a/lib/filters/filter_keys.yml
+++ b/lib/filters/filter_keys.yml
@@ -94,6 +94,12 @@ conversations:
       - "not_equal_to"
       - "contains"
       - "does_not_contain"
+  group_type:
+    attribute_type: "standard"
+    data_type: "text"
+    filter_operators:
+      - "equal_to"
+      - "not_equal_to"
   created_at:
     attribute_type: "standard"
     data_type: "date"
diff --git a/prd.json b/prd.json
new file mode 100644
index 0000000000000..da0c18f6756ef
--- /dev/null
+++ b/prd.json
@@ -0,0 +1,476 @@
+{
+  "project": "chatwoot",
+  "branchName": "ralph/group-conversations-full-feature",
+  "description": "Full group conversations feature \u2014 backend refactor, serialization, filtering, GroupContactInfo sidebar, group management (create/members/metadata/invite/join requests), group message bubbles, @mention system, real-time updates.",
+  "userStories": [
+    {
+      "id": "US-001",
+      "title": "Rename conversation_type to group_type on conversations",
+      "description": "As a developer, I need to rename the conversation_type column on conversations to group_type to avoid collisions with the frontend routing conversationType concept.",
+      "acceptanceCriteria": [
+        "New migration renames column conversation_type to group_type on the conversations table",
+        "Conversation model enum updated: enum group_type: { individual: 0, group: 1 }",
+        "All backend references updated: model, concerns (GroupConversationHandler), services (WhatsappBaileysService, baileys_handlers/*), controllers, specs, JBuilder serializers",
+        "Frontend references to conversation_type (routing concept with values mention/participating/unattended) remain untouched",
+        "bundle exec rspec passes with no failures",
+        "Typecheck passes"
+      ],
+      "priority": 1,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-002",
+      "title": "Serialize group_type fields in API responses",
+      "description": "As a frontend consumer, I need group_type in both conversation and contact JSON responses so the UI can distinguish groups from individual conversations.",
+      "acceptanceCriteria": [
+        "group_type field added to app/views/api/v1/conversations/partials/_conversation.json.jbuilder (outputs 'individual' or 'group')",
+        "group_type field added to app/views/api/v1/models/_contact.json.jbuilder (outputs 'individual' or 'group')",
+        "Existing conversation and contact API responses include the new fields without regression",
+        "bundle exec rspec spec/controllers passes",
+        "Typecheck passes"
+      ],
+      "priority": 2,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-003",
+      "title": "Backend \u2014 group_type filter on conversations index",
+      "description": "As a developer, I need the conversations index endpoint to accept a group_type query param so the basic filter dropdown can filter by conversation type.",
+      "acceptanceCriteria": [
+        "GET /api/v1/accounts/:account_id/conversations accepts group_type param with values 'individual' and 'group'",
+        "When group_type param is present, results are filtered by the group_type column",
+        "When group_type param is absent or 'all', no filter is applied (existing behavior unchanged)",
+        "bundle exec rspec spec/controllers/api/v1/accounts/conversations_controller_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 3,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-004",
+      "title": "Backend \u2014 add group_type to filter_keys.yml and FilterService",
+      "description": "As a developer, I need group_type supported in the advanced filter system so agents can build complex filters including conversation type.",
+      "acceptanceCriteria": [
+        "group_type added to lib/filters/filter_keys.yml under conversations: with attribute_type: standard, data_type: text, filter_operators: [equal_to, not_equal_to]",
+        "FilterService correctly applies group_type filters against the conversations.group_type column",
+        "POST /api/v1/accounts/:account_id/conversations/filter with group_type filter returns only matching conversations",
+        "bundle exec rspec spec/services/filter_service_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 4,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-005",
+      "title": "Backend \u2014 group creation endpoint",
+      "description": "As an agent, I want to create a new WhatsApp group from Chatwoot so I can start group conversations directly.",
+      "acceptanceCriteria": [
+        "POST /api/v1/accounts/:account_id/groups accepts { inbox_id, subject, participants: [phone_numbers] }",
+        "Service delegates to channel provider (WhatsappBaileysService) which calls Baileys groupCreate(subject, participants)",
+        "On success: creates Contact (group_type: group), ContactInbox, Conversation (group_type: group), and ConversationGroupMember records for all participants",
+        "Returns the created conversation with group metadata",
+        "Returns 403 if agent does not have access to the inbox",
+        "Returns 422 with error message if provider is unavailable",
+        "bundle exec rspec spec/controllers/api/v1/accounts/groups_controller_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 5,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-006",
+      "title": "Backend \u2014 add/remove members and role management endpoints",
+      "description": "As an agent, I want to add/remove members from a group and promote/demote admins via the API.",
+      "acceptanceCriteria": [
+        "POST /api/v1/accounts/:account_id/contacts/:id/group_members accepts { participants: [phone_numbers] } and adds members via Baileys groupParticipantsUpdate with action add",
+        "DELETE /api/v1/accounts/:account_id/contacts/:id/group_members accepts { participants: [phone_numbers] } and removes members via Baileys groupParticipantsUpdate with action remove",
+        "PATCH /api/v1/accounts/:account_id/contacts/:id/group_members/:member_id accepts { role: 'admin' | 'member' } and calls Baileys groupParticipantsUpdate with action promote or demote",
+        "Backend updates ConversationGroupMember records accordingly (create, soft-delete via is_active, update role)",
+        "Returns 422 with error message if provider is unavailable",
+        "bundle exec rspec spec/controllers/api/v1/accounts/contacts/group_members_controller_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 6,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-007",
+      "title": "Backend \u2014 group metadata update endpoint",
+      "description": "As an agent, I want to edit group name and description via the API so agents can manage group metadata.",
+      "acceptanceCriteria": [
+        "PATCH /api/v1/accounts/:account_id/contacts/:id/group_metadata accepts { subject, description }",
+        "Service calls Baileys groupUpdateSubject when subject is present",
+        "Service calls Baileys groupUpdateDescription when description is present",
+        "Backend updates Contact record: name from subject, additional_attributes.description from description",
+        "Avatar upload for group contacts uses existing contacts#update with avatar param, which calls Baileys updateProfilePicture",
+        "Returns 422 with error message if provider is unavailable",
+        "bundle exec rspec spec/controllers/api/v1/accounts/contacts/group_metadata_controller_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 7,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-008",
+      "title": "Backend \u2014 invite link management endpoints",
+      "description": "As an agent, I want to get and revoke the group invite link via the API.",
+      "acceptanceCriteria": [
+        "GET /api/v1/accounts/:account_id/contacts/:id/group_invite returns { invite_code, invite_url } by calling Baileys groupInviteCode(jid)",
+        "POST /api/v1/accounts/:account_id/contacts/:id/group_invite/revoke revokes the current link and returns a new { invite_code, invite_url } by calling Baileys groupRevokeInvite(jid)",
+        "Returns 422 with error message if provider is unavailable",
+        "bundle exec rspec spec/controllers/api/v1/accounts/contacts/group_invite_controller_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 8,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-009",
+      "title": "Backend \u2014 join request management endpoints",
+      "description": "As an agent/admin, I want to list and approve/reject pending join requests via the API.",
+      "acceptanceCriteria": [
+        "GET /api/v1/accounts/:account_id/contacts/:id/group_join_requests lists pending join requests by calling Baileys groupRequestParticipantsList(jid)",
+        "POST /api/v1/accounts/:account_id/contacts/:id/group_join_requests/handle accepts { participants: [jids], action: 'approve' | 'reject' } and calls Baileys groupRequestParticipantsUpdate(jid, participants, action)",
+        "Returns 422 with error message if provider is unavailable",
+        "bundle exec rspec spec/controllers/api/v1/accounts/contacts/group_join_requests_controller_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 9,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-010",
+      "title": "Backend \u2014 extend MentionService for contact mentions",
+      "description": "As a developer, I need the backend MentionService to handle mention://contact/ID/Name URIs in group messages and create Mention records for mentioned contacts.",
+      "acceptanceCriteria": [
+        "Messages::MentionService extracts mention://contact/ID/EncodedName URIs from message content",
+        "Creates Mention records (or equivalent) for each mentioned contact ID",
+        "Existing mention://user/ and mention://team/ handling is unchanged",
+        "bundle exec rspec spec/services/messages/mention_service_spec.rb passes",
+        "Typecheck passes"
+      ],
+      "priority": 10,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-011",
+      "title": "Frontend \u2014 API clients for all group endpoints",
+      "description": "As a developer, I need frontend API client methods for all group-related backend endpoints.",
+      "acceptanceCriteria": [
+        "New file app/javascript/dashboard/api/groupMembers.js exists",
+        "Exports: getGroupMembers(accountId, contactId), syncGroup(accountId, contactId), createGroup(accountId, params), updateGroupMetadata(accountId, contactId, params), addMembers(accountId, contactId, participants), removeMembers(accountId, contactId, participants), updateMemberRole(accountId, contactId, memberId, role), getInviteLink(accountId, contactId), revokeInviteLink(accountId, contactId), getPendingRequests(accountId, contactId), handleJoinRequest(accountId, contactId, params)",
+        "All methods follow existing ApiClient patterns from app/javascript/dashboard/api/contacts.js",
+        "Typecheck passes"
+      ],
+      "priority": 11,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-012",
+      "title": "Frontend \u2014 Vuex store module groupMembers",
+      "description": "As a developer, I need a Vuex store module to manage group member state so components can reactively access and mutate group data.",
+      "acceptanceCriteria": [
+        "New file app/javascript/dashboard/store/modules/groupMembers.js exists",
+        "State: records (object keyed by contactId \u2192 array of members), uiFlags: { isFetching, isSyncing, isUpdating }",
+        "Getter getGroupMembers(contactId) returns members array for the given contactId",
+        "Action fetch({ contactId }) calls getGroupMembers API and commits SET_GROUP_MEMBERS",
+        "Action sync({ contactId }) calls syncGroup API and then re-fetches via fetch",
+        "Actions addMembers, removeMembers, updateMemberRole call corresponding API methods and update store",
+        "Module registered in app/javascript/dashboard/store/index.js",
+        "pnpm test app/javascript/dashboard/store/modules/groupMembers.spec.js passes",
+        "Typecheck passes"
+      ],
+      "priority": 12,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-013",
+      "title": "Frontend \u2014 i18n keys for group features (en + pt-BR)",
+      "description": "As a developer, I need all group-related UI strings defined in i18n so no bare strings are used in components.",
+      "acceptanceCriteria": [
+        "New or updated JSON file(s) in app/javascript/dashboard/i18n/locale/en/ with keys for: group info header, member list section title, admin badge label, sync button label, sync success message, sync error message, empty member list state, filter type label (All/Individual/Group), group creation modal labels, edit metadata labels (name/description/avatar), invite link section labels (copy/revoke), member management labels (add/remove/promote/demote), join request labels (approve/reject/pending count), mention dropdown header",
+        "All same keys added to app/javascript/dashboard/i18n/locale/pt_BR/ with Portuguese translations",
+        "Typecheck passes"
+      ],
+      "priority": 13,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-014",
+      "title": "Frontend \u2014 add group_type filter to ConversationBasicFilter",
+      "description": "As an agent, I want a Type filter section in the basic filter dropdown to quickly show only individual or group conversations.",
+      "acceptanceCriteria": [
+        "ConversationBasicFilter.vue has a new Type section in the dropdown, alongside Status and Sort Order",
+        "Options: All (default), Individual, Group \u2014 using i18n labels",
+        "Selected value is stored in UI settings under conversations_filter_by.group_type and restored on reload",
+        "Filter value is included in conversationFilters and passed as group_type query param to the fetch API call",
+        "Selecting Individual shows only conversations with group_type individual, selecting Group shows only group_type group, All shows all",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 14,
+      "passes": true,
+      "notes": ""
+    },
+    {
+      "id": "US-015",
+      "title": "Frontend \u2014 add group_type to advanced filter system",
+      "description": "As an agent, I want group_type available as a filter attribute in the advanced filter so I can build complex filter rules.",
+      "acceptanceCriteria": [
+        "New entry in advancedFilterItems/index.js: attributeKey group_type, inputType multi_select, filterOperators OPERATOR_TYPES_1 (equal_to, not_equal_to), attributeModel standard",
+        "Added to filterAttributeGroups under Standard Filters",
+        "Filter options for group_type: individual and group with i18n labels",
+        "Advanced filter correctly sends group_type in filter payload and the backend returns matching conversations",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 15,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-016",
+      "title": "Frontend \u2014 GroupContactInfo basic display",
+      "description": "As an agent, I want to see a group-specific info panel in the sidebar with the group avatar, name, member count, and member list with skeleton loading.",
+      "acceptanceCriteria": [
+        "New component app/javascript/dashboard/routes/dashboard/conversation/contact/GroupContactInfo.vue using <script setup> and Composition API",
+        "Displays group avatar (using existing Avatar component), group name, and active member count",
+        "Member list shows each active member with: Avatar, name, Admin badge (only for role admin \u2014 no badge for member)",
+        "Skeleton loading placeholders appear while isFetching is true in the groupMembers store",
+        "Empty state message shown when fetch completes with zero members",
+        "On mount, dispatches groupMembers/fetch with the group contact ID",
+        "Only active members (is_active: true) are displayed",
+        "Tailwind only, no custom or scoped CSS",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 16,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-017",
+      "title": "Frontend \u2014 GroupContactInfo sync button",
+      "description": "As an agent, I want a Sync button in GroupContactInfo to refresh the member list from the provider.",
+      "acceptanceCriteria": [
+        "GroupContactInfo has a Sync button (using NextButton component) with sync/refresh icon",
+        "Clicking Sync dispatches groupMembers/sync action and shows spinner on the button while isSyncing is true",
+        "On sync success, shows a success alert using the existing useAlert composable",
+        "On sync error, shows an error alert with a user-friendly message",
+        "Button is disabled while sync is in progress",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 17,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-018",
+      "title": "Frontend \u2014 integrate GroupContactInfo in ContactPanel",
+      "description": "As a system, I need ContactPanel to render GroupContactInfo instead of ContactInfo when the current conversation is a group conversation.",
+      "acceptanceCriteria": [
+        "ContactPanel.vue imports GroupContactInfo",
+        "When currentChat.group_type === 'group', renders GroupContactInfo with the contact prop instead of ContactInfo",
+        "When currentChat.group_type is 'individual' or absent, renders existing ContactInfo (no regression)",
+        "Sidebar title changes: shows 'Group' (i18n key) for group conversations, existing 'Contact' for individual",
+        "contact_notes and contact_attributes accordion sections remain visible for group conversations",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 18,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-019",
+      "title": "Frontend \u2014 group creation UI modal",
+      "description": "As an agent, I want a modal to create a new WhatsApp group by selecting an inbox, entering a group name, and choosing initial participants.",
+      "acceptanceCriteria": [
+        "New component for group creation modal accessible from a relevant UI entry point",
+        "Inbox selector shows only inboxes that support groups (Baileys/WhatsApp channel type)",
+        "Group name text input field (required)",
+        "Participant selector with search by contact name or phone number",
+        "Submit calls createGroup API (via store action), shows loading state on the submit button",
+        "On success: shows success notification and navigates to the new group conversation",
+        "On error: shows error notification with the error message",
+        "Tailwind only, <script setup> and Composition API",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 19,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-020",
+      "title": "Frontend \u2014 member management UI in GroupContactInfo",
+      "description": "As an agent, I want to add/remove members and change roles directly from the GroupContactInfo sidebar.",
+      "acceptanceCriteria": [
+        "Add member button in GroupContactInfo opens a contact search/select input",
+        "Selecting a contact and confirming calls addMembers store action; member appears in list on success",
+        "Each member row has a context menu or action buttons: Promote to admin (if member), Demote to member (if admin), Remove from group",
+        "Each action calls the corresponding store action and shows loading state on the row",
+        "Success and error alerts shown after each action",
+        "Tailwind only, <script setup> and Composition API",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 20,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-021",
+      "title": "Frontend \u2014 group metadata editing UI",
+      "description": "As an agent, I want to edit the group name, description, and avatar inline from the GroupContactInfo sidebar.",
+      "acceptanceCriteria": [
+        "Group name is inline-editable: click to activate edit input, press Enter or blur to save",
+        "Description field is editable: click to activate textarea, blur to save",
+        "Avatar element is clickable and opens a file picker; selected image is uploaded via existing contact avatar update flow",
+        "Each save calls updateGroupMetadata API (name/description) or contacts#update (avatar)",
+        "Loading state on the field during save; success and error alerts shown",
+        "Tailwind only, <script setup> and Composition API",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 21,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-022",
+      "title": "Frontend \u2014 invite link management UI",
+      "description": "As an agent, I want to view, copy, and revoke the group invite link from the sidebar.",
+      "acceptanceCriteria": [
+        "Invite Link section in GroupContactInfo is always visible (not collapsed)",
+        "On section mount, fetches the invite link via getInviteLink API and displays it",
+        "Copy button copies the invite URL to the clipboard and shows a brief confirmation",
+        "Revoke & Regenerate button calls revokeInviteLink API, shows loading state, and displays the new link on success",
+        "Error alert shown if fetch or revoke fails",
+        "Tailwind only, <script setup> and Composition API",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 22,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-023",
+      "title": "Frontend \u2014 join request management UI",
+      "description": "As an agent, I want to see and act on pending join requests in the sidebar when join approval is enabled.",
+      "acceptanceCriteria": [
+        "Pending Requests section in GroupContactInfo is only rendered when there are pending requests",
+        "On mount, fetches pending requests via getPendingRequests API",
+        "Each request shows requester name/phone with Approve and Reject buttons",
+        "Approve button calls handleJoinRequest with action approve; Reject with action reject",
+        "Handled requests are removed from the list; success/error alerts shown",
+        "Section disappears when list becomes empty",
+        "Tailwind only, <script setup> and Composition API",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 23,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-024",
+      "title": "Frontend \u2014 group message bubbles: sender name with color",
+      "description": "As an agent, I want group message bubbles to show the sender's name above the text with a deterministic color per sender.",
+      "acceptanceCriteria": [
+        "In group conversations (group_type === 'group'), incoming message bubbles display the sender's name above the message content",
+        "Sender name color is deterministic: index = sender.name.length % 6, color taken from the same AVATAR_COLORS palette used by the Avatar component",
+        "Sender name is NOT shown for consecutive messages from the same sender within the same render block",
+        "Individual conversation bubbles are unchanged (no sender name shown)",
+        "Implementation in components-next/ message bubble components",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 24,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-025",
+      "title": "Frontend \u2014 group message bubbles: sender avatar",
+      "description": "As an agent, I want to see the sender's avatar next to group message bubbles to visually identify who sent each message.",
+      "acceptanceCriteria": [
+        "In group conversations, each incoming message shows the sender's avatar to the left of the bubble",
+        "Avatar uses sender's thumbnail if available; otherwise shows initials placeholder with the same name-length color from US-024",
+        "Avatar is NOT repeated for consecutive messages from the same sender (show only on the first of a group)",
+        "Individual conversation bubbles unchanged",
+        "Implementation in components-next/ message bubble components",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 25,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-026",
+      "title": "Frontend \u2014 @mention dropdown for group conversations",
+      "description": "As an agent, I want typing @ in a group conversation to show a dropdown of group members so I can mention them in messages.",
+      "acceptanceCriteria": [
+        "Typing @ in the message editor for a group conversation (group_type === 'group') triggers a mention suggestion dropdown",
+        "Dropdown lists group members from the groupMembers store for the current conversation's group contact",
+        "Dropdown filters by the text typed after @ (matches on name or phone number)",
+        "Each dropdown item shows Avatar, name, and phone number",
+        "Selecting an item inserts a mention node: [@DisplayName](mention://contact/ID/EncodedName) into the ProseMirror editor",
+        "In individual conversations (or private notes), the existing agent mention behavior is unchanged",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 26,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-027",
+      "title": "Frontend \u2014 mention rendering in group message bubbles",
+      "description": "As an agent, I want @mention tags in group messages to be visually highlighted in the message bubble.",
+      "acceptanceCriteria": [
+        "mention://contact/ID/EncodedName URIs in message content are rendered as highlighted/styled mention chips in the bubble",
+        "Mention chip shows @DisplayName with a distinct background or text color",
+        "The markdown-it link plugin (or equivalent renderer) handles the mention://contact scheme",
+        "Existing mention://user and mention://team rendering is unchanged",
+        "Typecheck passes",
+        "Verify in browser using dev-browser skill"
+      ],
+      "priority": 27,
+      "passes": false,
+      "notes": ""
+    },
+    {
+      "id": "US-028",
+      "title": "Frontend \u2014 ActionCable handler for contact.group_synced event",
+      "description": "As a system, when a contact.group_synced event arrives via ActionCable, the group member list should update reactively without a page refresh.",
+      "acceptanceCriteria": [
+        "ActionCable message handler listens for events with type contact.group_synced",
+        "On receiving the event, the handler extracts group member data directly from the event payload (no additional API call)",
+        "Commits the data to the groupMembers store using SET_GROUP_MEMBERS mutation for the affected contactId",
+        "GroupContactInfo member list updates reactively in the sidebar",
+        "pnpm test passes for the handler file",
+        "Typecheck passes"
+      ],
+      "priority": 28,
+      "passes": false,
+      "notes": ""
+    }
+  ]
+}
\ No newline at end of file
diff --git a/progress.txt b/progress.txt
new file mode 100644
index 0000000000000..9044b6dfbe231
--- /dev/null
+++ b/progress.txt
@@ -0,0 +1,131 @@
+## 2026-02-27 - US-014
+- ConversationBasicFilter.vue already had the Type section with group_type filter implemented
+- ChatList.vue already handled group_type in conversationFilters and setFiltersFromUISettings
+- Store (actions/getters/index) already had setChatGroupTypeFilter, getChatGroupTypeFilter, chatGroupTypeFilter state
+- API (inbox/conversation.js) already mapped groupType → group_type query param
+- i18n keys (GROUP.FILTER.*) already existed in en/groups.json and pt_BR/groups.json
+- No code changes were needed; all acceptance criteria already met by prior work
+- **Learnings for future iterations:**
+  - ConversationBasicFilter emits changeFilter event caught by ChatList.onBasicFilterChange; group_type value flows: filter → activeGroupType → conversationFilters.groupType → API param group_type
+---
+
+## 2026-02-27 - US-013
+- Created app/javascript/dashboard/i18n/locale/pt_BR/groups.json with Portuguese translations for all group feature keys
+- Added `import groups` and `...groups` spread to pt_BR/index.js
+- en/groups.json already existed with all required keys; pt_BR was missing
+- **Learnings for future iterations:**
+  - pt_BR/index.js requires both import and spread; en/index.js already had groups; pt_BR did not
+---
+
+## 2026-02-27 - US-012
+- Created app/javascript/dashboard/store/modules/groupMembers.js
+- Added SET_GROUP_MEMBERS_UI_FLAG and SET_GROUP_MEMBERS to mutation-types.js
+- Registered groupMembers module in store/index.js
+- Created flat spec file at store/modules/groupMembers.spec.js
+---
+
+## 2026-02-27 - US-011
+- Created app/javascript/dashboard/api/groupMembers.js
+- All 11 exported methods following ApiClient patterns
+- createGroup uses baseUrl()/groups (not contacts prefix)
+---
+
+## 2026-02-27 - US-010
+- Refactored MentionService: separated perform into process_user_team_mentions + process_contact_mentions
+- Contact mentions use mention://contact/ID/EncodedName pattern
+- Stores extracted contact IDs in message.content_attributes['mentioned_contacts'] via update_columns
+- User/team mention behavior unchanged (still gated on private: true)
+- Contact mentions work on any message (private or not)
+---
+
+## 2026-02-27 - US-009
+- Created GroupJoinRequestsController with index and handle actions
+- index: calls group_join_requests(jid), returns { payload: requests }
+- handle: calls handle_group_join_requests(jid, participants, request_action), returns 200
+- **Learnings for future iterations:**
+  - params[:action] is reserved in Rails for controller action name; use params[:request_action] or similar for custom action params
+---
+
+## 2026-02-27 - US-008
+- Created GroupInvitesController (note: singular resource :group_invite routes to group_invites_controller)
+- show: calls group_invite_code(jid), returns { invite_code, invite_url }
+- revoke: calls revoke_group_invite(jid), returns new { invite_code, invite_url }
+- **Learnings for future iterations:**
+  - `resource :group_invite` (singular resource) routes to `group_invites_controller` (pluralized class name) in Rails conventions
+---
+
+## 2026-02-27 - US-007
+- Created GroupMetadataController with update action
+- Calls update_group_subject when subject param present, updates contact.name
+- Calls update_group_description when description param present, updates additional_attributes.description
+- Route: resource :group_metadata, only: [:update] was already set up in US-005
+---
+
+## 2026-02-27 - US-006
+- Added create, destroy, update actions to GroupMembersController
+- Added group management method delegates to Channel::Whatsapp (create_group, update_group_participants, etc.)
+- create: calls update_group_participants('add'), creates ConversationGroupMember records via ContactInboxWithContactBuilder
+- destroy: calls update_group_participants('remove'), sets is_active=false on member
+- update: maps role 'admin'→'promote'/'member'→'demote', calls update_group_participants, updates member.role
+- **Learnings for future iterations:**
+  - Channel::Whatsapp delegates methods to provider_service; new service methods need `delegate :method_name, to: :provider_service`
+  - `allow_any_instance_of(Channel::Whatsapp).to receive(:method)` is the easiest way to stub channel methods in request specs
+  - Use `let!` for conversations/members referenced in route setup to ensure creation before request
+---
+
+## 2026-02-27 - US-005
+- Created POST /api/v1/accounts/:account_id/groups endpoint (GroupsController)
+- Created Groups::CreateService using channel.create_group via WhatsappBaileysService
+- Extended BaseService + WhatsappBaileysService with 8 abstract group management methods
+- Added routes for groups, group_members, group_metadata, group_invite, group_join_requests
+- Created create.json.jbuilder view using existing conversation partial
+- 403 test root cause: administrators have assigned_inboxes = all account inboxes; used agent user for the inbox-access test
+- **Learnings for future iterations:**
+  - Administrators have access to ALL account inboxes via assigned_inboxes; use agent user when testing inbox-level access denial
+  - `return render json:..., status: :forbidden unless cond` works correctly in Rails actions; the real issue was admin bypassing the check
+---
+
+## 2026-02-27 - US-004
+- Added group_type to lib/filters/filter_keys.yml (attribute_type: standard, data_type: text, equal_to/not_equal_to)
+- Added conversation_group_type_values to FilterHelper (converts string 'individual'/'group' to integer enum values)
+- Hooked into FilterService#filter_values for group_type attribute_key
+---
+
+## 2026-02-27 - US-003
+- Added filter_by_group_type method to ConversationFinder, called from set_up
+- No filter applied when param absent or equals 'all'
+---
+
+## 2026-02-27 - US-002
+- Added group_type to conversation jbuilder partial (_conversation.json.jbuilder)
+- Added group_type to contact jbuilder model (_contact.json.jbuilder)
+- Both Contact and Conversation models already have group_type enum; output is 'individual' or 'group'
+- All controller specs pass with no regressions
+---
+
+## 2026-02-27 - US-001
+- Renamed conversation_type column to group_type on conversations table
+- Created migration 20260227135739 with rename_column + execute(ALTER INDEX) instead of rename_index
+- Updated Conversation model enum, GroupConversationHandler concern, contacts_controller, group_members_controller
+- Updated specs: conversation_spec, contact_spec, group_members_controller_spec, baileys handler specs
+- Frontend routing concept (conversation_type with mention/participating/unattended values) left untouched
+- **Learnings for future iterations:**
+  - `rename_index` inside Rails migrations fails with PG error; use `execute("ALTER INDEX IF EXISTS ... RENAME TO ...")` instead
+  - Enum predicate methods also need renaming: `be_conversation_type_group` → `be_group_type_group`
+---
+
+## Codebase Patterns
+
+- Backend group models: Contact (group_type enum), Conversation (group_type enum, column renamed from conversation_type via migration 20260227135739), ConversationGroupMember (role enum: member/admin, is_active for soft delete)
+- Migrations: use `execute("ALTER INDEX IF EXISTS old_name RENAME TO new_name")` instead of `rename_index` to avoid PG DDL transaction issues
+- Baileys provider: all group operations are in WhatsappBaileysService; new group endpoints must be defined as abstract methods on the base service first
+- Frontend routing uses conversationType (mention/participating/unattended) — never confuse with the model field group_type
+- Avatar placeholder colors: AVATAR_COLORS palette, index = name.length % 6 (6 pairs light + dark)
+- Mention format stored in messages: [@Name](mention://user/ID/Name) or [@Name](mention://team/ID/Name) — group contacts use mention://contact/ID/Name
+- ConversationBasicFilter dropdown uses SelectMenu from components-next/selectmenu; emits changeFilter and updates UI settings via updateUISettings
+- Advanced filter attributes defined in advancedFilterItems/index.js + filterAttributeGroups; backend keys in lib/filters/filter_keys.yml
+- All new Vue components must use <script setup> + Composition API; Tailwind only (no custom/scoped CSS)
+- ActionCable events flow through a message handler that dispatches to Vuex; group_synced payload includes all member data — no re-fetch needed
+- i18n: always add both en (app/javascript/dashboard/i18n/locale/en/) and pt_BR translations
+
+---
diff --git a/spec/controllers/api/v1/accounts/contacts/group_invite_controller_spec.rb b/spec/controllers/api/v1/accounts/contacts/group_invite_controller_spec.rb
new file mode 100644
index 0000000000000..a6cefe830b355
--- /dev/null
+++ b/spec/controllers/api/v1/accounts/contacts/group_invite_controller_spec.rb
@@ -0,0 +1,74 @@
+require 'rails_helper'
+
+RSpec.describe '/api/v1/accounts/{account.id}/contacts/:id/group_invite', type: :request do
+  let(:account) { create(:account) }
+  let(:admin) { create(:user, account: account, role: :administrator) }
+  let(:whatsapp_channel) do
+    create(:channel_whatsapp, provider: 'baileys', validate_provider_config: false, sync_templates: false, account: account)
+  end
+  let(:inbox) { whatsapp_channel.inbox }
+  let(:group_contact) { create(:contact, account: account, group_type: :group, identifier: 'group@g.us') }
+  let(:conversation) { create(:conversation, account: account, contact: group_contact, inbox: inbox, group_type: :group) }
+  let(:baileys_service) { instance_double(Whatsapp::Providers::WhatsappBaileysService) }
+
+  before do
+    conversation
+    allow(Whatsapp::Providers::WhatsappBaileysService).to receive(:new).and_return(baileys_service)
+    allow(baileys_service).to receive(:group_invite_code).and_return('ABCXYZ')
+    allow(baileys_service).to receive(:revoke_group_invite).and_return('NEWCODE')
+  end
+
+  describe 'GET /api/v1/accounts/{account.id}/contacts/:id/group_invite' do
+    context 'when unauthenticated' do
+      it 'returns unauthorized' do
+        get "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_invite"
+        expect(response).to have_http_status(:unauthorized)
+      end
+    end
+
+    context 'when user is logged in' do
+      it 'returns invite code and url' do
+        get "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_invite",
+            headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(response.parsed_body['invite_code']).to eq('ABCXYZ')
+        expect(response.parsed_body['invite_url']).to eq('https://chat.whatsapp.com/ABCXYZ')
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:group_invite_code)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        get "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_invite",
+            headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(response.parsed_body['error']).to eq('Offline')
+      end
+    end
+  end
+
+  describe 'POST /api/v1/accounts/{account.id}/contacts/:id/group_invite/revoke' do
+    context 'when user is logged in' do
+      it 'revokes and returns new invite code and url' do
+        post "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_invite/revoke",
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(response.parsed_body['invite_code']).to eq('NEWCODE')
+        expect(response.parsed_body['invite_url']).to eq('https://chat.whatsapp.com/NEWCODE')
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:revoke_group_invite)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        post "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_invite/revoke",
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+      end
+    end
+  end
+end
diff --git a/spec/controllers/api/v1/accounts/contacts/group_join_requests_controller_spec.rb b/spec/controllers/api/v1/accounts/contacts/group_join_requests_controller_spec.rb
new file mode 100644
index 0000000000000..8eac98368575e
--- /dev/null
+++ b/spec/controllers/api/v1/accounts/contacts/group_join_requests_controller_spec.rb
@@ -0,0 +1,76 @@
+require 'rails_helper'
+
+RSpec.describe '/api/v1/accounts/{account.id}/contacts/:id/group_join_requests', type: :request do
+  let(:account) { create(:account) }
+  let(:admin) { create(:user, account: account, role: :administrator) }
+  let(:whatsapp_channel) do
+    create(:channel_whatsapp, provider: 'baileys', validate_provider_config: false, sync_templates: false, account: account)
+  end
+  let(:inbox) { whatsapp_channel.inbox }
+  let(:group_contact) { create(:contact, account: account, group_type: :group, identifier: 'group@g.us') }
+  let(:conversation) { create(:conversation, account: account, contact: group_contact, inbox: inbox, group_type: :group) }
+  let(:baileys_service) { instance_double(Whatsapp::Providers::WhatsappBaileysService) }
+  let(:join_requests) { [{ 'jid' => '551199999@s.whatsapp.net', 'name' => 'Alice' }] }
+
+  before do
+    conversation
+    allow(Whatsapp::Providers::WhatsappBaileysService).to receive(:new).and_return(baileys_service)
+    allow(baileys_service).to receive(:group_join_requests).and_return(join_requests)
+    allow(baileys_service).to receive(:handle_group_join_requests).and_return(true)
+  end
+
+  describe 'GET /api/v1/accounts/{account.id}/contacts/:id/group_join_requests' do
+    context 'when unauthenticated' do
+      it 'returns unauthorized' do
+        get "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_join_requests"
+        expect(response).to have_http_status(:unauthorized)
+      end
+    end
+
+    context 'when user is logged in' do
+      it 'returns list of join requests' do
+        get "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_join_requests",
+            headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(response.parsed_body['payload']).to eq(join_requests)
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:group_join_requests)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        get "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_join_requests",
+            headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(response.parsed_body['error']).to eq('Offline')
+      end
+    end
+  end
+
+  describe 'POST /api/v1/accounts/{account.id}/contacts/:id/group_join_requests/handle' do
+    context 'when user is logged in' do
+      it 'approves join requests and returns ok' do
+        post "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_join_requests/handle",
+             params: { participants: ['551199999@s.whatsapp.net'], request_action: 'approve' },
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(baileys_service).to have_received(:handle_group_join_requests)
+          .with('group@g.us', ['551199999@s.whatsapp.net'], 'approve')
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:handle_group_join_requests)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        post "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_join_requests/handle",
+             params: { participants: ['551199999@s.whatsapp.net'], request_action: 'approve' },
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+      end
+    end
+  end
+end
diff --git a/spec/controllers/api/v1/accounts/contacts/group_members_controller_spec.rb b/spec/controllers/api/v1/accounts/contacts/group_members_controller_spec.rb
index 007523525147a..3a39d2d78f8fb 100644
--- a/spec/controllers/api/v1/accounts/contacts/group_members_controller_spec.rb
+++ b/spec/controllers/api/v1/accounts/contacts/group_members_controller_spec.rb
@@ -23,7 +23,7 @@
     context 'when user is logged in' do
       it 'returns active group members' do
         contact = create(:contact, account: account, group_type: :group, identifier: 'group@g.us')
-        conversation = create(:conversation, account: account, contact: contact, conversation_type: :group)
+        conversation = create(:conversation, account: account, contact: contact, group_type: :group)
         create(:conversation_group_member, conversation: conversation, contact: contact)
         create(:conversation_group_member, conversation: conversation, contact: create(:contact, account: account))
 
@@ -36,7 +36,7 @@
 
       it 'does not return inactive group members' do
         contact = create(:contact, account: account, group_type: :group, identifier: 'group@g.us')
-        conversation = create(:conversation, account: account, contact: contact, conversation_type: :group)
+        conversation = create(:conversation, account: account, contact: contact, group_type: :group)
         create(:conversation_group_member, conversation: conversation, contact: contact)
         create(:conversation_group_member, :inactive, conversation: conversation, contact: create(:contact, account: account))
 
@@ -49,11 +49,11 @@
 
       it 'does not return group members from another account' do
         contact = create(:contact, account: account, group_type: :group, identifier: 'group@g.us')
-        conversation = create(:conversation, account: account, contact: contact, conversation_type: :group)
+        conversation = create(:conversation, account: account, contact: contact, group_type: :group)
         create(:conversation_group_member, conversation: conversation, contact: contact)
         other_account = create(:account)
         other_conversation = create(:conversation, account: other_account, contact: create(:contact, account: other_account),
-                                                   conversation_type: :group)
+                                                   group_type: :group)
         create(:conversation_group_member, conversation: other_conversation, contact: create(:contact, account: other_account))
 
         get "/api/v1/accounts/#{account.id}/contacts/#{contact.id}/group_members",
@@ -65,7 +65,7 @@
 
       it 'returns expected attributes in the response' do
         contact = create(:contact, account: account, group_type: :group, identifier: 'group@g.us')
-        conversation = create(:conversation, account: account, contact: contact, conversation_type: :group)
+        conversation = create(:conversation, account: account, contact: contact, group_type: :group)
         create(:conversation_group_member, conversation: conversation, contact: contact)
 
         get "/api/v1/accounts/#{account.id}/contacts/#{contact.id}/group_members",
@@ -83,9 +83,9 @@
 
       it 'only returns members from open and pending conversations' do
         contact = create(:contact, account: account, group_type: :group, identifier: 'group@g.us')
-        open_conversation = create(:conversation, account: account, contact: contact, conversation_type: :group, status: :open)
-        pending_conversation = create(:conversation, account: account, contact: contact, conversation_type: :group, status: :pending)
-        resolved_conversation = create(:conversation, account: account, contact: contact, conversation_type: :group, status: :resolved)
+        open_conversation = create(:conversation, account: account, contact: contact, group_type: :group, status: :open)
+        pending_conversation = create(:conversation, account: account, contact: contact, group_type: :group, status: :pending)
+        resolved_conversation = create(:conversation, account: account, contact: contact, group_type: :group, status: :resolved)
         create(:conversation_group_member, conversation: open_conversation, contact: contact)
         create(:conversation_group_member, conversation: pending_conversation, contact: create(:contact, account: account))
         create(:conversation_group_member, conversation: resolved_conversation, contact: create(:contact, account: account))
@@ -123,4 +123,138 @@
       end
     end
   end
+
+  describe 'POST /api/v1/accounts/{account.id}/contacts/:id/group_members' do
+    let(:whatsapp_channel) do
+      create(:channel_whatsapp, provider: 'baileys', validate_provider_config: false, sync_templates: false, account: account)
+    end
+    let(:inbox) { whatsapp_channel.inbox }
+    let(:group_contact) { create(:contact, account: account, group_type: :group, identifier: 'group@g.us') }
+    let(:conversation) { create(:conversation, account: account, contact: group_contact, inbox: inbox, group_type: :group) }
+    let(:baileys_service) { instance_double(Whatsapp::Providers::WhatsappBaileysService) }
+
+    before do
+      conversation
+      allow(Whatsapp::Providers::WhatsappBaileysService).to receive(:new).and_return(baileys_service)
+      allow(baileys_service).to receive(:update_group_participants).and_return(true)
+    end
+
+    context 'when unauthenticated' do
+      it 'returns unauthorized' do
+        post "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members"
+        expect(response).to have_http_status(:unauthorized)
+      end
+    end
+
+    context 'when user is logged in' do
+      it 'adds members and returns ok' do
+        allow(baileys_service).to receive(:validate_provider_config?).and_return(true)
+        allow(ContactInboxWithContactBuilder).to receive(:new).and_call_original
+
+        post "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members",
+             params: { participants: ['+5511999990001'] },
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:update_group_participants)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        post "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members",
+             params: { participants: ['+5511999990001'] },
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(response.parsed_body['error']).to eq('Offline')
+      end
+    end
+  end
+
+  describe 'DELETE /api/v1/accounts/{account.id}/contacts/:id/group_members/:id' do
+    let(:whatsapp_channel) do
+      create(:channel_whatsapp, provider: 'baileys', validate_provider_config: false, sync_templates: false, account: account)
+    end
+    let(:inbox) { whatsapp_channel.inbox }
+    let(:group_contact) { create(:contact, account: account, group_type: :group, identifier: 'group@g.us') }
+    let(:conversation) { create(:conversation, account: account, contact: group_contact, inbox: inbox, group_type: :group) }
+    let(:member_contact) { create(:contact, account: account, phone_number: '+5511999990002') }
+    let!(:member) { create(:conversation_group_member, conversation: conversation, contact: member_contact) }
+    let(:baileys_service) { instance_double(Whatsapp::Providers::WhatsappBaileysService) }
+
+    before do
+      allow(Whatsapp::Providers::WhatsappBaileysService).to receive(:new).and_return(baileys_service)
+      allow(baileys_service).to receive(:update_group_participants).and_return(true)
+    end
+
+    context 'when user is logged in' do
+      it 'deactivates the member and returns ok' do
+        delete "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members/#{member.id}",
+               headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(member.reload.is_active).to be false
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:update_group_participants)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        delete "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members/#{member.id}",
+               headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+      end
+    end
+  end
+
+  describe 'PATCH /api/v1/accounts/{account.id}/contacts/:id/group_members/:member_id' do
+    let(:whatsapp_channel) do
+      create(:channel_whatsapp, provider: 'baileys', validate_provider_config: false, sync_templates: false, account: account)
+    end
+    let(:inbox) { whatsapp_channel.inbox }
+    let(:group_contact) { create(:contact, account: account, group_type: :group, identifier: 'group@g.us') }
+    let(:conversation) { create(:conversation, account: account, contact: group_contact, inbox: inbox, group_type: :group) }
+    let(:member_contact) { create(:contact, account: account, phone_number: '+5511999990003') }
+    let!(:member) { create(:conversation_group_member, conversation: conversation, contact: member_contact, role: :member) }
+    let(:baileys_service) { instance_double(Whatsapp::Providers::WhatsappBaileysService) }
+
+    before do
+      allow(Whatsapp::Providers::WhatsappBaileysService).to receive(:new).and_return(baileys_service)
+      allow(baileys_service).to receive(:update_group_participants).and_return(true)
+    end
+
+    context 'when user is logged in' do
+      it 'promotes member to admin' do
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members/#{member.id}",
+              params: { role: 'admin' },
+              headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(member.reload.role).to eq('admin')
+      end
+
+      it 'demotes admin to member' do
+        member.update!(role: :admin)
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members/#{member.id}",
+              params: { role: 'member' },
+              headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(member.reload.role).to eq('member')
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:update_group_participants)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_members/#{member.id}",
+              params: { role: 'admin' },
+              headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+      end
+    end
+  end
 end
diff --git a/spec/controllers/api/v1/accounts/contacts/group_metadata_controller_spec.rb b/spec/controllers/api/v1/accounts/contacts/group_metadata_controller_spec.rb
new file mode 100644
index 0000000000000..a2186b331ccd4
--- /dev/null
+++ b/spec/controllers/api/v1/accounts/contacts/group_metadata_controller_spec.rb
@@ -0,0 +1,73 @@
+require 'rails_helper'
+
+RSpec.describe '/api/v1/accounts/{account.id}/contacts/:id/group_metadata', type: :request do
+  let(:account) { create(:account) }
+  let(:admin) { create(:user, account: account, role: :administrator) }
+  let(:whatsapp_channel) do
+    create(:channel_whatsapp, provider: 'baileys', validate_provider_config: false, sync_templates: false, account: account)
+  end
+  let(:inbox) { whatsapp_channel.inbox }
+  let(:group_contact) { create(:contact, account: account, group_type: :group, identifier: 'group@g.us', name: 'Old Name') }
+  let(:conversation) { create(:conversation, account: account, contact: group_contact, inbox: inbox, group_type: :group) }
+  let(:baileys_service) { instance_double(Whatsapp::Providers::WhatsappBaileysService) }
+
+  before do
+    conversation
+    allow(Whatsapp::Providers::WhatsappBaileysService).to receive(:new).and_return(baileys_service)
+    allow(baileys_service).to receive(:update_group_subject).and_return(true)
+    allow(baileys_service).to receive(:update_group_description).and_return(true)
+  end
+
+  describe 'PATCH /api/v1/accounts/{account.id}/contacts/:id/group_metadata' do
+    context 'when unauthenticated' do
+      it 'returns unauthorized' do
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_metadata"
+        expect(response).to have_http_status(:unauthorized)
+      end
+    end
+
+    context 'when user is logged in' do
+      it 'updates the group subject and contact name' do
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_metadata",
+              params: { subject: 'New Group Name' },
+              headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(group_contact.reload.name).to eq('New Group Name')
+        expect(baileys_service).to have_received(:update_group_subject).with('group@g.us', 'New Group Name')
+      end
+
+      it 'updates the group description' do
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_metadata",
+              params: { description: 'A new description' },
+              headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(group_contact.reload.additional_attributes['description']).to eq('A new description')
+        expect(baileys_service).to have_received(:update_group_description).with('group@g.us', 'A new description')
+      end
+
+      it 'updates both subject and description' do
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_metadata",
+              params: { subject: 'Updated Name', description: 'Updated Desc' },
+              headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:ok)
+        expect(group_contact.reload.name).to eq('Updated Name')
+        expect(group_contact.additional_attributes['description']).to eq('Updated Desc')
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(baileys_service).to receive(:update_group_subject)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Offline')
+
+        patch "/api/v1/accounts/#{account.id}/contacts/#{group_contact.id}/group_metadata",
+              params: { subject: 'New Name' },
+              headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(response.parsed_body['error']).to eq('Offline')
+      end
+    end
+  end
+end
diff --git a/spec/controllers/api/v1/accounts/groups_controller_spec.rb b/spec/controllers/api/v1/accounts/groups_controller_spec.rb
new file mode 100644
index 0000000000000..02dd8a244f52b
--- /dev/null
+++ b/spec/controllers/api/v1/accounts/groups_controller_spec.rb
@@ -0,0 +1,62 @@
+require 'rails_helper'
+
+RSpec.describe '/api/v1/accounts/{account.id}/groups', type: :request do
+  let(:account) { create(:account) }
+  let(:admin) { create(:user, account: account, role: :administrator) }
+  let(:agent) { create(:user, account: account, role: :agent) }
+  let(:inbox) { create(:inbox, account: account) }
+  let(:create_service) { instance_double(Groups::CreateService) }
+
+  before do
+    create(:inbox_member, inbox: inbox, user: admin)
+    create(:inbox_member, inbox: inbox, user: agent)
+    allow(Groups::CreateService).to receive(:new).and_return(create_service)
+    allow(create_service).to receive(:perform)
+  end
+
+  describe 'POST /api/v1/accounts/{account.id}/groups' do
+    context 'when unauthenticated user' do
+      it 'returns unauthorized' do
+        post "/api/v1/accounts/#{account.id}/groups"
+        expect(response).to have_http_status(:unauthorized)
+      end
+    end
+
+    context 'when user is logged in' do
+      it 'creates a group conversation and returns it' do
+        conversation = create(:conversation, account: account, group_type: :group)
+        allow(create_service).to receive(:perform).and_return(conversation)
+
+        post "/api/v1/accounts/#{account.id}/groups",
+             params: { inbox_id: inbox.id, subject: 'Test Group', participants: ['+5511999999999'] },
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:success)
+        expect(response.parsed_body['group_type']).to eq('group')
+      end
+
+      it 'returns 422 when provider is unavailable' do
+        allow(create_service).to receive(:perform)
+          .and_raise(Whatsapp::Providers::WhatsappBaileysService::ProviderUnavailableError, 'Unavailable')
+
+        post "/api/v1/accounts/#{account.id}/groups",
+             params: { inbox_id: inbox.id, subject: 'Test Group', participants: [] },
+             headers: admin.create_new_auth_token
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(response.parsed_body['error']).to eq('Unavailable')
+      end
+
+      it 'returns 403 when agent does not have inbox access' do
+        other_inbox = create(:inbox, account: account)
+
+        post "/api/v1/accounts/#{account.id}/groups",
+             params: { inbox_id: other_inbox.id, subject: 'Test Group', participants: [] },
+             headers: agent.create_new_auth_token
+
+        expect(response).to have_http_status(:forbidden)
+        expect(response.parsed_body['error']).to be_present
+      end
+    end
+  end
+end
diff --git a/spec/models/contact_spec.rb b/spec/models/contact_spec.rb
index a8c62baadebaf..c5262d885b623 100644
--- a/spec/models/contact_spec.rb
+++ b/spec/models/contact_spec.rb
@@ -219,8 +219,8 @@
   describe 'group_conversations association' do
     it 'returns conversations through group_memberships' do
       contact = create(:contact)
-      conversation1 = create(:conversation, conversation_type: :group, account: contact.account)
-      conversation2 = create(:conversation, conversation_type: :group, account: contact.account)
+      conversation1 = create(:conversation, group_type: :group, account: contact.account)
+      conversation2 = create(:conversation, group_type: :group, account: contact.account)
       create(:conversation_group_member, contact: contact, conversation: conversation1)
       create(:conversation_group_member, contact: contact, conversation: conversation2)
 
diff --git a/spec/models/conversation_spec.rb b/spec/models/conversation_spec.rb
index 688ec7e52f37a..b9a8c3a03786f 100644
--- a/spec/models/conversation_spec.rb
+++ b/spec/models/conversation_spec.rb
@@ -1103,19 +1103,19 @@ def create_bot_message(conversation, created_at: Time.current)
     end
   end
 
-  describe 'conversation_type' do
+  describe 'group_type' do
     it 'provides type check methods' do
-      individual_conversation = create(:conversation, conversation_type: :individual)
-      group_conversation = create(:conversation, conversation_type: :group)
+      individual_conversation = create(:conversation, group_type: :individual)
+      group_conversation = create(:conversation, group_type: :group)
 
-      expect(individual_conversation).to be_conversation_type_individual
-      expect(group_conversation).to be_conversation_type_group
+      expect(individual_conversation).to be_group_type_individual
+      expect(group_conversation).to be_group_type_group
     end
   end
 
   describe 'group_members association' do
     it 'returns associated group members' do
-      conversation = create(:conversation, conversation_type: :group)
+      conversation = create(:conversation, group_type: :group)
       group_member = create(:conversation_group_member, conversation: conversation)
 
       expect(conversation.group_members).to eq([group_member])
@@ -1124,7 +1124,7 @@ def create_bot_message(conversation, created_at: Time.current)
 
   describe 'group_contacts association' do
     it 'returns contacts through group_members' do
-      conversation = create(:conversation, conversation_type: :group)
+      conversation = create(:conversation, group_type: :group)
       contact = create(:contact, account: conversation.account)
       create(:conversation_group_member, conversation: conversation, contact: contact)
 
@@ -1132,7 +1132,7 @@ def create_bot_message(conversation, created_at: Time.current)
     end
 
     it 'returns multiple contacts for group conversations' do
-      conversation = create(:conversation, conversation_type: :group)
+      conversation = create(:conversation, group_type: :group)
       contact1 = create(:contact, account: conversation.account)
       contact2 = create(:contact, account: conversation.account)
       create(:conversation_group_member, conversation: conversation, contact: contact1)
diff --git a/spec/services/messages/mention_service_spec.rb b/spec/services/messages/mention_service_spec.rb
index 7cdb8ffe7543d..1a6410a100d5e 100644
--- a/spec/services/messages/mention_service_spec.rb
+++ b/spec/services/messages/mention_service_spec.rb
@@ -504,4 +504,70 @@
       expect(Conversations::UserMentionJob).not_to have_received(:perform_later)
     end
   end
+
+  describe 'contact mentions' do
+    let(:group_contact) { create(:contact, account: account, group_type: :group) }
+
+    context 'when message contains contact mentions' do
+      it 'stores mentioned contact IDs in content_attributes' do
+        message = create(
+          :message,
+          conversation: conversation,
+          account: account,
+          content: "hey (mention://contact/#{group_contact.id}/Alice) check this out",
+          private: false
+        )
+
+        described_class.new(message: message).perform
+
+        expect(message.reload.content_attributes['mentioned_contacts']).to eq([group_contact.id.to_s])
+      end
+
+      it 'does not trigger user mention notifications for contact mentions' do
+        message = create(
+          :message,
+          conversation: conversation,
+          account: account,
+          content: "hey (mention://contact/#{group_contact.id}/Alice)",
+          private: false
+        )
+
+        described_class.new(message: message).perform
+
+        expect(NotificationBuilder).not_to have_received(:new)
+        expect(Conversations::UserMentionJob).not_to have_received(:perform_later)
+      end
+
+      it 'deduplicates repeated contact mentions' do
+        message = create(
+          :message,
+          conversation: conversation,
+          account: account,
+          content: "(mention://contact/#{group_contact.id}/Alice) and again (mention://contact/#{group_contact.id}/Alice)",
+          private: false
+        )
+
+        described_class.new(message: message).perform
+
+        expect(message.reload.content_attributes['mentioned_contacts']).to eq([group_contact.id.to_s])
+      end
+    end
+
+    context 'when message has no contact mentions' do
+      it 'does not update content_attributes' do
+        message = create(
+          :message,
+          conversation: conversation,
+          account: account,
+          content: 'just a regular group message',
+          private: false
+        )
+        original_attrs = message.content_attributes.dup
+
+        described_class.new(message: message).perform
+
+        expect(message.reload.content_attributes).to eq(original_attrs)
+      end
+    end
+  end
 end
diff --git a/spec/services/whatsapp/baileys_handlers/group_participants_update_spec.rb b/spec/services/whatsapp/baileys_handlers/group_participants_update_spec.rb
index fbe0b406b2ad1..a8ff1f00c0002 100644
--- a/spec/services/whatsapp/baileys_handlers/group_participants_update_spec.rb
+++ b/spec/services/whatsapp/baileys_handlers/group_participants_update_spec.rb
@@ -22,7 +22,7 @@ def create_group_conversation
     contact = create(:contact, account: inbox.account, identifier: group_jid, group_type: :group)
     contact_inbox = create(:contact_inbox, inbox: inbox, contact: contact, source_id: group_source_id)
     conversation = create(:conversation, account: inbox.account, inbox: inbox, contact: contact,
-                                         contact_inbox: contact_inbox, conversation_type: :group, status: :open)
+                                         contact_inbox: contact_inbox, group_type: :group, status: :open)
     [conversation, contact]
   end
 
diff --git a/spec/services/whatsapp/baileys_handlers/groups_update_spec.rb b/spec/services/whatsapp/baileys_handlers/groups_update_spec.rb
index 79fc2e7ac30b2..812887a8be465 100644
--- a/spec/services/whatsapp/baileys_handlers/groups_update_spec.rb
+++ b/spec/services/whatsapp/baileys_handlers/groups_update_spec.rb
@@ -22,7 +22,7 @@ def create_group_conversation(name: group_source_id)
     contact = create(:contact, account: inbox.account, identifier: group_jid, group_type: :group, name: name)
     contact_inbox = create(:contact_inbox, inbox: inbox, contact: contact, source_id: group_source_id)
     conversation = create(:conversation, account: inbox.account, inbox: inbox, contact: contact,
-                                         contact_inbox: contact_inbox, conversation_type: :group, status: :open)
+                                         contact_inbox: contact_inbox, group_type: :group, status: :open)
     [conversation, contact]
   end
 
diff --git a/spec/services/whatsapp/baileys_handlers/messages_upsert_spec.rb b/spec/services/whatsapp/baileys_handlers/messages_upsert_spec.rb
index ed5ccc62e6948..98d550cf72c04 100644
--- a/spec/services/whatsapp/baileys_handlers/messages_upsert_spec.rb
+++ b/spec/services/whatsapp/baileys_handlers/messages_upsert_spec.rb
@@ -498,7 +498,7 @@ def stub_group_metadata
 
       expect(group_contact.group_type).to eq('group')
       expect(group_contact.identifier).to eq(group_jid)
-      expect(conversation.conversation_type).to eq('group')
+      expect(conversation.group_type).to eq('group')
       expect(message.content).to eq('Hello group')
       expect(message.sender).not_to eq(group_contact)
       expect(conversation.group_members.active.pluck(:contact_id)).to include(message.sender_id)
diff --git a/spec/services/whatsapp/providers/whatsapp_baileys_service_spec.rb b/spec/services/whatsapp/providers/whatsapp_baileys_service_spec.rb
index 706b122b230c4..387593489ac24 100644
--- a/spec/services/whatsapp/providers/whatsapp_baileys_service_spec.rb
+++ b/spec/services/whatsapp/providers/whatsapp_baileys_service_spec.rb
@@ -1048,7 +1048,7 @@
     end
     let(:conversation) do
       contact_inbox = create(:contact_inbox, inbox: inbox, contact: group_contact, source_id: group_jid.split('@').first)
-      create(:conversation, inbox: inbox, contact_inbox: contact_inbox, contact: group_contact, conversation_type: :group)
+      create(:conversation, inbox: inbox, contact_inbox: contact_inbox, contact: group_contact, group_type: :group)
     end
     let(:incoming_group_message) do
       create(:message, inbox: inbox, conversation: conversation, sender: sender_contact,
diff --git a/tasks/manual-testing.md b/tasks/manual-testing.md
new file mode 100644
index 0000000000000..1b62d958417f1
--- /dev/null
+++ b/tasks/manual-testing.md
@@ -0,0 +1,103 @@
+## Manual Test Checklist
+
+Execute esses testes manualmente ao final da implementação para garantir que tudo funciona como esperado. Pré-requisito: ter uma inbox Baileys conectada com ao menos um grupo existente no WhatsApp.
+
+### 1. Serialização & Dados
+
+- [ ] **T-01:** Abrir o DevTools → Network. Carregar a lista de conversas. Verificar que o JSON de cada conversa inclui o campo `group_type` (`"individual"` ou `"group"`).
+- [ ] **T-02:** Abrir uma conversa de grupo. Verificar que o JSON do contato no `meta.sender` inclui `group_type: "group"`.
+- [ ] **T-03:** Abrir uma conversa individual. Verificar que `group_type` é `"individual"` tanto na conversa quanto no contato.
+
+### 2. Filtros
+
+- [ ] **T-04:** No dropdown de filtro rápido (ícone de seta/sort), verificar que existe a seção "Type" com opções "All", "Individual", "Group".
+- [ ] **T-05:** Selecionar "Group" → apenas conversas de grupo aparecem na lista. Selecionar "Individual" → apenas individuais. Selecionar "All" → todas.
+- [ ] **T-06:** Fechar e reabrir o Chatwoot. Verificar que o filtro de tipo persiste (salvo em UI settings).
+- [ ] **T-07:** Abrir o filtro avançado. Verificar que `group_type` aparece como atributo de filtro em "Standard Filters".
+- [ ] **T-08:** Criar um filtro avançado: `group_type equal_to group`. Verificar que retorna apenas conversas de grupo.
+- [ ] **T-09:** Criar um filtro avançado: `group_type not_equal_to group`. Verificar que retorna apenas conversas individuais.
+
+### 3. Painel Lateral — GroupContactInfo
+
+- [ ] **T-10:** Abrir uma conversa de grupo. Verificar que o painel lateral mostra "Group" como título (não "Contact").
+- [ ] **T-11:** Verificar que o `GroupContactInfo` exibe: avatar do grupo, nome do grupo, contagem de membros ativos.
+- [ ] **T-12:** Verificar que a lista de membros mostra nome, avatar/placeholder, e badge "Admin" apenas para admins (membros sem badge).
+- [ ] **T-13:** Verificar que skeleton loading aparece enquanto os membros estão sendo carregados.
+- [ ] **T-14:** Verificar que membros inativos/removidos **não** aparecem na lista.
+- [ ] **T-15:** Abrir uma conversa individual. Verificar que o `ContactInfo` original aparece (sem regressão).
+- [ ] **T-16:** Verificar que as seções `contact_notes` e `contact_attributes` continuam visíveis para conversas de grupo.
+
+### 4. Sync do Grupo
+
+- [ ] **T-17:** Clicar no botão "Sync" no GroupContactInfo. Verificar que um spinner aparece durante o sync.
+- [ ] **T-18:** Após o sync, verificar que a lista de membros é atualizada (pode alterar um membro no WhatsApp antes para validar).
+- [ ] **T-19:** Verificar que um alerta de sucesso aparece após sync bem-sucedido.
+- [ ] **T-20:** Desconectar o provedor Baileys e tentar sync. Verificar que um alerta de erro aparece.
+
+### 5. Criação de Grupo
+
+- [ ] **T-21:** Abrir o modal/UI de criação de grupo. Verificar que é possível selecionar uma inbox (somente inboxes que suportam grupos).
+- [ ] **T-22:** Preencher nome do grupo e selecionar participantes. Submeter. Verificar que o grupo é criado no WhatsApp.
+- [ ] **T-23:** Verificar que após criação, o app navega para a nova conversa de grupo.
+- [ ] **T-24:** No WhatsApp, verificar que o grupo existe com o nome e participantes corretos.
+
+### 6. Gerenciamento de Membros
+
+- [ ] **T-25:** No GroupContactInfo, clicar em "Add member". Buscar um contato por nome/telefone. Adicionar. Verificar que o membro aparece na lista e foi adicionado no WhatsApp.
+- [ ] **T-26:** Remover um membro pelo menu de contexto. Verificar que desaparece da lista e foi removido no WhatsApp.
+- [ ] **T-27:** Promover um membro a admin. Verificar que o badge "Admin" aparece e a mudança reflete no WhatsApp.
+- [ ] **T-28:** Rebaixar um admin a membro. Verificar que o badge "Admin" desaparece e a mudança reflete no WhatsApp.
+- [ ] **T-29:** Verificar loading states durante add/remove/promote/demote.
+
+### 7. Edição de Metadados do Grupo
+
+- [ ] **T-30:** Clicar no nome do grupo para editar. Alterar o nome. Verificar que salva e atualiza no WhatsApp.
+- [ ] **T-31:** Editar a descrição do grupo. Verificar que salva e atualiza no WhatsApp.
+- [ ] **T-32:** Clicar no avatar para upload. Selecionar uma imagem. Verificar que a foto do grupo atualiza no Chatwoot e no WhatsApp.
+- [ ] **T-33:** Verificar loading states durante cada edição.
+
+### 8. Link de Convite
+
+- [ ] **T-34:** Na seção de invite link, verificar que o link é exibido.
+- [ ] **T-35:** Clicar em "Copy". Verificar que o link é copiado para a área de transferência (colar em algum lugar para confirmar).
+- [ ] **T-36:** Clicar em "Revoke & Regenerate". Verificar que um novo link é gerado (diferente do anterior).
+- [ ] **T-37:** Usar o link antigo (revogado) em um navegador — deve ser inválido.
+- [ ] **T-38:** Usar o novo link — deve funcionar (se join approval estiver desligado).
+
+### 9. Aprovação de Solicitações de Entrada
+
+- [ ] **T-39:** Ativar "join approval mode" no grupo via WhatsApp. Enviar o link de convite para um contato externo que solicite entrada.
+- [ ] **T-40:** Verificar que a seção "Pending Requests" aparece no GroupContactInfo com a solicitação.
+- [ ] **T-41:** Clicar em "Approve" em uma solicitação. Verificar que o contato entra no grupo no WhatsApp.
+- [ ] **T-42:** Clicar em "Reject" em outra solicitação. Verificar que o contato **não** entra no grupo.
+- [ ] **T-43:** Quando não há solicitações pendentes, verificar que a seção não é visível.
+
+### 10. Bolhas de Mensagem de Grupo
+
+- [ ] **T-44:** Abrir uma conversa de grupo com várias mensagens de diferentes remetentes. Verificar que cada bolha mostra o nome do remetente acima do texto.
+- [ ] **T-45:** Verificar que a cor do nome do remetente é consistente (mesmo remetente = mesma cor sempre) e varia entre remetentes diferentes.
+- [ ] **T-46:** Verificar que mensagens consecutivas do mesmo remetente **não** repetem o nome (só mostra na primeira da sequência).
+- [ ] **T-47:** Verificar que o avatar do remetente aparece à esquerda das bolhas (com foto se disponível, placeholder com iniciais se não).
+- [ ] **T-48:** Verificar que o avatar não se repete para mensagens consecutivas do mesmo remetente.
+- [ ] **T-49:** Abrir uma conversa individual. Verificar que nome e avatar do remetente **não** aparecem nas bolhas (sem regressão).
+
+### 11. Sistema de @Mentions
+
+- [ ] **T-50:** Em uma conversa de grupo, digitar `@` no editor de mensagens. Verificar que um dropdown de sugestão aparece com membros do grupo.
+- [ ] **T-51:** Digitar parte do nome de um membro após `@`. Verificar que o dropdown filtra corretamente.
+- [ ] **T-52:** Selecionar um membro do dropdown. Verificar que uma mention tag é inserida no editor.
+- [ ] **T-53:** Enviar a mensagem. Verificar que a mention aparece formatada/destacada na bolha de mensagem.
+- [ ] **T-54:** Em uma conversa individual, digitar `@`. Verificar que o dropdown de mention de grupo **não** aparece (comportamento existente de notas privadas permanece inalterado).
+
+### 12. Atualização em Tempo Real (ActionCable)
+
+- [ ] **T-55:** Abrir uma conversa de grupo no Chatwoot. Em paralelo, adicionar um membro ao grupo via WhatsApp diretamente. Verificar que o novo membro aparece na lista do sidebar automaticamente (sem refresh).
+- [ ] **T-56:** Remover um membro via WhatsApp. Verificar que desaparece da lista automaticamente.
+- [ ] **T-57:** Alterar o nome do grupo via WhatsApp. Verificar que atualiza no painel lateral automaticamente.
+
+### 13. Regressão — Conversas Individuais
+
+- [ ] **T-58:** Abrir uma conversa individual. Verificar que `ContactInfo` aparece normalmente (avatar, nome, email, telefone, ações).
+- [ ] **T-59:** Verificar que todas as seções do sidebar (actions, participants, info, attributes, previous conversations, notes, macros) funcionam normalmente.
+- [ ] **T-60:** Criar uma nova conversa individual. Verificar que nenhum elemento de grupo aparece.
+- [ ] **T-61:** Verificar que o filtro básico com "All" mostra tanto individuais quanto grupos corretamente.
diff --git a/tasks/prd-group-conversations-frontend.md b/tasks/prd-group-conversations-frontend.md
new file mode 100644
index 0000000000000..ff5f80085d7db
--- /dev/null
+++ b/tasks/prd-group-conversations-frontend.md
@@ -0,0 +1,446 @@
+# PRD: Group Conversations — Full Feature
+
+## Introduction
+
+Chatwoot already supports group conversations on the backend (models, API endpoints, Baileys provider integration). Group contacts (`group_type: :group`), group conversations (`conversation.group_type: :group`), and group members (`ConversationGroupMember`) are all stored and managed.
+
+This PRD covers the **full frontend implementation** and **backend expansions** needed to support groups end-to-end: API serialization, sidebar UI, filtering, group management (create, edit metadata, members, invite links), group message bubbles, and an `@mention` system for group conversations.
+
+### Key Backend Context
+
+| Concept | Backend Implementation |
+|---|---|
+| **Group contact** | `Contact` with `group_type: :group` |
+| **Group conversation** | `Conversation` with `group_type: :group` (column to be renamed from `conversation_type`) |
+| **Group member** | `ConversationGroupMember` (join table: conversation ↔ contact, with `role` and `is_active`) |
+| **Sync group** | `POST /api/v1/accounts/:account_id/contacts/:id/sync_group` — fetches latest group metadata from provider |
+| **List members** | `GET /api/v1/accounts/:account_id/contacts/:contact_id/group_members` — returns active members |
+
+**Important naming note:** The frontend already uses `conversationType` as a **routing concept** (values: `''`, `'mention'`, `'participating'`, `'unattended'`). The DB column on `conversations` will be renamed from `conversation_type` to `group_type` to avoid this collision. In the frontend, use `groupType` consistently for the model field.
+
+### Baileys Provider API Reference
+
+When implementing provider-level routes for groups, consult the Baileys SDK type definitions at `tasks/references/baileys.d.ts`. Key functions:
+
+| Baileys Function | Purpose |
+|---|---|
+| `groupCreate(subject, participants)` | Create a new group |
+| `groupMetadata(jid)` | Fetch group metadata (name, desc, participants) |
+| `groupUpdateSubject(jid, subject)` | Update group name |
+| `groupUpdateDescription(jid, description?)` | Update group description |
+| `groupParticipantsUpdate(jid, participants, action)` | Add/remove/promote/demote participants |
+| `groupInviteCode(jid)` | Get invite link code |
+| `groupRevokeInvite(jid)` | Revoke and regenerate invite link |
+| `groupAcceptInvite(code)` | Accept an invite code |
+| `groupSettingUpdate(jid, setting)` | Toggle announcement/locked settings |
+| `groupMemberAddMode(jid, mode)` | Set who can add members (admin_add / all_member_add) |
+| `groupJoinApprovalMode(jid, mode)` | Toggle join approval (on/off) |
+| `groupRequestParticipantsList(jid)` | List pending join requests |
+| `groupRequestParticipantsUpdate(jid, participants, action)` | Approve/reject join requests |
+
+## Goals
+
+- Rename `conversation_type` column to `group_type` on the `conversations` table to avoid frontend naming conflicts
+- Expose `group_type` in both conversation and contact API JSON responses
+- Allow agents to filter conversations by type (all/individual/group) in basic and advanced filters
+- Replace `ContactInfo` with a dedicated `GroupContactInfo` component for group conversations in the sidebar (keep `contact_notes` and `contact_attributes` sections)
+- Allow agents to **create groups**, **add/remove members**, **promote/demote admins**, **approve join requests via invite link**
+- Allow agents to **edit group metadata** (name, description, avatar) via new backend routes proxying to Baileys
+- Generate and manage **group invite links**
+- Render **group-specific message bubbles** with colored sender names and sender avatars
+- Implement **@mentions in group conversations** (inspired by the existing private note mention system)
+- Handle real-time group updates via ActionCable
+
+## User Stories
+
+### US-001: Rename conversation_type to group_type (Backend Refactor)
+**Description:** As a developer, I need to rename the `conversation_type` column on `conversations` to `group_type` to avoid naming conflicts with the frontend's routing `conversationType` concept.
+
+**Acceptance Criteria:**
+- [ ] New migration renames column `conversation_type` to `group_type` on the `conversations` table
+- [ ] `Conversation` model enum updated: `enum group_type: { individual: 0, group: 1 }`
+- [ ] All backend references updated (model, concerns, services, controllers, specs, serializers, handlers)
+- [ ] Frontend references to `conversation_type` (routing concept) remain untouched
+- [ ] All existing specs pass
+- [ ] Typecheck/lint passes
+
+---
+
+### US-002: Serialize group fields in API responses
+**Description:** As a frontend consumer, I need `group_type` in both conversation and contact JSON so the UI can identify group conversations and contacts.
+
+**Acceptance Criteria:**
+- [ ] `group_type` field added to `app/views/api/v1/conversations/partials/_conversation.json.jbuilder` (outputs `'individual'` or `'group'`)
+- [ ] `group_type` field added to `app/views/api/v1/models/_contact.json.jbuilder` (outputs `'individual'` or `'group'`)
+- [ ] Existing API responses for conversations and contacts include the new fields
+- [ ] No regressions in existing conversation/contact endpoints
+- [ ] Typecheck/lint passes
+
+---
+
+### US-003: Create frontend API clients for group endpoints
+**Description:** As a developer, I need API client methods for group-related endpoints so Vue components can call backend group APIs.
+
+**Acceptance Criteria:**
+- [ ] New file `app/javascript/dashboard/api/groupMembers.js` with methods:
+  - `getGroupMembers(accountId, contactId)` → `GET /api/v1/accounts/:account_id/contacts/:contact_id/group_members`
+  - `syncGroup(accountId, contactId)` → `POST /api/v1/accounts/:account_id/contacts/:id/sync_group`
+  - `createGroup(accountId, params)` → `POST /api/v1/accounts/:account_id/groups` (new endpoint, see US-010)
+  - `updateGroupMetadata(accountId, contactId, params)` → `PATCH /api/v1/accounts/:account_id/contacts/:id/group_metadata` (see US-012)
+  - `addMembers(accountId, contactId, memberIds)` → `POST /api/v1/accounts/:account_id/contacts/:id/group_members`
+  - `removeMembers(accountId, contactId, memberIds)` → `DELETE /api/v1/accounts/:account_id/contacts/:id/group_members`
+  - `updateMemberRole(accountId, contactId, memberId, role)` → `PATCH /api/v1/accounts/:account_id/contacts/:id/group_members/:member_id`
+  - `getInviteLink(accountId, contactId)` → `GET /api/v1/accounts/:account_id/contacts/:id/group_invite`
+  - `revokeInviteLink(accountId, contactId)` → `POST /api/v1/accounts/:account_id/contacts/:id/group_invite/revoke`
+  - `getPendingRequests(accountId, contactId)` → `GET /api/v1/accounts/:account_id/contacts/:id/group_join_requests`
+  - `handleJoinRequest(accountId, contactId, params)` → `POST /api/v1/accounts/:account_id/contacts/:id/group_join_requests/handle`
+- [ ] API methods follow existing `ApiClient` patterns used in the codebase
+- [ ] Typecheck/lint passes
+
+---
+
+### US-004: Create group members Vuex store module
+**Description:** As a developer, I need a Vuex store module to manage group member state (fetch, cache, sync, add, remove) so components can reactively access group data.
+
+**Acceptance Criteria:**
+- [ ] New store module at `app/javascript/dashboard/store/modules/groupMembers.js`
+- [ ] State: `records` (keyed by contactId → array of members), `uiFlags` (isFetching, isSyncing, isUpdating)
+- [ ] Getters: `getGroupMembers(contactId)`, `getUIFlags`
+- [ ] Actions: `fetch({ contactId })`, `sync({ contactId })` (calls sync_group, then re-fetches members), `addMembers(...)`, `removeMembers(...)`, `updateMemberRole(...)`
+- [ ] Mutations: `SET_GROUP_MEMBERS`, `SET_UI_FLAG`
+- [ ] Module registered in the global store (`app/javascript/dashboard/store/index.js`)
+- [ ] Typecheck/lint passes
+
+---
+
+### US-005: Add i18n keys for group features
+**Description:** As a developer, I need English and pt-BR i18n keys for all group-related UI text.
+
+**Acceptance Criteria:**
+- [ ] Keys added to `app/javascript/dashboard/i18n/locale/en/` JSON files
+- [ ] Keys cover: group members section title, admin role badge, sync button label, sync success/error messages, empty state, filter labels (type: all/individual/group), group info header, create group labels, edit metadata labels, invite link labels, member management labels, mention UI labels, join request labels
+- [ ] pt-BR translations added for all new keys
+- [ ] Typecheck/lint passes
+
+---
+
+### US-006: Add group_type filter to ConversationBasicFilter
+**Description:** As an agent, I want to filter the conversation list by type (all/individual/group) in the basic filter dropdown.
+
+**Acceptance Criteria:**
+- [ ] New "Type" section in `ConversationBasicFilter.vue` dropdown (alongside existing Status and Sort Order sections)
+- [ ] Options: "All" (default), "Individual", "Group"
+- [ ] Selected filter is persisted in UI settings (`conversations_filter_by.group_type`)
+- [ ] Filter value is passed to the conversation list API call and correctly filters results
+- [ ] Backend handles the new `group_type` query parameter in the conversations index endpoint to filter by `group_type` column
+- [ ] Typecheck/lint passes
+
+---
+
+### US-007: Add group_type to advanced filter system
+**Description:** As an agent, I want to filter conversations by type in the advanced filter for complex filter rules.
+
+**Acceptance Criteria:**
+- [ ] New filter attribute `group_type` added to `advancedFilterItems/index.js` with `inputType: 'multi_select'` and operators `equal_to`, `not_equal_to`
+- [ ] Added to `filterAttributeGroups` under "Standard Filters"
+- [ ] i18n key for the filter attribute added
+- [ ] Filter options provided: `individual`, `group` (with i18n labels)
+- [ ] Backend: `group_type` added to `lib/filters/filter_keys.yml` under `conversations:` with `attribute_type: "standard"`, `data_type: "text"`, operators `equal_to`/`not_equal_to`
+- [ ] Advanced filter correctly returns only matching conversations
+- [ ] Typecheck/lint passes
+
+---
+
+### US-008: Create GroupContactInfo component
+**Description:** As an agent, I want to see group-specific info (group name, member count, member list with roles, sync button) in the right sidebar when viewing a group conversation.
+
+**Acceptance Criteria:**
+- [ ] New component `app/javascript/dashboard/routes/dashboard/conversation/contact/GroupContactInfo.vue` using `<script setup>` and Composition API
+- [ ] Displays: group avatar, group name, active member count
+- [ ] Lists all active group members with: thumbnail/avatar, name; admin badge only (members have no badge)
+- [ ] "Sync group" button that dispatches `groupMembers/sync` action, shows spinner during sync, and shows success/error alert
+- [ ] Skeleton loading placeholders while fetching members
+- [ ] Uses Tailwind utility classes only (no custom/scoped CSS)
+- [ ] Fetches group members on mount via `groupMembers/fetch` action
+- [ ] Only shows active members (not inactive/removed)
+- [ ] Member count displayed prominently
+- [ ] Typecheck/lint passes
+
+---
+
+### US-009: Integrate GroupContactInfo in ContactPanel
+**Description:** As a system, I need to conditionally render `GroupContactInfo` instead of `ContactInfo` in the sidebar when viewing a group conversation.
+
+**Acceptance Criteria:**
+- [ ] `ContactPanel.vue` imports `GroupContactInfo`
+- [ ] When `currentChat.group_type === 'group'`, renders `GroupContactInfo` instead of `ContactInfo`
+- [ ] When conversation is individual (or no type), renders existing `ContactInfo` (no regression)
+- [ ] Sidebar title changes to group-appropriate text (e.g., "Group" instead of "Contact") for group conversations
+- [ ] Keeps `contact_notes` and `contact_attributes` sections visible for group conversations
+- [ ] Typecheck/lint passes
+
+---
+
+### US-010: Backend — Group creation endpoint
+**Description:** As an agent, I want to create a new WhatsApp group from the Chatwoot UI so I can start group conversations directly.
+
+**Acceptance Criteria:**
+- [ ] New controller action: `POST /api/v1/accounts/:account_id/groups` accepting `{ inbox_id, subject, participants: [phone_numbers] }`
+- [ ] Service delegates to the channel provider (e.g., `WhatsappBaileysService`) which calls Baileys `groupCreate(subject, participants)`
+- [ ] On success: creates `Contact` (group_type: group), `ContactInbox`, `Conversation` (group_type: group), and `ConversationGroupMember` records for all participants
+- [ ] Returns the created conversation with group metadata
+- [ ] Proper authorization (agent must have access to the inbox)
+- [ ] Specs for controller and service
+- [ ] Typecheck/lint passes
+
+---
+
+### US-011: Backend — Add/remove members and role management
+**Description:** As an agent, I want to add/remove members from a group and promote/demote admins so I can manage group composition.
+
+**Acceptance Criteria:**
+- [ ] `POST /api/v1/accounts/:account_id/contacts/:id/group_members` — add participants (accepts `{ participants: [phone_numbers] }`)
+- [ ] `DELETE /api/v1/accounts/:account_id/contacts/:id/group_members` — remove participants (accepts `{ participants: [phone_numbers] }`)
+- [ ] `PATCH /api/v1/accounts/:account_id/contacts/:id/group_members/:member_id` — update role (accepts `{ role: 'admin' | 'member' }`)
+- [ ] Each action delegates to the channel provider which calls Baileys `groupParticipantsUpdate(jid, participants, action)` with action `add`/`remove`/`promote`/`demote`
+- [ ] Backend updates `ConversationGroupMember` records accordingly (create, soft-delete via `is_active`, update role)
+- [ ] Proper authorization and error handling
+- [ ] Specs for controller and service
+- [ ] Typecheck/lint passes
+
+---
+
+### US-012: Backend — Group metadata update endpoint
+**Description:** As an agent, I want to edit group name, description, and avatar from the Chatwoot UI.
+
+**Acceptance Criteria:**
+- [ ] `PATCH /api/v1/accounts/:account_id/contacts/:id/group_metadata` accepting `{ subject, description }`
+- [ ] Avatar upload uses the existing contact avatar update mechanism (`contacts#update` with `avatar` param), which should proxy to the provider for group contacts
+- [ ] Service delegates to the channel provider calling Baileys `groupUpdateSubject`, `groupUpdateDescription`, and `updateProfilePicture` as needed
+- [ ] Backend updates the `Contact` record (name, additional_attributes.description)
+- [ ] Proper authorization and error handling
+- [ ] Specs for controller and service
+- [ ] Typecheck/lint passes
+
+---
+
+### US-013: Backend — Invite link management
+**Description:** As an agent, I want to generate and manage a group invite link so external users can join the group.
+
+**Acceptance Criteria:**
+- [ ] `GET /api/v1/accounts/:account_id/contacts/:id/group_invite` — returns current invite code/URL (calls Baileys `groupInviteCode(jid)`)
+- [ ] `POST /api/v1/accounts/:account_id/contacts/:id/group_invite/revoke` — revokes current link and generates a new one (calls Baileys `groupRevokeInvite(jid)`)
+- [ ] Response includes the full invite URL
+- [ ] Proper authorization (only admins should be able to manage invite links — or follow group settings)
+- [ ] Specs for controller and service
+- [ ] Typecheck/lint passes
+
+---
+
+### US-014: Backend — Join request management
+**Description:** As an agent/admin, I want to see pending join requests and approve/reject them when the group has join approval mode enabled.
+
+**Acceptance Criteria:**
+- [ ] `GET /api/v1/accounts/:account_id/contacts/:id/group_join_requests` — lists pending join requests (calls Baileys `groupRequestParticipantsList(jid)`)
+- [ ] `POST /api/v1/accounts/:account_id/contacts/:id/group_join_requests/handle` — approve or reject requests (accepts `{ participants: [jids], action: 'approve' | 'reject' }`, calls Baileys `groupRequestParticipantsUpdate(jid, participants, action)`)
+- [ ] Proper authorization
+- [ ] Specs for controller and service
+- [ ] Typecheck/lint passes
+
+---
+
+### US-015: Frontend — Group creation UI
+**Description:** As an agent, I want a UI to create a new group by selecting an inbox, entering a group name, and choosing initial participants.
+
+**Acceptance Criteria:**
+- [ ] New component/modal for group creation accessible from a relevant UI entry point (e.g., "New Group" button)
+- [ ] Form fields: inbox selector (only inboxes supporting groups), group name (subject), participant selector (search contacts by phone/name)
+- [ ] Calls `groupMembers/createGroup` store action on submit
+- [ ] Shows success notification and navigates to the new group conversation on success
+- [ ] Shows error notification on failure
+- [ ] Uses `<script setup>` and Composition API, Tailwind only
+- [ ] Typecheck/lint passes
+
+---
+
+### US-016: Frontend — Member management UI in GroupContactInfo
+**Description:** As an agent, I want to add/remove members and change roles directly from the GroupContactInfo sidebar panel.
+
+**Acceptance Criteria:**
+- [ ] "Add member" button in GroupContactInfo that opens a contact search/select input
+- [ ] Each member row has a context menu or action buttons: "Promote to admin" / "Demote to member" / "Remove from group"
+- [ ] Actions call corresponding store actions (which call API endpoints from US-011)
+- [ ] Loading states and success/error alerts for each action
+- [ ] Skeleton loading for initial member list load
+- [ ] Uses `<script setup>` and Composition API, Tailwind only
+- [ ] Typecheck/lint passes
+
+---
+
+### US-017: Frontend — Group metadata editing UI
+**Description:** As an agent, I want to edit the group name, description, and avatar from the sidebar.
+
+**Acceptance Criteria:**
+- [ ] Inline editable group name (click to edit, enter/blur to save)
+- [ ] Editable description field (click to edit, save)
+- [ ] Avatar click opens file picker for upload (uses existing contact avatar update flow, extended for group provider sync)
+- [ ] Each edit calls the appropriate API endpoint (US-012)
+- [ ] Loading states and success/error alerts
+- [ ] Uses `<script setup>` and Composition API, Tailwind only
+- [ ] Typecheck/lint passes
+
+---
+
+### US-018: Frontend — Invite link management UI
+**Description:** As an agent, I want to view, copy, and revoke the group invite link from the sidebar.
+
+**Acceptance Criteria:**
+- [ ] "Invite Link" section in GroupContactInfo or as an accordion section
+- [ ] Shows the current invite link with a "Copy" button
+- [ ] "Revoke & Regenerate" button that revokes the current link and fetches a new one
+- [ ] Loading states during fetch/revoke
+- [ ] Uses `<script setup>` and Composition API, Tailwind only
+- [ ] Typecheck/lint passes
+
+---
+
+### US-019: Frontend — Join request management UI
+**Description:** As an agent, I want to see pending join requests and approve/reject them from the sidebar when join approval mode is enabled.
+
+**Acceptance Criteria:**
+- [ ] "Pending Requests" section in GroupContactInfo (only visible when there are pending requests)
+- [ ] Lists pending requests with requester name/phone and "Approve" / "Reject" buttons
+- [ ] Actions call the API endpoint from US-014
+- [ ] Loading and success/error states
+- [ ] Uses `<script setup>` and Composition API, Tailwind only
+- [ ] Typecheck/lint passes
+
+---
+
+### US-020: Group message bubbles — Sender name with color
+**Description:** As an agent, I want group message bubbles to display the sender's name above the message text, with a distinct color per sender, so I can easily distinguish who sent each message.
+
+**Acceptance Criteria:**
+- [ ] In group conversations, each incoming message bubble shows the sender's name above the message content
+- [ ] Sender name color is deterministic and derived from the sender's name hash, using the same color palette as the `Avatar` component (6 color pairs, index = `name.length % 6`)
+- [ ] Sender name is not shown for consecutive messages from the same sender (group by sender)
+- [ ] Sender name is clickable/linkable to the contact profile (optional, evaluate)
+- [ ] Works in `components-next/` message bubble components
+- [ ] Typecheck/lint passes
+
+---
+
+### US-021: Group message bubbles — Sender avatar
+**Description:** As an agent, I want to see the sender's avatar thumbnail next to group message bubbles so I can visually identify senders.
+
+**Acceptance Criteria:**
+- [ ] In group conversations, each incoming message shows the sender's avatar on the left side of the bubble
+- [ ] Avatar uses the sender's `thumbnail` if available, otherwise shows the avatar placeholder with initials and color (matching the name color from US-020)
+- [ ] Avatar is not repeated for consecutive messages from the same sender (show only on the first message of a group)
+- [ ] Works in `components-next/` message bubble components
+- [ ] Typecheck/lint passes
+
+---
+
+### US-022: @Mention system for group conversations
+**Description:** As an agent, I want to @mention group members in messages so they receive a notification and can be highlighted in the conversation.
+
+**Acceptance Criteria:**
+- [ ] Typing `@` in the message editor for a **group conversation** triggers a mention suggestion dropdown (similar to the existing private note mention feature)
+- [ ] The dropdown lists **group members** (contacts from the group), not agents — filtering as the user types
+- [ ] Each item in the dropdown shows avatar, name, and phone number
+- [ ] Selecting a mention inserts a mention node into the ProseMirror editor (format: `[@DisplayName](mention://contact/ID/EncodedName)`)
+- [ ] Mention text is rendered highlighted in the message bubble
+- [ ] Backend: new mention type `contact` handled in `Messages::MentionService` (currently only handles `user` and `team` types)
+- [ ] Backend: when a group message contains contact mentions, the mentioned contacts can be tracked (for future notification/highlight features)
+- [ ] Uses the existing mention infrastructure (ProseMirror `suggestionsPlugin`, `createNode('mention', ...)`) extended for contact mentions
+- [ ] Typecheck/lint passes
+
+---
+
+### US-023: Handle real-time group updates via ActionCable
+**Description:** As a system, when a `contact.group_synced` event is received via ActionCable, the frontend should update the group members in the store directly from the event payload.
+
+**Acceptance Criteria:**
+- [ ] ActionCable handler listens for `contact.group_synced` event
+- [ ] On receiving the event, the handler extracts the group members data directly from the event payload (no additional API call needed)
+- [ ] Commits the data to the `groupMembers` store via mutation
+- [ ] Group member list in sidebar updates reactively
+- [ ] Typecheck/lint passes
+
+## Functional Requirements
+
+- **FR-1:** Rename `conversation_type` column to `group_type` on `conversations` table; update all backend references
+- **FR-2:** Add `group_type` to both conversation and contact JSON serializers
+- **FR-3:** Create frontend API client with methods for all group endpoints (members, sync, create, metadata, invite, join requests)
+- **FR-4:** Create Vuex store module `groupMembers` with full CRUD state management
+- **FR-5:** Add all i18n keys (en + pt-BR) for group UI text
+- **FR-6:** Add "Type" filter section in `ConversationBasicFilter` dropdown (All/Individual/Group), persisted in UI settings
+- **FR-7:** Add `group_type` to the advanced filter system (frontend + backend filter_keys.yml)
+- **FR-8:** Create `GroupContactInfo.vue` displaying group avatar, name, member count, member list (admin badge only), sync button with skeleton loading
+- **FR-9:** Conditionally render `GroupContactInfo` vs `ContactInfo` in `ContactPanel.vue` based on `group_type`; keep `contact_notes` and `contact_attributes` visible for groups
+- **FR-10:** Backend endpoint for group creation delegating to Baileys `groupCreate`
+- **FR-11:** Backend endpoints for add/remove members and role management delegating to Baileys `groupParticipantsUpdate`
+- **FR-12:** Backend endpoint for group metadata update (name, description) delegating to Baileys `groupUpdateSubject`/`groupUpdateDescription`; avatar upload via existing contact update + provider profile picture update
+- **FR-13:** Backend endpoints for invite link get/revoke delegating to Baileys `groupInviteCode`/`groupRevokeInvite`
+- **FR-14:** Backend endpoints for join request list/approve/reject delegating to Baileys `groupRequestParticipantsList`/`groupRequestParticipantsUpdate`
+- **FR-15:** Frontend UI for group creation (modal with inbox, name, participant selection)
+- **FR-16:** Frontend member management UI in GroupContactInfo (add, remove, promote/demote)
+- **FR-17:** Frontend group metadata editing (inline editable name/description, avatar upload)
+- **FR-18:** Frontend invite link management (view, copy, revoke)
+- **FR-19:** Frontend join request management (list, approve, reject)
+- **FR-20:** Group message bubbles with colored sender names (color from name hash, same palette as Avatar: `name.length % 6`) and sender avatars
+- **FR-21:** @mention system in group conversations targeting group member contacts (extends existing ProseMirror mention infrastructure)
+- **FR-22:** Handle `contact.group_synced` ActionCable event using event payload data directly (no re-fetch)
+
+## Non-Goals
+
+- No notifications or sounds specific to group conversations (use existing notification system)
+- No group-to-group messaging (a group is always tied to a provider group like WhatsApp)
+- No bulk group operations (e.g., merge groups, archive all groups)
+- No automated group creation rules or templates
+- No group analytics or reporting dashboard
+- No changes to the conversation card in the list (no special group badge/icon — filtering handles differentiation)
+
+## Design Considerations
+
+- **GroupContactInfo** should follow the same layout patterns as `ContactInfo` (padding, typography, avatar size) for visual consistency
+- Member list should be scrollable if the group has many members (use `max-h-*` + `overflow-y-auto`)
+- Sync button shows a **spinner** during sync
+- **Skeleton loading placeholders** for member list while fetching, and for any section loading group data
+- **Admin badge only** — members have no badge; admin role gets a subtle badge (e.g., small "Admin" text badge or shield icon)
+- Sender name colors in group message bubbles use the same palette and algorithm as the `Avatar` component: `AVATAR_COLORS[mode][name.length % 6]`
+- Sender avatars in message bubbles follow the same placeholder logic (initials + color) when no thumbnail is available
+- Mention dropdown for group contacts follows the same pattern as `TagAgents.vue` but shows contacts instead of agents
+- Reuse existing components: `Avatar`, `NextButton`, `AccordionItem`, `SelectMenu`, `MentionBox`, skeleton components, and others available in the component library — the components listed here are examples; use any existing component that fits
+- Follow **Tailwind-only** styling as per project guidelines (no custom CSS, no scoped CSS, no inline styles)
+
+## Technical Considerations
+
+- **Column rename:** `conversation_type` → `group_type` requires a migration + updating all references across the backend (model enums, concerns, services, controllers, handlers, specs, JBuilder views). The frontend routing `conversationType` remains unchanged.
+- **Store key pattern:** Use `contactId` as the key for group members in the store (since group members are associated with the group contact, and a group contact may have multiple conversations)
+- **ActionCable event:** The `contact.group_synced` event payload already includes all group member data. The frontend handler should directly commit this data to the store without making an additional API call.
+- The conversation serializer already has an enterprise partial include — no conflict with adding `group_type`
+- Group members API response shape: `{ payload: [{ id, role, is_active, conversation_id, contact: { id, name, phone_number, identifier, thumbnail } }] }`
+- **Baileys provider routes:** All new group management endpoints (create, members, metadata, invite, join requests) must be implemented first as abstract methods on the base channel service, then implemented concretely in `WhatsappBaileysService`. Refer to `tasks/references/baileys.d.ts` for available Baileys functions.
+- **Mention system extension:** The existing `suggestionsPlugin` supports multiple triggers. For group conversations, the `@` trigger should show group member contacts instead of agents (keep listing agents on private note). The `mention_service.rb` backend needs to handle `mention://contact/ID/Name` format alongside existing `mention://user/ID/Name`.
+- **Message bubble components:** Group-specific rendering (sender name, sender avatar) should be implemented in `components-next/` where message bubbles live.
+
+## Success Metrics
+
+- Agents can identify and filter group conversations in under 2 clicks (basic filter dropdown)
+- Group member list loads within 1 second of opening the sidebar (with skeleton loading visible during fetch)
+- Sync button successfully refreshes group members from the provider
+- Group creation from UI results in a working group on the provider within 3 seconds
+- Member add/remove/role changes are reflected both in the provider and in the UI
+- @mentions in group messages trigger the suggestion dropdown with < 200ms latency
+- No regressions in individual conversation sidebar behavior
+
+## Open Questions
+
+- Should the invite link section be visible by default or collapsed in an accordion?
+  - Always visible with copy button to the side
+- Should @mentions in group messages also create `Mention` records for contacts (extending the current user-only model), or only track them at the message level?
+  - Yes
+- What should happen if the provider (Baileys) is unavailable when trying to create/modify a group — retry queue, or immediate error?
+  - Immediate error with user-friendly message
diff --git a/tasks/references/baileys.d.ts b/tasks/references/baileys.d.ts
new file mode 100644
index 0000000000000..f638271c04553
--- /dev/null
+++ b/tasks/references/baileys.d.ts
@@ -0,0 +1,233 @@
+import type { UserFacingSocketConfig } from '../Types/index.js';
+declare const makeWASocket: (config: UserFacingSocketConfig) => {
+    communityMetadata: (jid: string) => Promise<import("../index.js").GroupMetadata>;
+    communityCreate: (subject: string, body: string) => Promise<import("../index.js").GroupMetadata | null>;
+    communityCreateGroup: (subject: string, participants: string[], parentCommunityJid: string) => Promise<import("../index.js").GroupMetadata | null>;
+    communityLeave: (id: string) => Promise<void>;
+    communityUpdateSubject: (jid: string, subject: string) => Promise<void>;
+    communityLinkGroup: (groupJid: string, parentCommunityJid: string) => Promise<void>;
+    communityUnlinkGroup: (groupJid: string, parentCommunityJid: string) => Promise<void>;
+    communityFetchLinkedGroups: (jid: string) => Promise<{
+        communityJid: string;
+        isCommunity: boolean;
+        linkedGroups: {
+            id: string | undefined;
+            subject: string;
+            creation: number | undefined;
+            owner: string | undefined;
+            size: number | undefined;
+        }[];
+    }>;
+    communityRequestParticipantsList: (jid: string) => Promise<{
+        [key: string]: string;
+    }[]>;
+    communityRequestParticipantsUpdate: (jid: string, participants: string[], action: "approve" | "reject") => Promise<{
+        status: string;
+        jid: string | undefined;
+    }[]>;
+    communityParticipantsUpdate: (jid: string, participants: string[], action: import("../index.js").ParticipantAction) => Promise<{
+        status: string;
+        jid: string | undefined;
+        content: import("../index.js").BinaryNode;
+    }[]>;
+    communityUpdateDescription: (jid: string, description?: string) => Promise<void>;
+    communityInviteCode: (jid: string) => Promise<string | undefined>;
+    communityRevokeInvite: (jid: string) => Promise<string | undefined>;
+    communityAcceptInvite: (code: string) => Promise<string | undefined>;
+    communityRevokeInviteV4: (communityJid: string, invitedJid: string) => Promise<boolean>;
+    communityAcceptInviteV4: (key: string | import("../index.js").WAMessageKey, inviteMessage: import("../index.js").proto.Message.IGroupInviteMessage) => Promise<any>;
+    communityGetInviteInfo: (code: string) => Promise<import("../index.js").GroupMetadata>;
+    communityToggleEphemeral: (jid: string, ephemeralExpiration: number) => Promise<void>;
+    communitySettingUpdate: (jid: string, setting: "announcement" | "not_announcement" | "locked" | "unlocked") => Promise<void>;
+    communityMemberAddMode: (jid: string, mode: "admin_add" | "all_member_add") => Promise<void>;
+    communityJoinApprovalMode: (jid: string, mode: "on" | "off") => Promise<void>;
+    communityFetchAllParticipating: () => Promise<{
+        [_: string]: import("../index.js").GroupMetadata;
+    }>;
+    logger: import("../Utils/logger.js").ILogger;
+    getOrderDetails: (orderId: string, tokenBase64: string) => Promise<import("../index.js").OrderDetails>;
+    getCatalog: ({ jid, limit, cursor }: import("../index.js").GetCatalogOptions) => Promise<{
+        products: import("../index.js").Product[];
+        nextPageCursor: string | undefined;
+    }>;
+    getCollections: (jid?: string, limit?: number) => Promise<{
+        collections: import("../index.js").CatalogCollection[];
+    }>;
+    productCreate: (create: import("../index.js").ProductCreate) => Promise<import("../index.js").Product>;
+    productDelete: (productIds: string[]) => Promise<{
+        deleted: number;
+    }>;
+    productUpdate: (productId: string, update: import("../index.js").ProductUpdate) => Promise<import("../index.js").Product>;
+    updateBussinesProfile: (args: import("../Types/Bussines.js").UpdateBussinesProfileProps) => Promise<any>;
+    updateCoverPhoto: (photo: import("../index.js").WAMediaUpload) => Promise<number>;
+    removeCoverPhoto: (id: string) => Promise<any>;
+    sendMessageAck: ({ tag, attrs, content }: import("../index.js").BinaryNode, errorCode?: number) => Promise<void>;
+    sendRetryRequest: (node: import("../index.js").BinaryNode, forceIncludeKeys?: boolean) => Promise<void>;
+    rejectCall: (callId: string, callFrom: string) => Promise<void>;
+    fetchMessageHistory: (count: number, oldestMsgKey: import("../index.js").WAMessageKey, oldestMsgTimestamp: number | Long) => Promise<string>;
+    requestPlaceholderResend: (messageKey: import("../index.js").WAMessageKey) => Promise<string | undefined>;
+    messageRetryManager: import("../index.js").MessageRetryManager | null;
+    getPrivacyTokens: (jids: string[]) => Promise<any>;
+    assertSessions: (jids: string[], force?: boolean) => Promise<boolean>;
+    relayMessage: (jid: string, message: import("../index.js").proto.IMessage, { messageId: msgId, participant, additionalAttributes, additionalNodes, useUserDevicesCache, useCachedGroupMetadata, statusJidList }: import("../index.js").MessageRelayOptions) => Promise<string>;
+    sendReceipt: (jid: string, participant: string | undefined, messageIds: string[], type: import("../index.js").MessageReceiptType) => Promise<void>;
+    sendReceipts: (keys: import("../index.js").WAMessageKey[], type: import("../index.js").MessageReceiptType) => Promise<void>;
+    readMessages: (keys: import("../index.js").WAMessageKey[]) => Promise<void>;
+    refreshMediaConn: (forceGet?: boolean) => Promise<import("../index.js").MediaConnInfo>;
+    waUploadToServer: import("../index.js").WAMediaUploadFunction;
+    fetchPrivacySettings: (force?: boolean) => Promise<{
+        [_: string]: string;
+    }>;
+    sendPeerDataOperationMessage: (pdoMessage: import("../index.js").proto.Message.IPeerDataOperationRequestMessage) => Promise<string>;
+    createParticipantNodes: (recipientJids: string[], message: import("../index.js").proto.IMessage, extraAttrs?: import("../index.js").BinaryNode["attrs"], dsmMessage?: import("../index.js").proto.IMessage) => Promise<{
+        nodes: import("../index.js").BinaryNode[];
+        shouldIncludeDeviceIdentity: boolean;
+    }>;
+    getUSyncDevices: (jids: string[], useCache: boolean, ignoreZeroDevices: boolean) => Promise<(import("../index.js").JidWithDevice & {
+        jid: string;
+    })[]>;
+    updateMediaMessage: (message: import("../index.js").WAMessage) => Promise<import("../index.js").WAMessage>;
+    sendMessage: (jid: string, content: import("../index.js").AnyMessageContent, options?: import("../index.js").MiscMessageGenerationOptions) => Promise<import("../index.js").WAMessage | undefined>;
+    newsletterCreate: (name: string, description?: string) => Promise<import("../index.js").NewsletterMetadata>;
+    newsletterUpdate: (jid: string, updates: import("../index.js").NewsletterUpdate) => Promise<unknown>;
+    newsletterSubscribers: (jid: string) => Promise<{
+        subscribers: number;
+    }>;
+    newsletterMetadata: (type: "invite" | "jid", key: string) => Promise<import("../index.js").NewsletterMetadata | null>;
+    newsletterFollow: (jid: string) => Promise<unknown>;
+    newsletterUnfollow: (jid: string) => Promise<unknown>;
+    newsletterMute: (jid: string) => Promise<unknown>;
+    newsletterUnmute: (jid: string) => Promise<unknown>;
+    newsletterUpdateName: (jid: string, name: string) => Promise<unknown>;
+    newsletterUpdateDescription: (jid: string, description: string) => Promise<unknown>;
+    newsletterUpdatePicture: (jid: string, content: import("../index.js").WAMediaUpload) => Promise<unknown>;
+    newsletterRemovePicture: (jid: string) => Promise<unknown>;
+    newsletterReactMessage: (jid: string, serverId: string, reaction?: string) => Promise<void>;
+    newsletterFetchMessages: (jid: string, count: number, since: number, after: number) => Promise<any>;
+    subscribeNewsletterUpdates: (jid: string) => Promise<{
+        duration: string;
+    } | null>;
+    newsletterAdminCount: (jid: string) => Promise<number>;
+    newsletterChangeOwner: (jid: string, newOwnerJid: string) => Promise<void>;
+    newsletterDemote: (jid: string, userJid: string) => Promise<void>;
+    newsletterDelete: (jid: string) => Promise<void>;
+    groupMetadata: (jid: string) => Promise<import("../index.js").GroupMetadata>;
+    groupCreate: (subject: string, participants: string[]) => Promise<import("../index.js").GroupMetadata>;
+    groupLeave: (id: string) => Promise<void>;
+    groupUpdateSubject: (jid: string, subject: string) => Promise<void>;
+    groupRequestParticipantsList: (jid: string) => Promise<{
+        [key: string]: string;
+    }[]>;
+    groupRequestParticipantsUpdate: (jid: string, participants: string[], action: "approve" | "reject") => Promise<{
+        status: string;
+        jid: string | undefined;
+    }[]>;
+    groupParticipantsUpdate: (jid: string, participants: string[], action: import("../index.js").ParticipantAction) => Promise<{
+        status: string;
+        jid: string | undefined;
+        content: import("../index.js").BinaryNode;
+    }[]>;
+    groupUpdateDescription: (jid: string, description?: string) => Promise<void>;
+    groupInviteCode: (jid: string) => Promise<string | undefined>;
+    groupRevokeInvite: (jid: string) => Promise<string | undefined>;
+    groupAcceptInvite: (code: string) => Promise<string | undefined>;
+    groupRevokeInviteV4: (groupJid: string, invitedJid: string) => Promise<boolean>;
+    groupAcceptInviteV4: (key: string | import("../index.js").WAMessageKey, inviteMessage: import("../index.js").proto.Message.IGroupInviteMessage) => Promise<any>;
+    groupGetInviteInfo: (code: string) => Promise<import("../index.js").GroupMetadata>;
+    groupToggleEphemeral: (jid: string, ephemeralExpiration: number) => Promise<void>;
+    groupSettingUpdate: (jid: string, setting: "announcement" | "not_announcement" | "locked" | "unlocked") => Promise<void>;
+    groupMemberAddMode: (jid: string, mode: "admin_add" | "all_member_add") => Promise<void>;
+    groupJoinApprovalMode: (jid: string, mode: "on" | "off") => Promise<void>;
+    groupFetchAllParticipating: () => Promise<{
+        [_: string]: import("../index.js").GroupMetadata;
+    }>;
+    createCallLink: (type: "audio" | "video", event?: {
+        startTime: number;
+    }, timeoutMs?: number) => Promise<string | undefined>;
+    getBotListV2: () => Promise<import("../index.js").BotListInfo[]>;
+    processingMutex: {
+        mutex<T>(code: () => Promise<T> | T): Promise<T>;
+    };
+    upsertMessage: (msg: import("../index.js").WAMessage, type: import("../index.js").MessageUpsertType) => Promise<void>;
+    appPatch: (patchCreate: import("../index.js").WAPatchCreate) => Promise<void>;
+    sendPresenceUpdate: (type: import("../index.js").WAPresence, toJid?: string) => Promise<void>;
+    presenceSubscribe: (toJid: string, tcToken?: Buffer) => Promise<void>;
+    profilePictureUrl: (jid: string, type?: "preview" | "image", timeoutMs?: number) => Promise<string | undefined>;
+    fetchBlocklist: () => Promise<(string | undefined)[]>;
+    fetchStatus: (...jids: string[]) => Promise<import("../index.js").USyncQueryResultList[] | undefined>;
+    fetchDisappearingDuration: (...jids: string[]) => Promise<import("../index.js").USyncQueryResultList[] | undefined>;
+    updateProfilePicture: (jid: string, content: import("../index.js").WAMediaUpload, dimensions?: {
+        width: number;
+        height: number;
+    }) => Promise<void>;
+    removeProfilePicture: (jid: string) => Promise<void>;
+    updateProfileStatus: (status: string) => Promise<void>;
+    updateProfileName: (name: string) => Promise<void>;
+    updateBlockStatus: (jid: string, action: "block" | "unblock") => Promise<void>;
+    updateDisableLinkPreviewsPrivacy: (isPreviewsDisabled: boolean) => Promise<void>;
+    updateCallPrivacy: (value: import("../index.js").WAPrivacyCallValue) => Promise<void>;
+    updateMessagesPrivacy: (value: import("../index.js").WAPrivacyMessagesValue) => Promise<void>;
+    updateLastSeenPrivacy: (value: import("../index.js").WAPrivacyValue) => Promise<void>;
+    updateOnlinePrivacy: (value: import("../index.js").WAPrivacyOnlineValue) => Promise<void>;
+    updateProfilePicturePrivacy: (value: import("../index.js").WAPrivacyValue) => Promise<void>;
+    updateStatusPrivacy: (value: import("../index.js").WAPrivacyValue) => Promise<void>;
+    updateReadReceiptsPrivacy: (value: import("../index.js").WAReadReceiptsValue) => Promise<void>;
+    updateGroupsAddPrivacy: (value: import("../index.js").WAPrivacyGroupAddValue) => Promise<void>;
+    updateDefaultDisappearingMode: (duration: number) => Promise<void>;
+    getBusinessProfile: (jid: string) => Promise<import("../index.js").WABusinessProfile | void>;
+    resyncAppState: (collections: readonly ("critical_unblock_low" | "regular_high" | "regular_low" | "critical_block" | "regular")[], isInitialSync: boolean) => Promise<void>;
+    chatModify: (mod: import("../index.js").ChatModification, jid: string) => Promise<void>;
+    cleanDirtyBits: (type: "account_sync" | "groups", fromTimestamp?: number | string) => Promise<void>;
+    addOrEditContact: (jid: string, contact: import("../index.js").proto.SyncActionValue.IContactAction) => Promise<void>;
+    removeContact: (jid: string) => Promise<void>;
+    addLabel: (jid: string, labels: import("../Types/Label.js").LabelActionBody) => Promise<void>;
+    addChatLabel: (jid: string, labelId: string) => Promise<void>;
+    removeChatLabel: (jid: string, labelId: string) => Promise<void>;
+    addMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>;
+    removeMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>;
+    star: (jid: string, messages: {
+        id: string;
+        fromMe?: boolean;
+    }[], star: boolean) => Promise<void>;
+    addOrEditQuickReply: (quickReply: import("../Types/Bussines.js").QuickReplyAction) => Promise<void>;
+    removeQuickReply: (timestamp: string) => Promise<void>;
+    type: "md";
+    ws: import("./Client/index.js").WebSocketClient;
+    ev: import("../index.js").BaileysEventEmitter & {
+        process(handler: (events: Partial<import("../index.js").BaileysEventMap>) => void | Promise<void>): () => void;
+        buffer(): void;
+        createBufferedFunction<A extends any[], T>(work: (...args: A) => Promise<T>): (...args: A) => Promise<T>;
+        flush(): boolean;
+        isBuffering(): boolean;
+    };
+    authState: {
+        creds: import("../index.js").AuthenticationCreds;
+        keys: import("../index.js").SignalKeyStoreWithTransaction;
+    };
+    signalRepository: import("../index.js").SignalRepositoryWithLIDStore;
+    user: import("../index.js").Contact | undefined;
+    generateMessageTag: () => string;
+    query: (node: import("../index.js").BinaryNode, timeoutMs?: number) => Promise<any>;
+    waitForMessage: <T>(msgId: string, timeoutMs?: number | undefined) => Promise<T | undefined>;
+    waitForSocketOpen: () => Promise<void>;
+    sendRawMessage: (data: Uint8Array | Buffer) => Promise<void>;
+    sendNode: (frame: import("../index.js").BinaryNode) => Promise<void>;
+    logout: (msg?: string) => Promise<void>;
+    end: (error: Error | undefined) => void;
+    onUnexpectedError: (err: Error | import("@hapi/boom").Boom, msg: string) => void;
+    uploadPreKeys: (count?: number, retryCount?: number) => Promise<void>;
+    uploadPreKeysToServerIfRequired: () => Promise<void>;
+    digestKeyBundle: () => Promise<void>;
+    rotateSignedPreKey: () => Promise<void>;
+    requestPairingCode: (phoneNumber: string, customPairingCode?: string) => Promise<string>;
+    wamBuffer: import("../index.js").BinaryInfo;
+    waitForConnectionUpdate: (check: (u: Partial<import("../index.js").ConnectionState>) => Promise<boolean | undefined>, timeoutMs?: number) => Promise<void>;
+    sendWAMBuffer: (wamBuffer: Buffer) => Promise<any>;
+    executeUSyncQuery: (usyncQuery: import("../index.js").USyncQuery) => Promise<import("../index.js").USyncQueryResult | undefined>;
+    onWhatsApp: (...phoneNumber: string[]) => Promise<{
+        jid: string;
+        exists: boolean;
+    }[] | undefined>;
+};
+export default makeWASocket;
+//# sourceMappingURL=index.d.ts.map