WAHA API

Complete WhatsApp automation with WAHA API - Multi-engine support

Actions55

Overview

This node integrates with the WAHA API to manage WhatsApp groups and perform various group-related operations. Specifically, the "Remove Participants" operation allows users to remove one or more participants from a WhatsApp group by specifying their chat IDs.

Common scenarios where this node is beneficial include:

Moderating WhatsApp groups by removing inactive or unwanted members.
Automating group management tasks in customer support or community engagement workflows.
Integrating WhatsApp group participant management into larger automation pipelines.

For example, a user can automate the removal of multiple participants from a group after a certain event or condition is met, such as when users unsubscribe from a service.

Properties

Name	Meaning
Session Name	The name of the WhatsApp session to use for the operation. Defaults to a configured session.
Chat ID	The WhatsApp group chat ID from which participants will be removed (e.g., `groupid@g.us`).
Participants	Comma-separated list of participant chat IDs to remove from the group.
Additional Fields	Optional extra parameters (not used directly in this operation but available for other ops).

Output

The node outputs a JSON object representing the response from the WAHA API after attempting to remove the specified participants from the group. This typically includes status information about the success or failure of the removal operation.

The output structure is:

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

No binary data is produced by this operation.

Dependencies

Requires an active WAHA API credential with a valid base URL and API key.
Optionally uses an additional API key credential for subscription validation via the n8n Tools API.
The node requires proper configuration of these credentials within n8n to authenticate requests.
The WhatsApp session referenced by "Session Name" must be active and connected.

Troubleshooting

Invalid Credentials: If the API keys are incorrect or the subscription is invalid, the node will throw errors indicating authentication failure. Verify that all API keys and sessions are correctly set up.
Unknown Group or Participants: Errors may occur if the provided group chat ID or participant IDs are invalid or do not exist. Double-check the IDs format (groupid@g.us for groups, phone numbers with @c.us for participants).
Permission Issues: Removing participants requires appropriate permissions in the WhatsApp group. Ensure the session user has admin rights.
Network or API Errors: Transient network issues or API downtime can cause failures. Retrying or checking WAHA API status may help.
Malformed Participant List: The participants must be provided as a comma-separated string without extra spaces or invalid characters.

Links and References

WAHA API Documentation (replace with actual URL)
WhatsApp Group Management Best Practices
n8n Credential Setup Guide

This summary focuses on the "Group" resource and the "Remove Participants" operation as requested.

WAHA APIInstall