Wuzapi Group

Overview

This node allows managing WhatsApp groups via the Wuzapi API. It supports various group-related operations such as creating groups, retrieving group information, managing invite links, joining or leaving groups, updating group settings (name, description, photo, announcement mode, ephemeral messages, locked status), and managing participants (adding, removing, promoting, demoting).

A practical use case is automating WhatsApp group administration tasks within workflows, for example:

• Automatically creating a new group with specified participants.
• Removing a group's photo to reset its appearance.
• Leaving a group programmatically.
• Updating participant roles based on external triggers.

Specifically, the Remove Photo operation removes the current photo of a specified WhatsApp group.

Properties

Output

The node outputs JSON data representing the response from the Wuzapi API after attempting to remove the group photo. This typically includes confirmation of success or error details.

No binary data output is produced by this operation.

Example output JSON structure might look like:

{
  "success": true,
  "message": "Group photo removed"
}

or in case of failure:

{
  "error": "Group not found or insufficient permissions"
}

Dependencies

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

Troubleshooting

• Common issues:

  • Invalid or missing Group JID: Ensure the Group JID is correctly provided and corresponds to an existing WhatsApp group.
  • Insufficient permissions: The API key used must have rights to modify the group.
  • Network or API errors: Check connectivity and API service status.

• Error messages:

  • "Binary property \"...\" not found" — Not applicable for Remove Photo but common in other operations involving images.
  • API error responses will be passed through; check the message for clues (e.g., invalid group ID, unauthorized access).

• Resolution tips:

  • Verify the Group JID format matches WhatsApp group JIDs (usually ending with @g.us).
  • Confirm API credentials are valid and have necessary permissions.
  • Use the "List" operation to retrieve valid group JIDs if unsure.

Links and References

• Wuzapi Official Documentation (for detailed API usage)
• WhatsApp Group JID format info: Typically numeric string followed by @g.us
• n8n documentation on creating custom nodes