n8n Community Node

The WSAPI n8n Community Node brings WhatsApp automation to your n8n workflows, offering 101 WhatsApp API operations across 11 resource types, AI agent compatibility, and real-time webhook support.

Installation

Community Nodes (Recommended)
Manual Installation

Open n8n settings

Navigate to Settings → Community Nodes in your n8n instance.

Install the node

Click Install Community Node and enter:

@wsapichat/n8n-nodes-wsapi

Start using

The WSAPI node is now available in your workflow editor.

# Navigate to your n8n installation directory
cd /path/to/your/n8n

# Install the community node
npm install @wsapichat/n8n-nodes-wsapi

# Restart n8n
npm run start

Available resources

Resource	Operations
Messages	Send text, links, images, videos, audio, documents, stickers, contacts, locations, reactions. Edit, delete, star, and mark as read
Chats	Retrieve, delete, set presence, configure ephemeral settings, mute, pin, archive
Session	Get QR code, login code, connection status, logout
Contacts	List, upsert, sync, block and unblock
Groups	Create, delete, rename, manage participants, invite links
Users	Own profile, presence, privacy, phone checks and user profiles
Calls	Reject incoming calls
Media	Download received media
Communities	Create, configure, manage participants and linked groups
Newsletters	Create, inspect, subscribe and mute
Status	Privacy, text/image/video updates and deletion

This node covers WhatsApp operations, not Cloud Account/subscription management or OSS admin endpoints. Configure a custom base URL for a self-hosted OSS instance. The package is published on npm; installation on n8n Cloud additionally depends on n8n’s community-node availability and policies. A published npm package does not by itself establish verified-node status.

AI agent integration

The WSAPI node works with n8n’s AI Agent nodes. Set parameters to “Let the model define this parameter” and connect directly to AI nodes for conversational workflows.

WSAPI Trigger (WhatsApp Message)
├── AI Agent Node
│   ├── Context: Your knowledge base
│   ├── Tools: WSAPI Send Message
│   └── Output: AI-generated response
└── WSAPI Send Text Message

Webhook trigger

The WSAPI Trigger node receives real-time events from your WhatsApp instance:

Message events (new, read, delete)
Chat events (presence, settings)
Session events (login, logout)
Call events
Contact events
User events

The trigger supports all 21 event types, including history sync, groups and newsletters. Parsed output preserves optional adReferral metadata, including ctwaClid. Credentials are optional for unsigned event reception. Configure the instance’s signing secret in WSAPI credentials to validate X-Webhook-Signature over the original request bytes; missing or invalid signatures return HTTP 401. API credentials are needed for automatic media download. A failure to load configured credentials is not treated as an unsigned webhook. The Star Message operation can also unstar via its Starred switch. Message editing accepts mentions and ephemeral expiration, including off. Community creation exposes approval mode and subgroup creation accepts participants.

Common workflows

Customer support automation — auto-respond to common queries using AI
Order notifications — send WhatsApp updates when order status changes
Group management bots — automate group administration tasks
Media processing pipelines — receive and process media from WhatsApp

GitHub

github.com/wsapi-chat/n8n-nodes-wsapi

Getting Started

Basics

SDKs & Libraries

Integrations

Installation

Available resources

AI agent integration

Webhook trigger

Common workflows

GitHub

​Installation

​Available resources

​AI agent integration

​Webhook trigger

​Common workflows

​GitHub

Installation

Available resources

AI agent integration

Webhook trigger

Common workflows

GitHub