Wuzapi Group icon

Wuzapi Group

Manage WhatsApp groups with Wuzapi API

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 information, managing invite links, joining or leaving groups, updating group settings (like name, description, announcement mode, ephemeral message duration), handling group photos, and managing participants (adding, removing, promoting, demoting).

Common scenarios include automating group creation with predefined participants, fetching group details for reporting, controlling group access through invite links, and administrating group membership and settings programmatically.

For example, you could use this node to automatically create a new WhatsApp group for a project team, add members, set a group description, and later update the group photo or promote certain members to admin status.

Properties

Name Meaning
Group JID JID (unique identifier) of the WhatsApp group, e.g., 120363312246943103@g.us. Required for most group-specific operations like getting info, invite link, leaving, announcing, setting topic, ephemeral messages, locking, renaming, photo management, and participant updates.

Note: The above property is relevant for the "Get Info" operation and other group-specific actions.

Output

The node outputs JSON data representing the response from the Wuzapi API for the requested operation. This typically includes detailed information about the group or confirmation of the performed action.

  • For "Get Info", the output JSON contains the group's metadata such as name, participants, settings, etc.
  • For other operations, it returns success confirmations or relevant data like invite links or participant update results.
  • The node does not output binary data for the "Get Info" operation.

Dependencies

  • Requires an active connection to the Wuzapi API using an API key credential configured in n8n.
  • The node depends on helper functions for phone number validation and media preparation provided by the bundled GenericFunctions module.
  • Proper network connectivity to the Wuzapi service endpoint is necessary.

Troubleshooting

  • Missing or invalid Group JID: Many operations require a valid group JID. Ensure the JID is correctly formatted and corresponds to an existing group.
  • Invalid phone numbers: When adding participants, phone numbers must be validated and properly formatted; otherwise, the API may reject them.
  • Binary property not found: For operations involving group photos with binary data input, ensure the specified binary property exists in the incoming data.
  • API errors: Errors returned from the Wuzapi API will be surfaced. Check the error message for details and verify API credentials and request parameters.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.

Links and References

Discussion