Evolution API icon

Evolution API

Interact with Evolution API

Overview

This node integrates with the Evolution API to send video messages. Specifically, for the "Mensaje" resource and the "Enviar Video" operation, it allows users to send a video file (via URL or base64) to a specified recipient number through an instance of the Evolution messaging service.

Common scenarios include:

  • Sending promotional or informational videos to customers.
  • Sharing video updates or announcements in automated workflows.
  • Responding to user queries with video content in chatbots.

Example: Automatically sending a welcome video to new users who sign up on a platform.

Properties

Name Meaning
Nombre De La Instancia The name of the instance that will send the video message.
Número Del Destinatario The recipient's phone number to which the video will be sent.
Video The video content to send, provided as a URL or base64 string.
Leyenda Optional text caption to accompany the video message.
Opciones Additional options for sending the message:
- Retraso Delay in milliseconds before the message is sent (default 1200 ms).
- Responder Mensaje ID of a message to reply to (quoted message).
- Menciones Settings for mentions within the message:
-- Mencionar a Todos Boolean to mention all group participants.
-- Números Para Mencionar Comma-separated list of numbers to mention individually (used if not mentioning everyone).

Output

The node outputs a JSON array containing the response from the Evolution API after attempting to send the video message. This typically includes status information about the message delivery.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Evolution API via an API key credential configured in n8n.
  • Network access to the Evolution API endpoint (https://doc.evolution-api.com/api-reference).
  • Proper configuration of the instance name and recipient number according to the Evolution API requirements.

Troubleshooting

  • Common issues:

    • Invalid or missing instance name or recipient number will cause the API call to fail.
    • Incorrect video URL or malformed base64 data may result in message sending errors.
    • Insufficient permissions or invalid API credentials will prevent successful communication with the Evolution API.
  • Error messages:

    • "Operação não suportada." indicates an unsupported operation-resource combination; ensure you select "Mensaje" resource and "Enviar Video" operation.
    • API errors related to authentication or invalid parameters will be returned by the Evolution API and surfaced by the node.
  • Resolutions:

    • Verify all required fields are correctly filled.
    • Check API credentials and permissions.
    • Validate video input format and accessibility.

Links and References

Discussion