ZuckZapGo Group icon

ZuckZapGo Group

Manage WhatsApp groups with ZuckZapGo API
Join our community

Actions15

Overview

This node integrates with the ZuckZapGo API to manage WhatsApp groups. It supports a variety of group-related operations such as creating groups, listing existing groups, retrieving group information, managing participants, and updating group settings like name, description, photo, and permissions.

The List operation specifically retrieves all WhatsApp groups associated with the authenticated account. It can optionally exclude participant details for improved performance, which is useful when you only need an overview of groups without detailed member data.

Practical examples:

  • Automatically fetching a list of all WhatsApp groups your business manages to display in a dashboard.
  • Periodically syncing group metadata without loading heavy participant lists to optimize performance.
  • Using the list of groups as input for further automation, such as sending announcements or updating group settings.

Properties

Name Meaning
Ignore Participants Whether to exclude participant details from the group list response for better performance. Groups will still be listed but without participant information. Possible values: true or false.

Output

The output JSON contains an array of group objects retrieved from the ZuckZapGo API. Each group object typically includes metadata about the group such as its unique identifier (JID), name, and other relevant details. If "Ignore Participants" is set to false, participant details are included; otherwise, participant information is omitted to improve performance.

No binary data output is produced by this operation.

Example output structure (simplified):

[
  {
    "GroupJID": "120363312246943103@g.us",
    "Name": "My Group",
    "Participants": [
      "5491112345678@s.whatsapp.net",
      "5491123456789@s.whatsapp.net"
    ],
    ...
  },
  ...
]

Dependencies

  • Requires an active connection to the ZuckZapGo API via an API key credential configured in n8n.
  • The node uses the zuckzapgoApiRequest helper function to communicate with the API endpoints.
  • No additional external dependencies beyond the configured API credentials.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication errors.
    • Network connectivity problems may prevent successful API calls.
    • If "Ignore Participants" is false and the group has many participants, the response might be large and slow to process.

  • Error messages:

    • "Binary property \"<property>\" not found" — Not applicable for the List operation but may appear in other operations involving images.
    • API error responses will be returned as error messages; ensure the API key is valid and has sufficient permissions.

  • Resolution tips:

    • Verify that the API key credential is correctly set up in n8n.
    • Use the "Ignore Participants" option to reduce payload size if performance issues occur.
    • Check network connectivity and firewall settings if requests fail.

Links and References

Discussion