Actions14
Overview
This node integrates with the Wuzapi API to manage WhatsApp groups. It allows users to perform various group-related operations such as creating groups, retrieving group information, managing participants, updating group settings (name, description, photo, announcement mode, ephemeral messages), and handling invite links.
Common scenarios where this node is beneficial include automating WhatsApp group management tasks in workflows, such as:
- Creating a new group and adding initial participants automatically.
- Fetching detailed information about a specific group for reporting or monitoring.
- Updating group settings like name, topic, or photo based on external triggers.
- Managing group membership by adding, removing, promoting, or demoting participants.
- Handling invite links to join groups or retrieve invite details.
For example, a marketing automation workflow could create a WhatsApp group for a campaign, add contacts from a CRM, and set a welcome message automatically.
Properties
| Name | Meaning |
|---|---|
| Group JID | The unique identifier (JID) of the WhatsApp group, e.g., 120363312246943103@g.us. Required for most group-specific operations like getting info, invite link, leaving, updating participants, etc. |
(Note: Only properties relevant to the "Default" resource and "Get Info" operation are listed here, per user request.)
Output
The node outputs JSON data representing the response from the Wuzapi API for the requested operation. For the "Get Info" operation, the output JSON contains detailed information about the specified WhatsApp group, such as its metadata, participants, settings, and status.
No binary data output is produced by the "Get Info" operation.
Dependencies
- Requires an active connection to the Wuzapi API via an API key credential configured in n8n.
- The node uses internal helper functions to validate phone numbers and prepare media data.
- Network access to the Wuzapi API endpoints is necessary.
Troubleshooting
- Missing or invalid Group JID: The "Group JID" property must be provided and correctly formatted; otherwise, the API call will fail.
- API request failures: Errors returned from the Wuzapi API may indicate issues such as invalid credentials, network problems, or incorrect parameters.
- Binary property not found (for other operations involving photos): If using binary data for images, ensure the specified binary property exists in the input data.
- To handle errors gracefully, enable the "Continue On Fail" option in the node settings to prevent workflow interruption.
Links and References
- Wuzapi Official Documentation (for API reference and usage)
- WhatsApp Group Management Concepts: https://faq.whatsapp.com/general/chats/how-to-create-a-group/