ZuckZapGo Group icon

ZuckZapGo Group

Manage WhatsApp groups with ZuckZapGo API
Join our community

Actions15

Overview

The node "ZuckZapGo Group" 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, and updating group settings like name, description, photo, and participant roles.

Specifically, the Update Participants operation enables adding, removing, promoting, or demoting participants within a WhatsApp group. This is useful for automating group membership management, such as onboarding new members, moderating by removing disruptive users, or adjusting admin privileges.

Practical examples:

  • Automatically add new customers to a support group.
  • Remove inactive or banned users from a community group.
  • Promote trusted members to admins based on activity.
  • Demote admins who no longer require elevated permissions.

Properties

Name Meaning
Group JID The unique identifier (Jabber ID) of the WhatsApp group to manage.
Action The participant action to perform. Options: Add, Remove, Promote, Demote.
Phone Numbers Comma-separated list of phone numbers or JIDs representing participants to update.

Output

The node outputs JSON data reflecting the response from the ZuckZapGo API for the performed operation. For the Update Participants operation, this typically includes confirmation of the action taken on the specified participants within the group.

The output is structured as an array of JSON objects, each corresponding to an input item processed. Each object contains details about the success or failure of the participant update request.

This node does not output binary data.

Dependencies

  • Requires an active connection to the ZuckZapGo API via an API key credential configured in n8n.
  • The node uses internal helper functions to validate phone numbers and prepare media data if needed (not applicable for Update Participants).
  • Network access to the ZuckZapGo API endpoints is necessary.

Troubleshooting

  • Error: Binary property not found — Not relevant for Update Participants but may occur in other operations involving images.
  • Invalid phone number format — Ensure phone numbers are correctly formatted and include country codes without extra characters.
  • Group JID missing or incorrect — Verify that the Group JID corresponds to an existing WhatsApp group managed by your account.
  • API authentication errors — Confirm that the API key credential is valid and has appropriate permissions.
  • Action failures — If adding/removing/promoting/demoting participants fails, check that the phone numbers/JIDs are valid group members or eligible for the requested action.

To resolve issues:

  • Double-check input parameters for correctness.
  • Review API limits or restrictions imposed by ZuckZapGo.
  • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion