Actions14
Overview
This node allows managing WhatsApp groups using the ZuckZapGo API. It supports a variety of group-related operations such as creating groups, retrieving group information, managing participants, setting group descriptions, changing group photos, and more. This node is useful for automating WhatsApp group administration tasks within workflows, such as onboarding new members, updating group settings, or extracting group data for reporting.
For example, you can use this node to:
- Create a new WhatsApp group with specified participants.
- Update the description/topic of an existing group.
- Retrieve the invite link to share with others.
- Promote or demote participants to/from admin status.
- Change or remove the group photo.
Properties
Name | Meaning |
---|---|
Group JID | The unique identifier (JID) of the WhatsApp group, e.g., [email protected] . |
Description | The group description or topic text to set for the group. |
Note: For the "Set Description" operation specifically, only these two properties are relevant.
Output
The node outputs JSON data representing the response from the ZuckZapGo API for the requested operation. The structure varies depending on the operation performed but generally includes details about the group or confirmation of the action taken.
If the operation involves uploading a photo, the node handles image data either from binary input, base64 string, or URL, but the output remains JSON describing the result.
No binary output is produced by this node.
Dependencies
- Requires an active connection to the ZuckZapGo API via an API key credential configured in n8n.
- The node depends on helper functions for phone number validation and media preparation.
- Network access to the ZuckZapGo API endpoints is necessary.
Troubleshooting
- Missing Binary Property Error: When setting a group photo from binary data, if the specified binary property does not exist in the input, the node will throw an error. Ensure the binary property name matches exactly and that the previous node provides the expected binary data.
- Invalid Phone Number Format: Phone numbers must be correctly formatted; otherwise, the API may reject them. Use international format without spaces or special characters.
- API Request Failures: Errors returned from the ZuckZapGo API (e.g., invalid group JID, insufficient permissions) will be surfaced. Verify credentials and input parameters.
- Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.
Links and References
- ZuckZapGo API Documentation (hypothetical link)
- WhatsApp Group Management Concepts: https://faq.whatsapp.com/general/chats/how-to-create-a-group/?lang=en