Valeia - Send Message icon

Valeia - Send Message

Send a WhatsApp message using Valeia
Join our community

Overview

This node sends WhatsApp messages using the Valeia messaging service. It is designed to automate sending text messages to specified phone numbers in international format, specifically targeting Colombian numbers (starting with country code 57). This node is useful for scenarios such as customer notifications, alerts, marketing campaigns, or any workflow requiring automated WhatsApp communication.

For example, you can use this node to send appointment reminders to clients or notify users about order status updates directly via WhatsApp.

Properties

Name Meaning
To The recipient's phone number in international format. Must start with "57" and be 12 digits long (e.g., 573228854498).
Message The text content of the WhatsApp message to send. Cannot be empty.

Output

The node outputs an array of JSON objects, each representing the response from the Valeia API for a sent message. Each output item contains the full JSON response returned by the API, which typically includes details about the message delivery status.

In case of failure and if the node is configured to continue on error, the output JSON will include:

  • success: false
  • error: A descriptive error message
  • statusCode: HTTP status code or "No status" if unavailable

The node does not output binary data.

Dependencies

  • Requires an active Valeia API credential configured in n8n for authentication.
  • Sends HTTP POST requests to the Valeia API endpoint: https://valeian8n.whitelabel.lat/api/messages/send.
  • The node depends on network connectivity to the Valeia service.

Troubleshooting

  • Invalid phone number error: The phone number must start with "57" and be exactly 12 digits long. Ensure the input matches this format.
  • Empty message error: The message property cannot be empty or whitespace only.
  • API errors: If the Valeia API returns an error, the node throws an error with the API's message and status code. Check your API credentials, network connection, and ensure the Valeia service is operational.
  • Continue on Fail: If enabled, the node will output error details instead of stopping execution, allowing workflows to handle failures gracefully.

Links and References

Discussion