Avisa App icon

Avisa App

Integration with Avisa App API

Actions5

Overview

This node integrates with the Avisa App API to send various types of WhatsApp messages. Specifically, for the Message - Send Media operation, it sends media files such as images, videos, audio, or documents by providing a URL to the file. This is useful when you want to share multimedia content on WhatsApp without embedding the file data directly in the workflow.

Common scenarios include:

  • Sending promotional images or videos to customers.
  • Sharing audio clips or voice notes.
  • Delivering documents like PDFs or spreadsheets via WhatsApp.

Example: You can send a product brochure PDF hosted on your website by specifying its URL, the recipient's phone number, and an optional message caption.

Properties

Name Meaning
Phone Number The recipient's phone number in international format or JID (WhatsApp identifier).
File URL The publicly accessible URL of the media file to send (image, video, audio, or document).
Type The type of media being sent. Options: Image, Video, Audio, Document.
File Name The name of the file to be sent, including extension (e.g., "photo.jpg").
Message Optional text message to send along with the media file.

Output

The node outputs a JSON array where each item corresponds to the response from the Avisa App API for each input item processed.

Typical output fields include:

  • success: Boolean indicating if the message was sent successfully.
  • Other response data returned by the API, which may include message IDs or status information.
  • In case of failure, an object with success: false and an error message describing the issue.

The node does not output binary data; all responses are JSON objects representing the API result.

Dependencies

  • Requires an active connection to the Avisa App API.
  • Needs an API authentication token credential configured in n8n (referred generically as "an API key credential").
  • The base URL for the API is taken from the credential configuration.
  • Network access to the media file URLs must be available from the n8n environment.

Troubleshooting

  • Error: Image size exceeds 100MB limit
    When sending images encoded in Base64 (other operations), the node enforces a 100MB size limit. For the Send Media operation using URLs, ensure the file is accessible and not too large for WhatsApp limits.

  • HTTP 400 or 401 errors
    These indicate bad requests or unauthorized access. Verify that the API token is correct and has necessary permissions. Also, check that the phone number and file URL are valid and properly formatted.

  • Network errors or timeouts
    Large media files or slow network connections might cause timeouts (the node sets a 5-minute timeout for media sending). Ensure stable connectivity and that the file URL is reachable.

  • Invalid phone number format
    The phone number must be in international format or a valid WhatsApp JID. Incorrect formatting will cause the API to reject the request.

Links and References

This summary focuses solely on the Message - Send Media operation of the Avisa App node based on static code analysis and provided property definitions.

Discussion