Wazend API icon

Wazend API

Interact with Wazend API

Overview

This node integrates with the Wazend API to send video messages via a messaging platform. 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, optionally including a caption and additional message options such as delay before sending, replying to a specific message, and mentioning participants.

Common scenarios where this node is beneficial include:

  • Automating multimedia customer support responses by sending instructional or promotional videos.
  • Broadcasting video updates or announcements to individual contacts or groups.
  • Enhancing chatbot interactions with rich media content.

Example: Sending a product demo video to a customer with a personalized caption and mentioning specific group members.

Properties

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

Output

The node outputs a JSON array containing the response from the Wazend API after attempting to send the video message. This typically includes confirmation details such as message IDs, status, timestamps, or error information if the send failed.

If the node supports binary data output (not explicitly shown here), it would represent the video or related media content; however, based on the source, the output is JSON only.

Dependencies

  • Requires an active connection to the Wazend API service.
  • Needs an API authentication token or key configured in n8n credentials (referred generically as "an API key credential").
  • Network access to the video URL if the video is provided as a link.
  • Proper formatting of recipient numbers according to the messaging platform's requirements.

Troubleshooting

  • Common Issues:

    • Invalid or missing instance name or recipient number will cause the operation to fail.
    • Incorrect video URL or malformed base64 string may result in upload errors.
    • Mentioning invalid or improperly formatted phone numbers can cause message delivery issues.
    • Delay values too low might cause rate limiting or API throttling.
  • Error Messages:

    • "Operação não suportada." indicates the selected operation-resource combination is not implemented.
    • API errors returned from Wazend may include authentication failures, invalid parameters, or media upload errors.
  • Resolutions:

    • Verify all required fields are correctly filled.
    • Ensure the API key credential is valid and has necessary permissions.
    • Check video URLs or base64 strings for correctness.
    • Format phone numbers according to international standards.
    • Adjust delay settings to avoid hitting API limits.

Links and References

Discussion