Documentation

n8n-nodes-valeia

This is an n8n community node. It lets you use Valeia in your n8n workflows.

Valeia is a messaging platform that allows users to send and receive WhatsApp messages, manage webhook configurations, and onboard new users through a simple API powered by API Key authentication.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history


Installation

Follow the installation guide in the n8n community nodes documentation.

Or if using npm directly:

npm install n8n-nodes-valeia

Then add the package path to your N8N_CUSTOM_EXTENSIONS env variable.


Operations

The following operations are available:

✅ Valeia Send Message

  • Send a WhatsApp message using the Valeia API.

✅ Valeia Simulate Webhook

  • Test incoming webhook payloads to simulate message delivery.

✅ Valeia Get My Info

  • Retrieve information about the current authenticated Valeia user.

✅ Valeia Set Webhook

  • Register or update your webhook endpoint for receiving WhatsApp messages.

✅ Valeia Onboarding

  • Register a new user and receive their API key via a callback URL.

Credentials

This node uses API Key authentication. To use it:

  1. Sign up or contact the Valeia team to obtain an API Key.
  2. In n8n, create a new set of credentials under Valeia API Key.
  3. Paste your API Key into the corresponding field.

Once authenticated, all node operations will use your API key securely.


Compatibility

  • Minimum n8n version: 1.23.0
  • Tested with: n8n 1.88.x
  • No known incompatibilities.

Usage

To use the Valeia nodes:

  1. Install the package following the installation steps.
  2. Add any of the Valeia nodes to your workflow.
  3. Connect them with other nodes like Webhooks, HTTP Request, Function, etc.
  4. Authenticate using your API Key credentials.
  5. Trigger your flows by sending messages or receiving webhooks from WhatsApp.

For testing inbound webhooks locally, consider using ngrok to expose your local n8n instance publicly.


Resources


Version history

1.0.7

  • Initial release with support for:
    • Sending WhatsApp messages
    • Simulating inbound webhooks
    • Managing webhook URLs
    • Onboarding new users
    • Retrieving authenticated user info
    • New Image logo

Discussion