> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Group Participant Change

> The  trigger is a custom Whatsapp provider workflow trigger that fires automatically whenever a . Use it to welcome new members, kick off onboarding, run off-boarding, or alert admins to membership changes.

***

## Key Benefits[​](#key-benefits "Direct link to Key Benefits")

**Automated Welcomes** - Greet every new member the moment they join

**Onboarding & Off-boarding** - Trigger sequences on add or remove events

**Admin Visibility** - Know who changed group membership and when

**Filtered Automation** - Trigger only on the groups or events you care about

**Zero Manual Monitoring** - No need to watch group membership by hand

***

## Who Should Use It[​](#who-should-use-it "Direct link to Who Should Use It")

**Community managers** - Welcome and onboard new group members automatically

**Sales teams** - Track when prospects join or leave a group

**Agencies** - Monitor group membership across client sub-accounts

**Membership / course operators** - Sync group access changes with your CRM

***

## Requirements[​](#requirements "Direct link to Requirements")

Before using this trigger, update your Whatsapp provider app to the latest version:

<Steps>
  <Step>
    Go to **App Marketplace → Installed Apps**
  </Step>

  <Step>
    Find **Whatsapp provider**
  </Step>

  <Step>
    Click **Update** if available
  </Step>
</Steps>

***

## How to Set Up[​](#how-to-set-up "Direct link to How to Set Up")

### Step 1: Create a New Workflow[​](#step-1-create-a-new-workflow "Direct link to Step 1: Create a New Workflow")

<Steps>
  <Step>
    Go to **Automation → Workflows**
  </Step>

  <Step>
    Click **Create Workflow** or **+ Add**
  </Step>

  <Step>
    Select **Start from Scratch**
  </Step>
</Steps>

### Step 2: Add the Trigger[​](#step-2-add-the-trigger "Direct link to Step 2: Add the Trigger")

<Steps>
  <Step>
    Click **Add New Trigger**
  </Step>

  <Step>
    Switch to the **Apps** tab (not the default triggers)
  </Step>

  <Step>
    Find and click the **Whatsapp provider** app icon
  </Step>

  <Step>
    Select **WhatsApp Group Participant Change** from the dropdown
  </Step>

  <Step>
    (Optional) Add **Filters** to narrow when the trigger fires
  </Step>

  <Step>
    Click **Save trigger**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/automation/triggers/assets/images/whatsapp-group-participant-change-trigger-4e7585d7daf6c153d6ba6daf13ce9149.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=7f3f1348a7ceb29c8bfbd3c45d1369bb" alt="WhatsApp Group Participant Change Trigger" width="2870" height="1526" data-path="images/automation/triggers/assets/images/whatsapp-group-participant-change-trigger-4e7585d7daf6c153d6ba6daf13ce9149.png" />
</Frame>

### Step 3: Add Your Actions[​](#step-3-add-your-actions "Direct link to Step 3: Add Your Actions")

Add any actions you want to execute when group membership changes:

* **Send WhatsApp Message** → Welcome a new member
* **Add / Remove from Workflow** → Start onboarding or off-boarding
* **Update Contact / Tag** → Reflect group membership in the CRM
* **Send Internal Notification** → Alert an admin of the change

### Step 4: Save and Publish[​](#step-4-save-and-publish "Direct link to Step 4: Save and Publish")

<Steps>
  <Step>
    Review your workflow
  </Step>

  <Step>
    Click **Save**
  </Step>

  <Step>
    Toggle workflow from **Draft** to **Published**
  </Step>
</Steps>

***

## Available Filters[​](#available-filters "Direct link to Available Filters")

Use filters to control exactly which membership changes start the workflow. Each filter can be paired with an operator (equals, contains, etc.).

| Filter                     | Description                                             |
| -------------------------- | ------------------------------------------------------- |
| Action by which Admin No.  | The phone number of the admin who made the change       |
| Affected Member's No.      | The phone number of the member who was added or removed |
| Event Type (add or remove) | Whether the member was **added** or **removed**         |
| Group Name                 | The name of the WhatsApp group                          |
| Group No. in CRM           | The group's identifier as stored in the CRM             |
| Location ID                | The CRM location (sub-account) the group belongs to     |

***

## Example Use Cases[​](#example-use-cases "Direct link to Example Use Cases")

### Use Case 1: Welcome New Members[​](#use-case-1-welcome-new-members "Direct link to Use Case 1: Welcome New Members")

Greet everyone who joins.

**Trigger:** WhatsApp Group Participant Change **Filter:** Event Type **equals** add

**Action:** Send a welcome WhatsApp message and start the onboarding workflow.

***

### Use Case 2: Off-Board Removed Members[​](#use-case-2-off-board-removed-members "Direct link to Use Case 2: Off-Board Removed Members")

Clean up when someone leaves.

**Trigger:** WhatsApp Group Participant Change **Filter:** Event Type **equals** remove

**Action:** Remove the contact's group tag and notify the admin.

***

## Important Notes[​](#important-notes "Direct link to Important Notes")

### Technical Details[​](#technical-details "Direct link to Technical Details")

* The trigger fires **once per participant change event**
* Use the **Event Type** filter to separate **add** and **remove** flows
* Filters are optional - leave them blank to fire on every membership change

### Best Practices[​](#best-practices "Direct link to Best Practices")

* Build **separate workflows** for add vs. remove using the Event Type filter
* Use the **Group Name** or **Group No. in CRM** filter to target a specific group
* Test by adding and removing a test member from a connected group

***

## FAQs[​](#faqs "Direct link to FAQs")

<AccordionGroup>
  <Accordion title="Can I tell whether a member was added or removed?">
    Yes. Use the **Event Type (add or remove)** filter, or branch your workflow based on it.
  </Accordion>

  <Accordion title="Do I have to add filters?">
    No. Filters are optional. Without them, the trigger fires on every add and remove event across your groups.
  </Accordion>
</AccordionGroup>

***

## Support[​](#support "Direct link to Support")

If you need help with the setup or onboarding:

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)