Actions14
Overview
This node allows managing WhatsApp groups through the Wuzapi API. It supports a variety of group-related operations such as creating groups, retrieving group information, managing participants, and modifying group settings like name, description, photo, and locked status.
The Set Locked operation specifically controls whether only group admins can modify group information, effectively locking or unlocking the group's settings to regular members.
Practical scenarios include:
- Locking a group to prevent non-admins from changing group info during important announcements.
- Unlocking the group after an event to allow members to update group details.
- Automating group management workflows in customer support or community engagement setups.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group to operate on. Example: 120363312246943103@g.us |
| Locked Status | Boolean flag indicating if only admins can modify group info. Options: true (locked), false (unlocked) |
Output
The node outputs JSON data representing the response from the Wuzapi API for the requested operation. For the Set Locked operation, this typically includes confirmation of the locked status change or relevant metadata about the group.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Wuzapi API.
- The node depends on the external Wuzapi service to perform WhatsApp group management actions.
- Proper configuration of the API credential within n8n is necessary.
Troubleshooting
Common issues:
- Invalid or missing Group JID: Ensure the group identifier is correct and formatted properly.
- Insufficient permissions: The API key must have rights to modify group settings.
- Network or API errors: Check connectivity and Wuzapi service status.
Error messages:
"Binary property ... not found"— Not applicable for Set Locked but may appear in other operations involving images.- API error responses will be passed through; verify the error message for clues (e.g., invalid group ID, unauthorized access).
Resolution tips:
- Double-check input parameters for correctness.
- Confirm API credentials are valid and have required scopes.
- Use the "Continue On Fail" option to handle errors gracefully in workflows.
Links and References
- Wuzapi Official Documentation (for detailed API usage)
- WhatsApp Group Management Concepts: https://faq.whatsapp.com/general/chats/how-to-manage-groups/