Actions23
- ✉️ Message Actions
- 👥 Group Actions
Overview
This node interacts with the Wazzap API to manage WhatsApp groups. Specifically, the "Remove Participants" operation under the "Group" resource allows users to remove one or more participants from a specified WhatsApp group by providing the group's unique ID and the phone numbers of the participants to be removed.
Common scenarios for this node include:
- Moderating group membership by removing inactive or unwanted members.
- Automating group management tasks in customer support or community engagement workflows.
- Maintaining compliance by removing users who no longer meet group criteria.
For example, a user can input a group ID and a list of phone numbers to remove those participants from the group automatically, optionally controlling which sending number is used and adding delays between removal requests.
Properties
| Name | Meaning |
|---|---|
| 👥 Group ID (JID) | The unique identifier of the WhatsApp group where participants will be removed. Format example: 1234567890-123456@g.us. |
| 📞 Phone Numbers | One or more phone numbers to remove from the group. Each number must include the full country code (e.g., +521234567890). Multiple numbers can be provided. |
| ⚙️ Additional Options | Optional settings to customize the removal process: |
| - 🔢 Priority Number | Selects the sending number slot to use for the action: 0 = Default, 999 = Random, or 1–5 for specific number slots. |
| - ⏱️ Delay Settings | Configure a random delay range (in milliseconds) between removal requests to avoid rate limits or mimic human behavior. Specify minimum (Start) and maximum (End) delay values, e.g., 1200 ms to 5000 ms. |
Output
The node outputs a JSON array containing the result of the removal operation. Each item in the output corresponds to the response from the Wazzap API after attempting to remove the specified participants from the group.
If the API supports it, the output may include status information such as success confirmation, error messages per phone number, or other metadata related to the removal process.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the Wazzap API service.
- An API key credential (or equivalent authentication token) must be configured in n8n to authorize requests.
- Network access to
https://doc.wazzap.mx/api-referenceor the actual Wazzap API endpoint is necessary.
Troubleshooting
- Unsupported operation error: If the node throws an error stating the operation is unsupported, verify that the Resource is set to "Group" and Operation to "Remove Participants".
- Invalid Group ID: Ensure the group ID (JID) is correctly formatted and corresponds to an existing WhatsApp group.
- Phone number format issues: Phone numbers must include the country code and be in international format (e.g., +521234567890). Incorrect formatting may cause failures.
- API authentication errors: Confirm that the API key or authentication credentials are valid and have sufficient permissions.
- Rate limiting or delays: If removals fail due to rate limits, consider increasing the delay settings to space out requests.
- Partial failures: Some phone numbers might fail removal while others succeed; check the output JSON for detailed error messages per number.
Links and References
- Wazzap API Documentation (official API reference)
- WhatsApp Group Management Concepts (general background on WhatsApp groups)