Green API icon

Green API

Send WhatsApp messages via Green API or trigger workflows on webhooks
Join our community

Actions21

Overview

This node integrates with the Green API service to perform various WhatsApp group management actions. Specifically, for the "Group" resource and the "Set Group Admin" operation, it allows you to assign admin rights to a participant within a specified WhatsApp group.

Common scenarios where this node is beneficial include automating group administration tasks such as promoting members to admins without manual intervention, managing large groups programmatically, or integrating group role changes into broader workflows (e.g., onboarding new team members).

Practical example: Automatically set a newly added participant as a group admin after they join a WhatsApp group, enabling them to manage group settings and participants.

Properties

Name Meaning
Mode Choose between "Action" (execute WhatsApp actions) or "Listen for Incoming Webhook"
Webhook Filters (Only for trigger mode) Filters to specify which incoming webhooks should trigger workflow execution, including chat ID, chat type, message content, sender, message types, webhook types, instance ID, and filter logic (AND/OR).
Resource Select the resource to operate on; here it must be "Group"
Operation The action to perform on the resource; here "Set Group Admin"
Group ID The unique identifier of the WhatsApp group where the admin rights will be assigned
Participant Chat ID The chat ID of the participant to be promoted to group admin

Output

The node outputs JSON data representing the response from the Green API after attempting to set the group admin. This typically includes confirmation of success or details about the updated group participant's status.

The output JSON structure corresponds directly to the API response and may contain fields such as status codes, messages, or updated group information.

No binary data output is involved in this operation.

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.
  • Requires proper configuration of the Green API credentials in n8n.
  • Node depends on the helpers.request method for making HTTP calls.
  • For file-related operations (not relevant here), the node reads files from the local filesystem if needed.

Troubleshooting

  • Common issues:

    • Invalid or missing Group ID or Participant Chat ID parameters will cause the API call to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity issues can prevent successful API communication.

  • Error messages:

    • Errors like Failed to set group admin: <error message> indicate problems returned by the Green API or network issues.
    • If the error includes Data sent: ..., verify that the Group ID and Participant Chat ID are correctly formatted and valid.

  • Resolution tips:

    • Double-check the Group ID format (usually ending with @g.us) and Participant Chat ID format (usually ending with @c.us).
    • Ensure the API credentials are current and have sufficient permissions.
    • Test connectivity to the Green API endpoint outside n8n to isolate network issues.
    • Review Green API documentation for any rate limits or restrictions.

Links and References

Discussion