Wuzapi Group icon

Wuzapi Group

Manage WhatsApp groups with Wuzapi API

Actions14

Overview

This node allows managing WhatsApp groups via the Wuzapi API. It supports a variety of group-related operations such as creating groups, retrieving group information, managing participants, and updating group settings including name, description, photo, and permissions.

The Set Photo operation specifically enables setting or updating the photo of a WhatsApp group by providing an image either as binary data from a previous node or as a base64-encoded string.

Practical scenarios include:

  • Automating group creation and setup workflows.
  • Updating group photos dynamically based on external triggers or events.
  • Managing group membership and permissions programmatically.
  • Retrieving invite links or group info for integration with other systems.

Properties

Name Meaning
Group JID The unique identifier (JID) of the WhatsApp group to operate on.
Photo Source Method to provide the group photo: either "Binary Data" from a previous node or "Base64" encoded image string.
Binary Property (If Photo Source is Binary) The name of the binary property containing the image data.
Base64 Image (If Photo Source is Base64) The base64 encoded JPEG image string with data URL prefix.

Output

The node outputs JSON data representing the response from the Wuzapi API for the requested operation. For the Set Photo operation, the output typically contains confirmation or status details about the photo update action.

If binary data is used as input, it is processed internally but not outputted as binary; the output remains JSON metadata about the operation result.

Dependencies

  • Requires an active connection to the Wuzapi API with appropriate API authentication credentials configured in n8n.
  • The node depends on helper functions for phone number validation and media data preparation.
  • Input binary data must be correctly formatted and available under the specified binary property if using binary photo source.

Troubleshooting

  • Error: Binary property "X" not found
    This occurs if the specified binary property does not exist in the input data. Ensure that the previous node outputs binary data under the correct property name.

  • Invalid Group JID or missing required parameters
    Verify that the Group JID is correctly provided and matches the expected format (e.g., 120363312246943103@g.us).

  • API request failures
    Check API credentials and network connectivity. Also, ensure the Wuzapi API service is operational.

  • Incorrect base64 image format
    When using base64 input, ensure the string includes the data URL prefix (e.g., data:image/jpeg;base64,) and is properly encoded.

Links and References

Discussion