Wuzapi Group icon

Wuzapi Group

Manage WhatsApp groups with Wuzapi API

Actions14

Overview

This node allows managing WhatsApp groups through the Wuzapi API. It supports various group-related operations such as creating groups, joining via invite codes, retrieving group information, updating participants, setting group properties (name, description, photo, announcement mode, etc.), and leaving groups.

The Join operation specifically enables a user to join a WhatsApp group using an invite code or invite link. This is useful in automation workflows where you want to programmatically add the bot or user to a group without manual intervention, for example, when onboarding new users or integrating group-based notifications.

Practical Example

  • Automatically join a WhatsApp group when receiving an invite code from another system.
  • Use the invite code received from a webhook or form submission to join a group as part of a workflow.

Properties

Name Meaning
Invite Code Group invite code or full invite link used to join the WhatsApp group.

Note: The invite code can be either just the code itself or a full invite URL containing the code.

Output

The output JSON contains the response from the Wuzapi API after attempting to join the group. Typically, this will include confirmation details about the join action or error messages if the join failed.

The node does not output binary data for this operation.

Example output structure (simplified):

{
  "success": true,
  "groupJid": "120363312246943103@g.us",
  "message": "Joined group successfully"
}

Or in case of failure:

{
  "error": "Invalid invite code"
}

Dependencies

  • Requires an active connection to the Wuzapi API with valid API credentials configured in n8n.
  • The node depends on the wuzapiApiRequest helper function to communicate with the Wuzapi REST endpoints.
  • No additional external dependencies beyond the Wuzapi API and its authentication.

Troubleshooting

  • Common Issues:

    • Invalid or expired invite code: Ensure the invite code is correct and still valid.
    • Network or authentication errors: Verify that the API credentials are correctly set up and have necessary permissions.
    • Missing invite code parameter: The invite code property is required; ensure it is provided.

  • Error Messages:

    • "Binary property \"...\" not found" — Not applicable for Join operation but may appear in other operations involving images.
    • "Invalid invite code" — The invite code provided is incorrect or malformed.
    • API request failures due to connectivity or authorization issues.

  • Resolution Tips:

    • Double-check the invite code format; if a full URL is provided, the node extracts the code automatically.
    • Confirm API key validity and network access.
    • Enable "Continue On Fail" option in the node settings to handle errors gracefully in workflows.

Links and References

Discussion