Actions14
Overview
This node allows managing WhatsApp groups via the Wuzapi API. It supports a variety of group-related operations such as creating groups, retrieving group information, managing participants, setting group descriptions, and modifying group settings like announcements, ephemeral messages, and photos.
A common use case is automating WhatsApp group administration tasks within workflows, for example:
- Automatically creating a new group and adding participants.
- Updating the group description or topic based on external triggers.
- Managing group membership by adding or removing participants programmatically.
- Retrieving invite links to share with users.
- Setting group properties like locking the group info or enabling announce mode.
Specifically, the "Set Description" operation updates the group's description or topic, which can be useful for dynamically changing group context or rules.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group to operate on. Example: 120363312246943103@g.us. Required for most group operations including setting description. |
| Description | The new description or topic text to set for the group. For example, "Welcome to our group!". Required when setting the group description/topic. |
Output
The node outputs JSON data representing the response from the Wuzapi API for the performed operation. For the "Set Description" operation, this typically includes confirmation details about the updated group topic.
The output structure is an array of JSON objects, each corresponding to an input item processed. Each object contains the API response fields relevant to the operation.
No binary data output is produced by the "Set Description" operation.
Dependencies
- Requires an active connection to the Wuzapi API with valid API credentials configured in n8n.
- The node uses an API key credential to authenticate requests to the Wuzapi service.
- Network access to the Wuzapi endpoints is necessary.
Troubleshooting
- Missing or invalid Group JID: Ensure the Group JID is correctly specified and corresponds to an existing WhatsApp group.
- API authentication errors: Verify that the API key credential is properly configured and has sufficient permissions.
- Empty or invalid Description: The description must be a non-empty string; otherwise, the API may reject the request.
- Network issues: Connectivity problems to the Wuzapi API will cause failures; check network and firewall settings.
- Error message "Binary property ... not found": This does not apply to the "Set Description" operation but may appear in other operations involving images.
If the node is set to continue on failure, errors will be returned in the output JSON under an error field for each failed item.
Links and References
- Wuzapi Official Documentation (for detailed API capabilities)
- WhatsApp Group Management Concepts