Actions15
Overview
This node allows managing WhatsApp groups via the ZuckZapGo 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 or ephemeral messages.
The "Set Description" operation specifically updates the description or topic of an existing WhatsApp group. This is useful for administrators who want to provide context or rules for the group, welcome messages, or any other relevant information visible to all members.
Practical example:
An admin wants to update the group description to "Welcome to our group!" to greet new members automatically when they join.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group to modify. Example: 120363312246943103@g.us. Required for most group operations including setting the description. |
| Description | The new description or topic text to set for the group. For example, "Welcome to our group!". Required for the "Set Description" operation. |
Output
The node outputs JSON data representing the response from the ZuckZapGo API for the performed operation. For the "Set Description" operation, this typically includes confirmation details about the updated group description.
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 ZuckZapGo API with valid API authentication credentials configured in n8n.
- The node depends on helper functions for phone number validation and media preparation imported from a shared module.
- Network access to the ZuckZapGo API endpoints is necessary.
Troubleshooting
- Missing or invalid Group JID: The operation requires a valid group JID. Ensure the JID is correctly formatted and corresponds to an existing group.
- Empty or invalid Description: The description field must be provided and non-empty for the "Set Description" operation.
- API errors: Errors returned from the ZuckZapGo API will be surfaced. Common issues include authentication failures, permission errors (e.g., not being an admin), or invalid parameters.
- Binary property not found: Although not applicable to "Set Description," other operations involving images require correct binary data references; ensure the binary property name matches the input data.
To resolve errors, verify input parameters, check API credentials, and confirm group membership and permissions.
Links and References
- ZuckZapGo API Documentation (hypothetical link for reference)
- WhatsApp Group Management Concepts: https://faq.whatsapp.com/general/chats/about-groups/