Evolution API icon

Evolution API

Interact with Evolution API

Actions64

Overview

The "Enviar Video" operation under the "Mensagem" (Message) resource allows you to send a video message via the Evolution API. This node is useful for automating the delivery of video content to WhatsApp recipients, such as sending promotional videos, informational clips, or personalized messages in workflows that require multimedia communication.

Practical examples:

  • Sending a product demo video to a customer after they fill out a form.
  • Delivering onboarding instructions in video format to new users.
  • Broadcasting event invitations with a video teaser to a group.

Properties

Below are the supported input properties for this operation:

Display Name Type Meaning
Nome Da Instância String The name of the instance that will send the video. Required.
Número Do Destinatário String The recipient's phone number in international format. Required.
Video String URL or base64 string of the video to be sent. Required.
Caption String Optional text to accompany the video.
Opções Collection Additional options for the message:
- Delay Number Delay in milliseconds before sending the message (default: 1200 ms).
- Responder Mensagem FixedColl. Allows replying to a specific message by its ID.
- ID Da Mensagem String The ID of the message being replied to.
- Menções FixedColl. Mention settings for the message:
- Mencionar Todos Boolean Whether to mention all participants in the group.
- Números Para Mencionar String Comma-separated list of numbers to mention (e.g., 5511999999999,5511888888888).

Output

The output is a JSON object containing the response from the Evolution API after attempting to send the video message. The structure typically includes:

{
  "status": "success",
  "messageId": "string",
  "timestamp": "number",
  "details": { /* additional API-specific fields */ }
}
  • status: Indicates if the request was successful.
  • messageId: The unique identifier of the sent message.
  • timestamp: When the message was sent.
  • details: Any additional information returned by the API.

Note: The exact structure may vary depending on the Evolution API's response.

Dependencies

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

Troubleshooting

Common Issues:

  • Missing or Invalid Credentials: If credentials are not set up correctly, the node will fail to authenticate with the Evolution API.

  • Unsupported Operation Error: If the selected operation or resource is not implemented, you may see an error like:

    Operação não suportada.
A função "send-video" para o recurso "messages-api" não é suportada!

    Resolution: Ensure you have selected a valid resource and operation combination.

  • Invalid Input Data: Supplying an incorrect phone number format, invalid video URL/base64, or missing required fields can cause the API to reject the request.

Error Messages:

  • "Opera\xE7\xE3o n\xE3o suportada."
    Meaning: The chosen operation/resource is not available. Double-check your configuration.
  • API-specific errors (e.g., authentication failure, invalid media): Refer to the API documentation for details.

Links and References

If you encounter issues, consult the above resources or check your API credentials and input data for accuracy.

Discussion