N8N Tools - Uazapi icon

N8N Tools - Uazapi

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

Actions37

Overview

This node integrates with the Uazapi WhatsApp API to manage WhatsApp groups, specifically allowing you to demote group admins back to regular participants. It is useful in scenarios where you need to adjust group admin privileges programmatically, such as automating group management tasks or enforcing group policies.

For example, if a user was mistakenly promoted to admin or an admin no longer needs those privileges, this node can demote them efficiently by specifying the group and the phone numbers of the admins to be demoted.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group where the admin(s) will be demoted.
Participants Comma-separated list of phone numbers (with country code) representing the admins to demote.
Additional Fields Optional extra parameters:
- Reply to Message ID: ID of message to reply to
- Delay (seconds): Wait time before action
- Disable Link Preview: Whether to disable link previews
- Mention Users: Comma-separated phone numbers to mention

Output

The node outputs a JSON object containing the response from the Uazapi API for the demotion request. This typically includes confirmation of the operation's success or details about any errors encountered.

The output structure is:

{
  "json": {
    // API response data confirming demotion or error details
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an active Uazapi WhatsApp API account.
  • Needs credentials including an API key, API token, instance ID, and API URL configured in n8n.
  • The node sends authenticated HTTP requests to the Uazapi service endpoint via a proxy at https://n8ntools.io/api/v1/proxy/uazapi.

Troubleshooting

  • Invalid Group ID: If the group ID is incorrect or the bot is not part of the group, the API may return an error. Verify the group ID and ensure the bot has appropriate permissions.
  • Participants Format: Phone numbers must be comma-separated without spaces and include country codes. Incorrect formatting may cause failures.
  • Authorization Errors: Ensure that the API token and API key credentials are valid and have not expired.
  • API Rate Limits: Excessive requests might be throttled by the Uazapi service; consider adding delays using the "Delay (seconds)" additional field.
  • Error Messages: The node returns error messages from the API in the output JSON under the error key when continueOnFail is enabled. Review these messages to identify issues.

Links and References

Discussion