Avisa API icon

Avisa API

Integration with Avisa API

Actions9

Overview

This node integrates with the Avisa API to send WhatsApp messages with rich link previews. Specifically, the Send Preview operation allows users to send a message that includes a clickable URL preview containing a title, description, and an image. This is useful for scenarios such as marketing campaigns, customer notifications, or sharing product links where a visual preview enhances engagement.

For example, a business can use this node to send customers a promotional message with a link preview of a new product page, including an image, title, and description, making the message more attractive and informative.

Properties

Name Meaning
Phone Number The recipient's phone number in international format (e.g., +1234567890).
Message Optional text message to accompany the preview link.
URL Site The URL of the website to generate the preview for.
Description A short description shown in the preview below the title.
Title The title displayed in the preview link.
Image (Base64) A base64-encoded image to be used as the preview thumbnail.

Output

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

Example output JSON snippet:

[
  {
    "success": true,
    "messageId": "abc123",
    "status": "sent"
  }
]

If the API call fails (e.g., due to invalid parameters or authentication issues), the output will include an object with success: false and an error field describing the problem.

The node does not output binary data for this operation.

Dependencies

  • Requires an active connection to the Avisa API service.
  • Needs an API token credential configured in n8n for authenticating requests.
  • The node makes HTTP POST requests to the Avisa API endpoint /actions/sendPreview.

Troubleshooting

  • Common Issues:

    • Invalid or missing API token: The node will return an authentication error.
    • Incorrect phone number format: The API may reject the request if the phone number is not in proper international format.
    • Missing required fields (URL, title, description, image): The API will respond with validation errors.
    • Large base64 image strings might cause timeouts or failures.

  • Error Messages:

    • 401 Unauthorized: Check that the API token is correctly set and valid.
    • 400 Bad Request: Verify all required parameters are provided and correctly formatted.
    • Network timeouts or connectivity issues: Ensure the n8n instance has internet access and the Avisa API is reachable.

To resolve errors, verify credentials, ensure all required properties are filled, and confirm the phone number and URL formats.

Links and References

  • Avisa API Documentation (hypothetical link, replace with actual if available)
  • WhatsApp Business API guidelines for message formatting and link previews.

This summary focuses on the Message resource and Send Preview operation as requested.

Discussion