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 Vídeo (Send Video) operation, it allows sending a video message to a specified recipient number through a configured instance.

Common scenarios where this node is beneficial include automating multimedia communication via WhatsApp or similar platforms supported by the Evolution API. For example, businesses can automatically send promotional videos, tutorials, or personalized video messages to customers.

Practical example: Automatically sending a welcome video to new users after they sign up, using the "Enviar Vídeo" operation with the recipient's phone number and the video URL.

Properties

Name Meaning
Instance Name The name of the Evolution API instance to use for sending the video message.
Number The recipient's phone number to which the video will be sent.
Video URL The URL of the video file to be sent as a message.

Output

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

  • success: A boolean indicating if the operation was successful.
  • Other fields returned by the API, which may include message IDs, status, or error details.
  • timestamp: The ISO string timestamp when the operation was performed.

If the API returns an array of responses, the node parses each item accordingly and returns them as an array in the output.

The node does not output binary data directly; it only handles URLs pointing to media.

Dependencies

  • Requires an API key credential for authenticating requests to the Evolution API.
  • The node uses HTTP requests to the Evolution API endpoints.
  • Proper configuration of the Evolution API credentials in n8n is necessary.
  • The video must be accessible via the provided URL for the API to fetch and send it.

Troubleshooting

  • Common issues:

    • Invalid or unreachable video URL: Ensure the video URL is publicly accessible or accessible by the Evolution API server.
    • Incorrect instance name: Verify that the instance name matches an active instance configured in the Evolution API.
    • Invalid recipient number format: Confirm the phone number is in the correct international format expected by the API.
    • Authentication errors: Check that the API key credential is valid and has the required permissions.

  • Common error messages:

    • Authentication failures: Usually indicate invalid or missing API credentials.
    • 404 Not Found on instance or endpoint: May mean the instance name is incorrect or the API endpoint changed.
    • Media upload errors: Could indicate unsupported video formats or inaccessible URLs.

Resolving these typically involves verifying input parameters, ensuring network accessibility, and confirming credential validity.

Links and References

Discussion