Wuzapi Group icon

Wuzapi Group

Manage WhatsApp groups with Wuzapi API

Actions14

Overview

The node "Wuzapi Group" allows managing WhatsApp groups through the Wuzapi API. It supports a variety of group-related operations such as creating groups, retrieving information, managing participants, setting group properties (name, description, photo, announcement mode, locked status), handling invite links, and configuring disappearing messages (ephemeral messages).

This node is beneficial in scenarios where automated or programmatic control over WhatsApp groups is needed, for example:

  • Automatically creating groups and adding participants based on external data.
  • Managing group settings like announcements or ephemeral message durations without manual intervention.
  • Retrieving group info or invite links to share externally.
  • Updating participants by adding, removing, promoting, or demoting them.

Practical example: A community manager could use this node to create a new WhatsApp group for an event, add all registered attendees automatically, set the group to announcement-only mode during the event, and enable disappearing messages after 7 days to keep chat history clean.

Properties

Name Meaning
Group JID The unique identifier (JID) of the WhatsApp group to operate on.
Duration Duration for disappearing messages in the group. Options: Off, 24 Hours, 7 Days, 90 Days.

Note: These properties are specific to the "Set Ephemeral" operation within the "Default" resource.

Output

The node outputs JSON data representing the response from the Wuzapi API for the requested operation. The structure varies depending on the operation but generally includes details about the group or confirmation of the performed action.

For the "Set Ephemeral" operation, the output confirms the updated ephemeral message duration setting for the specified group.

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the Wuzapi API with valid API authentication credentials configured in n8n.
  • The node depends on the wuzapiApiRequest helper function to communicate with the Wuzapi API endpoints.
  • No additional environment variables are explicitly required beyond the API credential setup.

Troubleshooting

  • Error: Binary property not found — Not applicable for "Set Ephemeral" but may occur in other operations involving images if the specified binary data is missing.
  • Invalid Group JID — Ensure the provided Group JID is correct and corresponds to an existing WhatsApp group.
  • API Request Failures — Network issues or invalid API credentials can cause request failures. Verify API key validity and network connectivity.
  • Invalid Duration Value — Only the predefined options ("off", "24h", "7d", "90d") are accepted for the duration property.

If the node is set to continue on fail, errors will be returned in the output JSON under an error field instead of stopping execution.

Links and References

Discussion