Actions15
Overview
This node allows managing WhatsApp groups through the ZuckZapGo API. It supports a variety of group-related operations such as creating groups, retrieving group information, managing invite links, joining or leaving groups, updating group settings (name, description, photo, announcement mode, ephemeral messages, locked status), and managing participants (adding, removing, promoting, demoting).
Common scenarios include automating group creation with predefined participants, updating group details dynamically, managing membership, or integrating WhatsApp group management into broader workflows.
For example, you could use this node to:
- Create a new WhatsApp group for an event and add initial participants.
- Change the name of an existing group based on external triggers.
- Retrieve the invite link of a group to share it automatically.
- Promote certain users to admin after they join.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group, e.g., 120363312246943103@g.us. |
| New Name | The new name to assign to the group when changing its name. |
Note: These properties are specific to the "Set Name" operation under the "Default" resource.
Output
The node outputs JSON data representing the response from the ZuckZapGo API for the performed operation. For the "Set Name" operation, the output typically includes confirmation details about the group name change.
The output is structured as an array of JSON objects, each corresponding to an input item processed. If an error occurs and "Continue On Fail" is enabled, the output will contain an error message object instead.
This node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the ZuckZapGo API.
- The node uses the ZuckZapGo API endpoints to perform all group management actions.
- No additional environment variables are required beyond the API credential configuration in n8n.
Troubleshooting
- Error: Binary property not found — This error can occur if the operation expects binary image data (e.g., setting a group photo) but the specified binary property is missing. For the "Set Name" operation, this is not applicable.
- Invalid Group JID — Ensure the Group JID is correctly formatted and corresponds to an existing WhatsApp group.
- API Request Failures — Network issues or invalid API credentials can cause request failures. Verify your API key and network connectivity.
- Continue On Fail — Enable this option to allow the workflow to continue processing other items even if one fails, capturing error messages in the output.
Links and References
- ZuckZapGo API Documentation (for detailed API endpoint info)
- WhatsApp Group Management Concepts