Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

This node integrates with the Evolution API to automate WhatsApp profile management, specifically allowing users to update their WhatsApp profile status (the "about" text). It is useful in scenarios where you want to programmatically change your WhatsApp status based on external triggers or workflows, such as updating availability, sharing promotional messages, or reflecting current activity automatically.

For example, a business could use this node to update their WhatsApp status to show current offers or service hours dynamically without manual intervention.

Properties

Name Meaning
Status Text The new status/about text to set on the WhatsApp profile.
Additional Fields Optional extra parameters:
• Delay: Delay in milliseconds before sending the update.
• 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 in the message.

Output

The node outputs a JSON object containing the response from the Evolution API after attempting to update the profile status. This typically includes confirmation of the update or error details if the operation failed.

Example output structure:

{
  "status": "success",
  "message": "Profile status updated",
  "data": {
    // API-specific response data
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an active Evolution API credential with a valid API key and instance name.
  • Optionally uses a secondary API key credential for validation via the N8N Tools API.
  • The node sends HTTP requests to the Evolution API endpoints; thus, internet connectivity and correct API endpoint configuration are necessary.
  • No additional environment variables are explicitly required beyond the configured credentials.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws errors related to invalid subscription or API key, verify that the provided API keys are correct and have the necessary permissions.
  • Unknown Operation or Resource Errors: These occur if the resource or operation parameters are incorrect or unsupported. Ensure the resource is set to "Profile" and operation to "Update Profile Status".
  • Network or Connectivity Issues: Failures in HTTP requests may be due to network problems or incorrect base URLs. Confirm network access and API endpoint correctness.
  • Delay Parameter Misuse: Setting a very high delay might cause unexpected workflow timing issues. Use reasonable delay values.
  • Malformed Additional Fields: Incorrect formatting in fields like mentions (should be comma-separated phone numbers) can cause API errors.

To resolve most errors, check credentials, parameter correctness, and API availability.

Links and References

Discussion