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 remove participants from a group. It is useful in scenarios where you need to automate group management tasks such as moderating group membership by removing users who are no longer relevant or have violated group rules.

For example, you can use this node to automatically remove multiple phone numbers from a WhatsApp group after a certain event or trigger, helping maintain an up-to-date and relevant group membership without manual intervention.

Properties

Name Meaning
Group ID The unique identifier of the WhatsApp group from which participants will be removed.
Participants Comma-separated list of phone numbers (with country code) representing participants to remove (e.g., 5511999999999,5511888888888).
Additional Fields Optional extra parameters:
- Reply to Message ID: ID of a message to reply to.
- Delay (seconds): Delay before sending the removal request.
- Disable Link Preview: Whether to disable link previews in messages.
- Mention Users: Comma-separated phone numbers to mention in the message.

Output

The node outputs JSON data containing the response from the Uazapi WhatsApp API for the remove participant operation. This typically includes confirmation of the removal action or error details if the operation failed.

The output structure is:

{
  "json": {
    // Response data from Uazapi API about the remove participant request
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an active Uazapi WhatsApp API account.
  • Needs an API key credential and authentication token configured in n8n credentials for Uazapi.
  • Requires the instance ID of the WhatsApp instance managed via Uazapi.
  • The node sends requests through a proxy endpoint at https://n8ntools.io/api/v1/proxy/uazapi using an additional API key for that proxy service.

Troubleshooting

  • Invalid Group ID: If the group ID is incorrect or does not exist, the API will return an error. Verify the group ID is correct.
  • Participants Format: Ensure phone numbers are correctly formatted with country codes and separated by commas without spaces.
  • API Authentication Errors: If the API key or token is invalid or expired, authentication errors will occur. Check and update credentials.
  • Rate Limits: Removing many participants rapidly may hit rate limits; consider adding delays using the "Delay (seconds)" field.
  • Permission Issues: The WhatsApp instance must have admin rights to remove participants; otherwise, the operation will fail.
  • Network Issues: Connectivity problems to the proxy or Uazapi endpoints can cause request failures.

Links and References

Discussion