WaAPI icon

WaAPI

Interact with WaAPI API
Join our community

Actions85

Overview

This node operation allows you to remove a participant from a WhatsApp group chat. It is useful in scenarios where you need to manage group membership dynamically, such as moderating group participants, automating removal of inactive or unauthorized members, or managing event-based group access.

For example, if you run a community group and want to automatically remove users who violate rules or leave the group after an event ends, this operation can be integrated into your workflow to perform those removals programmatically.

Properties

Name Meaning
Id The instance ID representing the specific WhatsApp API session or connection to use.
Chat Id The unique identifier of the WhatsApp group chat from which the participant will be removed. Format typically looks like <group_id>@g.us.
Participant The unique identifier of the participant to remove from the group. Format typically looks like <user_id>@c.us.

Output

The output JSON will contain the response from the WhatsApp API indicating the result of the remove participant request. This usually includes confirmation of success or details about any error encountered.

No binary data output is expected for this operation.

Dependencies

  • Requires an active WhatsApp API service connection.
  • Needs an API key credential configured in n8n to authenticate requests to the WhatsApp API.
  • The node uses the base URL https://waapi.app/api/v1 for API calls.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials may cause authentication failures.
    • Incorrect Chat Id or Participant format can lead to errors such as "participant not found" or "invalid chat id".
    • Attempting to remove a participant who is not part of the group will likely return an error.

  • Error messages and resolutions:

    • Authentication failed: Verify that the API key credential is correctly set up and has not expired.
    • Participant not found: Check that the participant ID is correct and that the user is currently a member of the specified group.
    • Invalid chat id: Ensure the chat ID corresponds exactly to the target group and follows the required format.

Links and References

Discussion