Green API icon

Green API

Send WhatsApp messages via Green API or trigger workflows on webhooks

Actions21

Overview

This node enables managing WhatsApp groups via the Green API service. Specifically, the "Remove Group Participant" operation allows you to remove a participant from a specified WhatsApp group by providing the group ID and the participant's chat ID. This is useful for automating group management tasks such as moderating membership or cleaning up inactive participants.

Practical scenarios include:

  • Automatically removing users who violate group rules.
  • Managing group membership dynamically based on external triggers.
  • Integrating group participant removal into larger workflows involving customer support or community management.

Properties

Name Meaning
Mode Selects between executing WhatsApp actions ("Action") or listening for incoming webhooks ("Listen for Incoming Webhook"). For this operation, use "Action".
Group ID The unique identifier of the WhatsApp group where the participant will be removed. Format example: 972501234567-1587570015@g.us.
Participant Chat ID The chat ID of the participant to remove from the group. Format example: 972501234567@c.us.

Output

The node outputs a JSON array containing the response from the Green API after attempting to remove the participant. The structure typically includes status information about the success or failure of the removal request. No binary data output is involved in this operation.

Example output JSON (simplified):

{
  "result": "success",
  "message": "Participant removed from group"
}

Dependencies

  • Requires an active Green API account with valid credentials (instance ID and API token).
  • The node uses HTTP POST requests to the Green API endpoints.
  • Proper configuration of the Green API credentials in n8n is necessary.
  • Network access to https://api.green-api.com must be available.

Troubleshooting

  • Common issues:

    • Invalid or missing Group ID or Participant Chat ID parameters.
    • Incorrectly configured API credentials leading to authentication errors.
    • Network connectivity problems preventing API calls.
    • Attempting to remove a participant who is not part of the group.

  • Error messages:

    • "Failed to remove group participant: <error message>": Indicates the API call failed; check the error message for details such as invalid IDs or permission issues.
    • "Error processing group operation removeGroupParticipant: <error message>": General error during execution; verify input parameters and credentials.

  • Resolutions:

    • Double-check that the Group ID and Participant Chat ID are correctly formatted and correspond to existing entities.
    • Ensure the API credentials are valid and have sufficient permissions.
    • Verify network connectivity and firewall settings.
    • Confirm the participant is currently a member of the group before attempting removal.

Links and References

Discussion