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 info, managing participants, setting group properties (name, description, photo), and specifically for the "Set Ephemeral" operation, it configures disappearing messages duration in a group.
Use cases include automating group management tasks like enabling or disabling disappearing messages for all members, changing group settings programmatically, or integrating WhatsApp group controls into broader workflows.
For example, with the "Set Ephemeral" operation, you can automatically set messages in a group to disappear after 24 hours, 7 days, or 90 days, or turn off disappearing messages entirely.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group to manage, e.g., 120363312246943103@g.us. Required for most operations including "Set Ephemeral". |
| Duration | Duration for disappearing messages in the group. Options: - Off: Disable disappearing messages - 24 Hours: Messages disappear after 24 hours - 7 Days: Messages disappear after 7 days - 90 Days: Messages disappear after 90 days |
Output
The node outputs JSON data representing the response from the Wuzapi API for the requested operation. For the "Set Ephemeral" operation, the output typically confirms the updated ephemeral message duration setting for the specified group.
The output is structured as an array of JSON objects, each corresponding to an input item processed. The exact structure depends on the API response but generally includes status or confirmation details.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Wuzapi API.
- Requires an API key credential configured in n8n for authenticating requests to the Wuzapi service.
- The node uses internal helper functions to validate phone numbers and prepare media data (not relevant for "Set Ephemeral" but part of the overall node).
Troubleshooting
Common issues:
- Invalid or missing Group JID will cause the API request to fail.
- Selecting an unsupported duration value (outside the provided options) will not be accepted.
- Network or authentication errors if the API key is invalid or missing.
Error messages:
"Binary property \"<property>\" not found"— Not applicable for "Set Ephemeral" but may appear for photo operations.- API error responses will be passed through; ensure the Group JID exists and the API key has sufficient permissions.
Resolution tips:
- Verify the Group JID format matches WhatsApp group JIDs.
- Confirm the API key credential is correctly set up and valid.
- Use the "Off" option explicitly to disable disappearing messages rather than leaving the field empty.
Links and References
- WhatsApp Disappearing Messages Documentation
- Wuzapi Official API Documentation (for detailed API endpoints and parameters)