Evolution API

Interact with Evolution API

Actions64

Overview

This node allows you to update the image (profile picture) of a WhatsApp group using the Evolution API. It is useful in scenarios where you need to programmatically change the group's image, such as for branding updates, event promotions, or dynamic group management in automated workflows.

Practical examples:

Automatically updating a group's image to reflect a new company logo.
Changing the group photo for special events or campaigns.
Rotating group images based on time or other triggers.

Properties

Display Name	Type	Description
Nome Da Instância	String	Digite o nome da instância que vai atualizar a imagem. (Enter the instance name that will update the image)
ID Do Grupo	String	ID do grupo que terá a imagem atualizada. (ID of the group whose image will be updated)
URL Da Imagem	String	URL da imagem que será definida como foto do grupo. (URL of the image to set as group photo)

All properties are required.

Output

The output is a JSON object (or array of objects) containing the result of the image update operation. The exact structure depends on the Evolution API's response, but typically includes fields indicating success or failure and possibly details about the updated group.

Example output:

[
  {
    "success": true,
    "message": "Group image updated successfully",
    "groupJid": "1234567890-123456@g.us"
  }
]

Note: The actual output fields may vary depending on the API response.

Dependencies

External Service: Requires access to the Evolution API.
API Key/Credentials: You must configure valid Evolution API credentials in n8n.
Environment: No additional environment variables are specified, but ensure your n8n instance can reach the Evolution API endpoint.

Troubleshooting

Common Issues:
- Invalid or missing credentials will prevent the node from authenticating with the Evolution API.
- Incorrect group ID or instance name may result in errors or no action taken.
- The provided image URL must be accessible and point to a valid image file.
Error Messages:
- "Operação não suportada."
  Meaning: The selected operation is not supported for the chosen resource.
  Resolution: Double-check that you have selected the correct resource ("Grupo") and operation ("Atualizar Imagem Do Grupo").
- API-specific errors (e.g., invalid group ID, unauthorized, image format issues) will be returned in the output JSON. Review the message field for details.