n8n-nodes-whatsapp

This is an n8n community node that lets you use WhatsApp in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-whatsapp in Enter npm package name
4. Click Install

Manual Installation

To install manually, navigate to your n8n installation and run:

npm install n8n-nodes-whatsapp

Configuration

Prerequisites

You need to have the WhatsApp Bot API running. See the main README for setup instructions.

Setup Credentials

1. In n8n, go to Credentials and create a new WhatsApp API credential
2. Enter your WhatsApp Bot API URL (e.g., http://localhost:3000)
3. (Optional) Enter an API key if you've secured your API

Configure Webhook

For the WhatsApp Trigger node:

1. Add the WhatsApp Trigger node to your workflow
2. Copy the webhook URL shown in the node
3. Update your WhatsApp bot's config.json with this webhook URL:

{
  "port": 3000,
  "accounts": [
    {
      "name": "account1",
      "authFolder": "baileys_auth_account1",
      "webhookUrl": "https://your-n8n-instance.com/webhook/xxx"
    }
  ]
}

4. Restart your WhatsApp bot

Operations

WhatsApp Node (Actions)

Message

• Send: Send a WhatsApp message
  • Account Name: Which account to send from
  • Phone Number: Recipient (with country code, no +)
  • Message: Text to send

Account

• List: Get all accounts and their connection status

WhatsApp Trigger Node

Triggers when a WhatsApp message is received.

Options:

• Filter Messages: Exclude messages sent by you (default: true)
• Account Filter: Only trigger for specific account

Output:

{
  "account": "account1",
  "timestamp": "2025-11-13T10:30:00.000Z",
  "type": "notify",
  "chatId": "[email protected]",
  "sender": "John Doe",
  "text": "Hello!",
  "fromMe": false,
  "messageId": "3EB0XXXXX"
}

Example Workflows

Auto-Reply Bot

[WhatsApp Trigger]
  → [Filter: text contains "hello"]
  → [WhatsApp: Send message]

Forward to Slack

[WhatsApp Trigger]
  → [Slack: Send message]

CRM Integration

[WhatsApp Trigger]
  → [Set variables]
  → [Airtable: Create record]
  → [WhatsApp: Send confirmation]

Compatibility

• n8n version: 1.0.0 or later
• WhatsApp Bot API: Compatible with the included bot

Resources

• n8n community nodes documentation
• WhatsApp Bot Setup Guide

License

MIT