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 manage WhatsApp groups and perform various WhatsApp-related actions. Specifically, the "Update Group Name" operation allows users to change the name of an existing WhatsApp group by providing the group's unique ID and the new desired name.

Common scenarios for this node include:

  • Automating group management tasks such as renaming groups based on events or workflows.
  • Keeping group names up-to-date dynamically from external data sources.
  • Integrating WhatsApp group management into broader business processes or CRM systems.

For example, a user might use this node in a workflow that monitors project status and updates the corresponding WhatsApp group name to reflect the current phase or milestone.

Properties

Name Meaning
Mode Selects the node mode:
- Action: Execute WhatsApp actions via Green API.
- Listen for Incoming Webhook: Trigger workflows on incoming Green API webhooks.
Resource The type of entity to operate on; here it is fixed to Group for this operation.
Operation The action to perform on the resource; here it is Update Group Name.
Group ID The unique identifier of the WhatsApp group to update. Format example: 972501234567-1587570015@g.us. This identifies which group will be renamed.
Group Name The new name to assign to the group. For example, "My New Group".

Output

The node outputs a JSON array containing the response from the Green API after attempting to update the group name. The structure typically includes confirmation details or error information returned by the API.

Example output JSON (simplified):

{
  "id": "972501234567-1587570015@g.us",
  "groupName": "My New Group",
  "status": "success"
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active Green API account with valid credentials: an instance ID and an API token.
  • The node makes HTTP POST requests to the Green API endpoints.
  • Requires proper configuration of these credentials within n8n.
  • Node depends on network connectivity to the Green API service.

Troubleshooting

  • Common issues:

    • Invalid or missing Group ID: Ensure the Group ID is correct and corresponds to an existing WhatsApp group.
    • Incorrect API credentials: Verify that the instance ID and API token are correctly set and active.
    • Network errors or API downtime: Check internet connection and Green API service status.

  • Error messages:

    • "Failed to update group name: <error message>": Indicates the API call failed. Review the error message for details, check the data sent, and verify credentials.
    • "Error processing group operation updateGroupName: <error message>": General error during execution; may indicate parameter issues or internal exceptions.

  • Resolution tips:

    • Double-check all required parameters are provided and correctly formatted.
    • Confirm API credentials are valid and have necessary permissions.
    • Inspect the detailed error message included in the node's error output for clues.
    • Retry after verifying network and API availability.

Links and References

Discussion