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 messaging, specifically enabling sending various types of media including stickers. The "Send Sticker" operation under the "Media" resource allows users to send sticker files to a specified WhatsApp phone number.

Common scenarios for this node include:

  • Automating customer engagement by sending branded or custom stickers.
  • Enhancing chatbots with rich media responses.
  • Sending promotional or informational stickers as part of marketing campaigns.

For example, a business could automatically send a thank-you sticker after a customer completes a purchase, improving user experience and brand recognition.

Properties

Name Meaning
Phone Number The recipient's phone number including country code (without the "+" sign).
Media URL The URL or base64 encoded data of the sticker file to be sent.
Additional Fields Optional extra settings:
• Delay: Time in milliseconds to wait before sending the sticker.
• Link Preview: Enable or disable link preview in messages.
• Quoted Message ID: ID of a message to reply/quote.
• Mentions: Comma-separated list of phone numbers to mention in the message.

Output

The node outputs JSON data representing the response from the Evolution API after attempting to send the sticker. This typically includes status information about the message delivery.

If an error occurs, the output JSON will contain an error field describing the issue.

No binary data is output by this operation.

Dependencies

  • Requires an active Evolution API account with valid credentials including:
    • Base URL
    • API key
    • Instance name
  • Optionally uses an additional API service ("N8N Tools API") for subscription validation.
  • Proper configuration of these credentials within n8n is necessary for successful execution.

Troubleshooting

  • Invalid Credentials: If the API key or subscription is invalid, the node throws an error indicating authentication failure. Verify that the API keys and instance names are correctly configured.
  • Unknown Operation or Resource: Errors occur if unsupported operations or resources are selected. Ensure "Media" resource and "Send Sticker" operation are chosen.
  • Network Issues: Failures in HTTP requests may happen due to connectivity problems. Check network access and API endpoint availability.
  • Message Delivery Failures: If the phone number is incorrect or not registered on WhatsApp, the API may reject the request. Confirm the phone number format and registration.
  • Delay Misconfiguration: Setting an excessively long delay might cause unexpected behavior; use reasonable values.

Links and References

Discussion