Green API icon

Green API

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

Actions21

Overview

The node integrates with Green API to perform WhatsApp group management actions, specifically here focusing on the Set Group Picture operation. This operation allows users to update the profile picture of a WhatsApp group by uploading a JPG image.

Typical use cases include:

  • Automatically updating group pictures based on events or schedules.
  • Managing multiple WhatsApp groups' branding or identity images programmatically.
  • Integrating with other systems to reflect changes in group visuals dynamically.

For example, a marketing team could automate changing the group picture for different campaigns or seasons without manual intervention.

Properties

Name Meaning
Mode Select between "Action" (execute WhatsApp actions) or "Listen for Incoming Webhook" (trigger workflows on incoming webhooks). For this operation, "Action" mode is used.
Resource The type of entity to operate on; here it must be set to "Group".
Operation The action to perform on the resource; here it must be "Set Group Picture".
Group ID The unique identifier of the WhatsApp group where the picture will be set. Format example: 972501234567-1587570015@g.us.
Group Image Path to the JPG image file on the local filesystem that will be uploaded as the new group picture.

Output

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

No binary data output is produced by this operation.

Example output JSON snippet (conceptual):

[
  {
    "status": "success",
    "message": "Group picture updated successfully"
  }
]

Dependencies

  • Requires an active Green API account with valid credentials (instance ID and API token).
  • Needs access to the local filesystem path specified for the group image.
  • The node makes HTTP POST requests to Green API endpoints.
  • Node configuration must include the Green API credentials securely stored in n8n.

Troubleshooting

  • File Read Errors: If the node cannot read the image file at the specified path, it throws an error indicating failure to read the file. Ensure the path is correct and accessible by n8n.
  • API Request Failures: Errors from the Green API (e.g., invalid group ID, authentication issues) are surfaced with messages including the API response. Verify credentials and group ID correctness.
  • Incorrect File Format: The image must be a JPG file. Using unsupported formats may cause the API to reject the request.
  • Permission Issues: Ensure the n8n process has permission to read the image file and network access to call the Green API.

Links and References

Discussion