Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

This node integrates with the Evolution API to manage WhatsApp profile settings, specifically allowing you to update the profile picture of a WhatsApp account associated with an instance. It is useful in scenarios where you want to automate the updating of your WhatsApp profile picture based on external triggers or workflows, such as changing the profile image periodically, syncing it with another service, or updating it after certain events.

For example, you could use this node to automatically update your WhatsApp profile picture when a new product image is published on your website or when a user uploads a new avatar in your system.

Properties

Name Meaning
Additional Fields Optional extra parameters to customize the request:
- Delay: Delay in milliseconds before sending the request
- Link Preview: Enable or disable link preview in messages
- Quoted Message ID: ID of a message to quote or reply to
- Mentions: Comma-separated list of phone numbers to mention

Note: For the "Update Profile Picture" operation, the main required input is the media URL of the new profile picture (not explicitly listed in the provided properties but implied by the operation context). The additional fields allow fine-tuning the request behavior.

Output

The node outputs JSON data representing the response from the Evolution API after attempting to update the profile picture. This typically includes confirmation of success or details about any errors encountered.

If the operation succeeds, the output JSON will contain information confirming the profile picture was updated. If it fails, the output will include error messages describing what went wrong.

No binary data output is expected for this operation.

Dependencies

  • Requires an API key credential for the Evolution API to authenticate requests.
  • Optionally uses credentials for an auxiliary API ("n8nToolsApi") for subscription and API key validation.
  • The node expects configuration of:
    • Base URL of the Evolution API
    • API key for authentication
    • Instance name identifying the WhatsApp instance to operate on

These must be set up in n8n's credential management system prior to using the node.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API keys configured in the credentials are correct and active.
  • Unknown Resource or Operation Errors: These indicate misconfiguration of the resource or operation parameters. Ensure "Profile" is selected as the resource and "Update Profile Picture" as the operation.
  • Network or API Endpoint Issues: Check connectivity to the Evolution API base URL and ensure the instance name is valid.
  • Delay Parameter Misuse: If using the delay field, ensure the value is a non-negative integer representing milliseconds.
  • Missing Required Parameters: Make sure all required inputs, especially the media URL for the new profile picture, are provided.

Links and References

Discussion