Actions14
Overview
This node integrates with the Wuzapi API to manage WhatsApp groups programmatically. It supports various group-related operations such as creating groups, retrieving information, managing participants, and configuring group settings.
The Set Announce operation specifically allows you to toggle the announce mode of a WhatsApp group. When announce mode is enabled, only group admins can send messages, which is useful for broadcast-style communication or announcements where you want to restrict message sending to admins only.
Practical examples:
- A community manager wants to make announcements in a large WhatsApp group without members replying.
- An organization uses the group for official updates and wants to prevent non-admins from posting messages temporarily.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (Jabber ID) of the WhatsApp group to operate on. Example format: 120363312246943103@g.us. This is required. |
| Announce Mode | Boolean flag indicating whether announce mode is enabled (true) or disabled (false). When enabled, only admins can send messages. |
Output
The node outputs JSON data representing the response from the Wuzapi API for the announce mode update request. The structure depends on the API's response but typically includes confirmation of the change or error details if the operation failed.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Wuzapi API service.
- Requires an API key credential configured in n8n to authenticate requests to Wuzapi.
- The node uses internal helper functions to validate phone numbers and prepare media data (not relevant for this operation).
- Network connectivity to the Wuzapi endpoint is necessary.
Troubleshooting
Common issues:
- Invalid or missing Group JID: Ensure the group identifier is correct and formatted properly.
- Insufficient permissions: The API user must have admin rights on the target WhatsApp group to change announce mode.
- API authentication errors: Verify that the API key credential is valid and has not expired.
- Network or API downtime: Check connectivity and Wuzapi service status.
Error messages:
"Binary property \"...\" not found"— Not applicable for this operation but may appear if other operations are used incorrectly.- API error responses will be passed through; check the error message for details like invalid parameters or permission denied.
To resolve errors, verify input parameters, credentials, and group membership/admin status.
Links and References
- Wuzapi Official Documentation (for detailed API usage)
- WhatsApp Groups Management Concepts: https://faq.whatsapp.com/general/chats/how-to-manage-groups
- n8n Documentation on Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/