Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

This node enables sending interactive button messages via WhatsApp using the Evolution API. It is designed to automate WhatsApp messaging workflows where you want to engage recipients with predefined interactive buttons, improving user interaction and response rates.

Common scenarios include:

  • Customer support bots that offer quick reply options.
  • Marketing campaigns with call-to-action buttons.
  • Surveys or feedback requests with selectable options.

For example, you can send a message to a customer with buttons like "Yes", "No", and "More Info" to quickly capture their response without typing.

Properties

Name Meaning
Phone Number The recipient's phone number including country code (without the "+" sign).
Additional Fields Optional extra settings:
• Delay: Time in milliseconds to wait before sending the message.
• Link Preview: Enable or disable link previews in the message.
• 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 send the button message. This typically includes status information about the sent message, such as message IDs or error details if the operation failed.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Evolution API credential with a valid API key and instance name configured in n8n.
  • Optionally uses an additional API key credential for validating subscription via the N8N Tools API.
  • The node makes HTTP POST requests to the Evolution API endpoints to perform actions.

Troubleshooting

  • Invalid API Key or Subscription: If the node throws errors related to invalid subscription or API key, verify that your Evolution API credentials and any secondary API keys are correct and active.
  • Unknown Operation or Resource Errors: These occur if the selected operation or resource is not supported. Ensure you have chosen "Message" as the resource and "Send Buttons" as the operation.
  • Message Sending Failures: Network issues or incorrect phone numbers may cause failures. Confirm the phone number format (country code without "+") and network connectivity.
  • Delay Misconfiguration: Setting a very high delay might cause unexpected waiting times; use reasonable values.

Links and References

Discussion