Avisa API icon

Avisa API

Integration with Avisa API

Actions9

Overview

This node integrates with the Avisa API to send WhatsApp messages, specifically supporting sending media files such as images, videos, audio, and documents. The "Send Media" operation allows users to send a media file by providing its URL along with metadata like the file name, media type, and an optional message.

Common scenarios where this node is beneficial include:

  • Sending promotional images or videos to customers.
  • Sharing documents or PDFs via WhatsApp automatically.
  • Delivering audio clips or voice notes through automated workflows.

For example, a marketing automation workflow could use this node to send a product brochure (PDF) link to a list of customers, or a support system could send instructional videos to users.

Properties

Name Meaning
Phone Number The recipient's phone number in international format (e.g., +1234567890).
Message Optional text message to accompany the media file.
File Name The name of the media file being sent (e.g., "promo_video.mp4").
Media Type The type of media file to send. Options: Audio, Document, Image, Video.
Media URL The publicly accessible URL of the media file to be sent.

Output

The node outputs a JSON array where each element corresponds to the response from the Avisa API for each input item processed. Each response object typically contains success status and any returned data from the API call.

If an error occurs (such as invalid credentials or bad request), the output includes an object with success: false and an error field describing the issue.

The node does not output binary data; it only sends media via URLs and returns JSON responses.

Dependencies

  • Requires an active connection to the Avisa API service.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The media files must be hosted at accessible URLs since the node sends media by URL rather than uploading files directly.

Troubleshooting

  • Invalid or missing API token: The node will return errors with HTTP status 400 or 401 if the API token is incorrect or missing. Ensure the API key credential is correctly set up.
  • Invalid phone number format: The phone number must be in international format. Errors may occur if the format is wrong.
  • Unreachable media URL: If the media URL is not publicly accessible or invalid, the API may reject the request.
  • Timeouts on large files: The node sets a timeout of 5 minutes for media sending operations. Very large files or slow network connections might cause timeouts.
  • Error messages: The node surfaces error messages returned by the API under the error field in the output. Review these messages to diagnose issues.

Links and References

  • Avisa API Documentation (hypothetical link, replace with actual if available)
  • WhatsApp Business API guidelines for media messaging
  • n8n documentation on creating and using credentials

Discussion