N8N Tools - Uazapi icon

N8N Tools - Uazapi

Complete Uazapi integration - Premium WhatsApp API with advanced messaging and automation

Actions37

Overview

The "Update Group" operation in the "Group" resource allows users to modify settings of an existing WhatsApp group via the Uazapi WhatsApp API integration. This node is useful for automating administrative tasks related to WhatsApp groups, such as changing group descriptions, settings, or other configurable fields supported by the API.

Practical scenarios include:

  • Updating a group's description or subject automatically based on external triggers.
  • Changing group settings like message permissions or announcements without manual intervention.
  • Integrating group updates into broader workflows that manage WhatsApp communications dynamically.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group to update.
Additional Fields Optional extra parameters to customize the update. These include:
- Reply to Message ID: ID of a message to reply to within the group context.
- Delay (seconds): Time delay before sending the update request.
- Disable Link Preview: Whether to disable link previews in messages sent to the group.
- Mention Users: Comma-separated phone numbers to mention in the update message.

Output

The node outputs a JSON object containing the response from the Uazapi API after attempting to update the group. This typically includes confirmation of the update or details about any errors encountered.

Example output structure (simplified):

{
  "json": {
    "status": "success",
    "data": {
      "groupId": "12345@g.us",
      "updatedFields": { ... }
    }
  }
}

If the update fails and "Continue On Fail" is enabled, the output will contain an error message instead:

{
  "json": {
    "error": "Error message describing what went wrong"
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an active Uazapi WhatsApp API account with valid credentials including:

    • An API key credential.
    • API token.
    • Instance ID.
    • Base URL for the API endpoint.

  • The node uses these credentials to authenticate and send requests to the Uazapi service.

  • Proper configuration of these credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common Issues:

    • Invalid or missing Group ID: Ensure the Group ID is correct and corresponds to an existing WhatsApp group.
    • Insufficient permissions: The API user must have rights to update the specified group.
    • Network or authentication errors: Verify API keys, tokens, and instance IDs are correctly configured.
    • Incorrect additional fields: Passing unsupported or malformed additional fields may cause errors.

  • Error Messages:

    • "Unknown resource: group": Indicates the resource parameter was not set correctly; ensure "Group" is selected.
    • API authorization errors: Check that the API token and key are valid and have not expired.
    • Validation errors from the API: Review the additional fields and required parameters for correctness.

  • Enabling "Continue On Fail" can help capture errors per item without stopping the entire workflow.

Links and References

Discussion