Actions14
Overview
The node "Wuzapi Group" allows managing WhatsApp groups through the Wuzapi API. It supports various group-related operations such as creating groups, retrieving group information, managing invite links, joining or leaving groups, setting group properties (name, description, photo, announcement mode, ephemeral messages, locked status), and updating participants by adding, removing, promoting, or demoting them.
The Update Participants operation specifically enables modifying the membership of a WhatsApp group by adding new participants, removing existing ones, promoting participants to admins, or demoting admins back to regular participants.
This node is beneficial for automating WhatsApp group management tasks in workflows, such as onboarding new members, moderating group admins, or cleaning up inactive participants without manual intervention.
Practical Examples
- Automatically add new customers to a WhatsApp support group after they sign up.
- Remove users who unsubscribe from a service from a WhatsApp broadcast group.
- Promote trusted users to admin status based on their activity or role.
- Demote admins who no longer should have elevated privileges.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group to manage, e.g., 120363312246943103@g.us. Required. |
| Action | The participant action to perform: Add, Remove, Promote, or Demote participants in the group. |
| Phone Numbers | Comma-separated list of phone numbers or JIDs representing the participants to update. Required. |
Output
The node outputs JSON data reflecting the response from the Wuzapi API for the performed operation. For the Update Participants operation, the output typically contains confirmation details about the success or failure of the participant updates in the group.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Wuzapi API with a valid API key credential configured in n8n.
- The node uses internal helper functions to validate phone numbers and prepare media data.
- Network access to the Wuzapi API endpoints is necessary.
Troubleshooting
- Error: Binary property not found — This error does not apply to the Update Participants operation but may appear in other operations involving photos if the specified binary data is missing.
- Invalid phone number format — Ensure that phone numbers are correctly formatted and include country codes when required. The node validates and formats phone numbers internally.
- API request failures — Check that the API key credential is valid and has sufficient permissions. Also verify network connectivity to the Wuzapi API.
- Group JID errors — Confirm that the provided Group JID corresponds to an existing WhatsApp group accessible by the authenticated account.
If the node is set to continue on fail, errors will be returned in the output JSON under an error field instead of stopping execution.
Links and References
- Wuzapi Official Documentation (for API reference and usage)
- WhatsApp Group Management Concepts (general understanding of groups and participants)