Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The node "Evolution API" allows interaction with the Evolution API service, enabling sending messages including images. Specifically, the "Enviar Imagem" (Send Image) operation under the "Mensagem" (Message) resource sends an image message to a specified recipient number via a chosen instance.

This node is useful in scenarios where automated image messaging is required, such as:

  • Sending promotional images or product photos to customers.
  • Sharing event flyers or announcements in chat groups.
  • Automating customer support by sending screenshots or visual instructions.

Example: Automatically send a welcome image with a caption to new users joining a WhatsApp group.

Properties

Name Meaning
Nome Da Instancia The name of the instance that will send the message.
Número Do Destinatário The recipient's phone number in international format.
Imagem URL or base64 string of the image to be sent.
Caption Optional text caption to accompany the image.
Opções (Options) Collection of additional options:
- Delay Number of milliseconds to wait before sending the message (default 1200 ms).
- Responder Mensagem Option to reply to a specific message by providing its ID.
- Menções Mention settings:
- Mencionar Todos Boolean to mention all participants in a group.
- Números Para Mencionar Comma-separated list of phone numbers to mention individually (only if not mentioning everyone).

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to send the image message. The exact structure depends on the API response but typically includes confirmation details such as message ID, status, and any error information.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Evolution API service.
  • The node expects the Evolution API endpoint to be reachable at https://doc.evolution-api.com/api-reference.
  • Proper configuration of the instance name and recipient number is necessary.
  • Network access to URLs provided for images (if using URL instead of base64).

Troubleshooting

  • Common issues:

    • Invalid or missing instance name or recipient number will cause failures.
    • Incorrect image URL or malformed base64 string may result in message sending errors.
    • Delay value too low might cause rate limiting or message ordering issues.
    • Mentioning invalid or improperly formatted numbers can cause mention failures.

  • Error messages:

    • "Operação não suportada." means the selected operation is not supported for the resource; verify correct resource-operation selection.
    • API authentication errors indicate missing or invalid API credentials.
    • Network errors suggest connectivity problems or incorrect image URLs.

  • Resolutions:

    • Double-check all required fields are filled correctly.
    • Validate image data format and accessibility.
    • Ensure API credentials are valid and have necessary permissions.
    • Increase delay if encountering rate limits.

Links and References

Discussion