Avisa App icon

Avisa App

Integration with Avisa App API

Actions5

Overview

This node integrates with the Avisa App API to send WhatsApp messages and media files programmatically. Specifically, for the Message - Send Document operation, it allows sending a document file encoded in Base64 or as binary data to a specified phone number via WhatsApp.

Common scenarios where this node is beneficial include:

  • Automating the distribution of invoices, contracts, or reports as documents to clients.
  • Sending user manuals or product datasheets directly through WhatsApp.
  • Sharing any type of document file securely and efficiently within automated workflows.

Example: Automatically send a PDF invoice to a customer after an order is processed by providing their phone number, the Base64-encoded PDF content, and the desired filename.

Properties

Name Meaning
Phone Number The recipient's phone number in international format or JID (WhatsApp identifier).
Document The document file content encoded in Base64 or provided as binary data.
File Name The name of the document file to be sent (e.g., "invoice.pdf").
Caption Optional caption text to accompany the document message.

Output

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

  • On success, the output contains the API response confirming the document was sent.
  • On failure (e.g., invalid phone number, authentication error), the output includes an object with success: false and an error message describing the issue.

No binary data is output by this node; it only returns JSON responses from the API.

Dependencies

  • Requires an API key credential for authenticating with the Avisa App API.
  • The base URL for the API is configured via the credential and used for all requests.
  • The node uses HTTP POST requests with JSON payloads to interact with the API endpoints.
  • Timeout for sending documents is set to 5 minutes to accommodate large files.

Troubleshooting

  • Error: Image size exceeds 100MB limit — Although this applies to images, similar size limits may apply to documents. Ensure your Base64-encoded document does not exceed 100MB.
  • Authentication errors (400 or 401 status codes) — Verify that the API key credential is correctly configured and has not expired.
  • Invalid phone number errors — Confirm the phone number is in the correct international format or valid JID.
  • Timeouts on large files — Large documents may take longer to upload; ensure network stability and consider splitting very large files if possible.
  • If the node returns { success: false, error: "..." }, check the error message for details and verify the request parameters.

Links and References

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

Discussion