Evolution API

Interagir com a Evolution API v2
Join our community

Actions53

Overview

This node integrates with the Evolution API v2 to perform various operations related to messaging, instances, groups, chats, events, and integrations. Specifically, for the Mensagem (Message) resource and the Enviar Imagem (Send Image) operation, it allows sending an image message to a specified recipient number through a named instance.

Common scenarios where this node is beneficial include automating WhatsApp messaging workflows such as sending promotional images, product photos, or informational graphics directly to customers or contacts. For example, a marketing automation workflow could use this node to send a product catalog image with a caption to a list of customers.

Properties

Name Meaning
Instance Name The name of the Evolution API instance to use for sending the message.
Number The recipient's phone number to which the image will be sent.
Image URL The URL of the image to be sent in the message.
Caption Optional text caption that accompanies the image.

Output

The node outputs a JSON array where each item corresponds to the result of sending the image message for each input item. The output structure includes:

  • success: Boolean indicating if the operation was successful.
  • message: A success message string (if applicable).
  • timestamp: ISO string timestamp of when the operation completed.
  • Additional fields returned by the Evolution API response, parsed from JSON if possible.

If the API returns multiple items or strings, they are parsed into objects accordingly. Errors are captured per item if "Continue On Fail" is enabled.

The node does not output binary data for this operation.

Dependencies

  • Requires an authenticated connection to the Evolution API v2 via an API key credential configured in n8n.
  • The node uses HTTP requests to the Evolution API endpoints, so internet access and valid credentials are necessary.
  • The "Instance Name" must correspond to a valid and connected Evolution API instance.

Troubleshooting

  • Invalid Instance Name: If the instance name does not exist or is not connected, the API call will fail. Verify the instance name and connection status.
  • Invalid Number Format: Ensure the recipient number is in the correct international format expected by the Evolution API.
  • Image URL Issues: The image URL must be accessible and publicly reachable by the Evolution API service. Private or protected URLs may cause failures.
  • API Authentication Errors: Check that the API key credential is correctly set up and has permissions for the requested operation.
  • Network Errors: Network connectivity issues between n8n and the Evolution API endpoint can cause request failures.
  • Error Messages: The node captures error messages from the API and surfaces them in the output if "Continue On Fail" is enabled. Review these messages for specific troubleshooting hints.

Links and References

Discussion