Evolution API

Overview

The "Enviar Imagem" operation of the "Mensagem" (Message) resource in this custom n8n node allows you to send an image message via the Evolution API. This is useful for automating the sending of images (such as photos, receipts, or promotional materials) to WhatsApp users or groups from your workflows. Typical scenarios include customer support, marketing campaigns, or automated notifications that require visual content.

Example use cases:

• Sending a product image to a customer after purchase.
• Sharing event flyers with a group.
• Sending receipts or confirmations with an attached image.

Properties

Below are the input properties supported by this operation:

Opções (Options) sub-properties:

• Delay (Number): Milliseconds to wait before sending the message (default: 1200).
• Responder Mensagem (Fixed Collection):
  • ID Da Mensagem (String): ID of the message being replied to.
• Menções (Fixed Collection):
  • Mencionar Todos (Boolean): Whether to mention all participants in the group.
  • Números Para Mencionar (String): List of numbers to mention (comma-separated), used if "Mencionar Todos" is false.

Output

The output is a JSON object (or array of objects) representing the result of the image message send operation. The structure typically includes:

{
  "status": "success",
  "messageId": "string",
  "timestamp": "number",
  // ...other fields as returned by the Evolution API
}

• status: Indicates if the operation was successful.
• messageId: The unique identifier of the sent message.
• timestamp: When the message was sent.

Note: The exact fields depend on the Evolution API response.

Dependencies

• External Service: Requires access to the Evolution API.
• API Key/Credentials: You must configure the "evolutionApi" credentials in n8n.
• Environment: No special environment variables required beyond n8n credential setup.

Troubleshooting

Common issues:

• Invalid Instance Name: Ensure "Nome Da Instancia" matches a configured and active instance in Evolution API.
• Recipient Number Format: "Número Do Destinatário" should be in the correct WhatsApp JID format.
• Image Format: "Imagem" must be a valid URL or base64-encoded image string.
• Missing Credentials: If credentials are not set up, the node will fail to authenticate.

Error messages:

• "Operação não suportada."
  Cause: The selected operation is not implemented for the chosen resource.
  Resolution: Double-check the resource and operation selection.

• API errors (from Evolution API) may be passed through; check the error message for details such as invalid parameters or authentication failures.

Links and References

• Evolution API Documentation
• n8n Credentials Documentation
• WhatsApp JID Format Reference