Wuzapi Group icon

Wuzapi Group

Manage WhatsApp groups with Wuzapi API

Actions14

Overview

The node "Wuzapi Group" enables management of WhatsApp groups through the Wuzapi API. It supports a variety of group-related operations such as creating groups, retrieving group information, managing invite links, joining or leaving groups, updating group settings (like name, description, announcement mode, ephemeral message duration, locked status), handling group photos, and managing participants.

The Set Locked operation specifically allows users to lock or unlock group info, meaning it controls whether only admins can modify group information. This is useful for administrators who want to restrict group settings changes to admins only, preventing regular members from altering group details.

Practical examples:

  • An admin wants to prevent non-admin members from changing the group name or description by enabling the locked status.
  • Temporarily unlocking the group info to allow trusted members to update group settings, then locking it again afterward.

Properties

Name Meaning
Group JID The unique identifier (Jabber ID) of the WhatsApp group to operate on.
Locked Status Boolean flag indicating whether only admins can modify group info (true = locked).

Output

The node outputs JSON data representing the response from the Wuzapi API for the requested operation. For the Set Locked operation, the output typically contains confirmation of the locked status change or relevant metadata about the group state after the update.

No binary data output is produced by this operation.

Example output JSON structure (simplified):

{
  "success": true,
  "groupJid": "120363312246943103@g.us",
  "locked": true
}

Dependencies

  • Requires an active connection to the Wuzapi API with valid API credentials configured in n8n.
  • The node depends on the wuzapiApiRequest helper function to communicate with the Wuzapi REST endpoints.
  • No additional external dependencies beyond the API and n8n environment are needed.

Troubleshooting

  • Error: Binary property not found — Not applicable for this operation but may occur in photo-related operations if the specified binary data is missing.
  • API request failures — Could be due to invalid group JID, insufficient permissions, or expired/invalid API credentials. Verify the group JID format and ensure the API key is valid.
  • Invalid parameter errors — Ensure that the "Group JID" is correctly provided and that "Locked Status" is a boolean value.
  • If the node throws errors related to network or authentication, check the Wuzapi API service status and credential configuration in n8n.

Links and References

Discussion