Description

n8n-nodes-waha

This is an n8n community node. It lets you use WAHA (WhatsApp HTTP API) in your n8n workflows.

WAHA (WhatsApp HTTP API) is a robust solution that provides a REST API for WhatsApp, allowing you to send and receive messages, manage sessions, and handle media programmatically.

• Github Repository
• NPM Registry

—

Installation
Operations
Credentials
Compatibility
Resources
Version history
Screenshots

Installation

Go to your n8n Settings => Community nodes and install:

@kubex3/n8n-nodes-waha

Operations

Triggers (Webhook)

This node acts as a webhook receiver for your WAHA instance. It allows you to listen for real-time events from WhatsApp.

Key Features:

• Event Filtering: Select specific events to listen for (e.g., message, session.status, etc.).
• Custom Webhook Path: Define a custom URL path for your webhook endpoint.
• Response Customization: Configure how the node responds to the webhook request (Response Mode).
• Data Ping: Supports data ping events for connection testing.

Advanced Options

The node includes robust security and filtering options:

• Include Self-Messages: Capture messages sent by your own account. This is perfect for testing your workflows easily without needing a second device or another whatsapp account.
• Header Authentication: Enable header-based authentication to secure your webhook.
• Ignore Bots: Automatically filter out bot traffic.
• Allowed Origins (CORS): Restrict which origins are allowed to access the webhook.
• Domains Whitelist: specific domains allowed to interact with the webhook.
• IP(s) Whitelist: Restrict access to specific IP addresses for enhanced security.

> Note: This release is currently focused on the Trigger/Webhook functionality. Standard Action nodes (sending messages) are in development and will be released in a future update.

Credentials

Webhook Security (Optional)
If you have enabled “Header Authentication” in the node options, you will need to configure the matching credentials or headers within your WAHA instance configuration to ensure requests are authorized.

Compatibility

• n8n version: Tested on n8n v1.0.0 and above.
• WAHA version: Compatible with the latest stable release of WAHA (Core/Plus).

Resources

• n8n community nodes documentation
• WAHA Official Documentation
• WAHA GitHub Repository

Version history

• 0.1.0 – Initial release featuring the Webhook Trigger node with advanced security (CORS, IP Whitelist) and custom routing options.

Screenshots

!alt text
!alt text
!alt text
!alt text