n8n-nodes-whatsapp-gateway

The Ultimate WhatsApp Automation Node for n8n.
Connect your n8n workflows to WhatsApp effortlessly using WAGate. Send messages, media, and manage devices with a self-hosted gateway that puts you in control.

🚀 Why WAGate?

• Privacy First: Self-hosted solution. Your data stays on your server.
• No Per-Message Fees: Unlike the official API, you use your own WhatsApp numbers.
• Rich Media: Send images, PDFs, audio, and video automatically.
• Smart Validation: Built-in phone number checking and safety filters.

💎 Free vs Pro

Start with our generous Free Tier for personal use or small projects, and upgrade to Pro when you're ready to scale!

| Feature | 🟢 Free Tier | ⚡ Pro Tier | | :--- | :---: | :---: | | Devices | 1 Device | Up to 10 Devices | | Messages | Unlimited Text | Unlimited Text & Media | | Media Support| - | ✅ Images, Docs, Video, Audio | | Bulk Validator| Max 5 / Request | Max 100 / Request | | Web Dashboard| Basic | Advanced | | Commercial Use| Personal | Yes |

👉 Get WAGate Pro License

⚡ Quick Start

1. Run the Gateway

You need a running instance of WAGate. The easiest way is using Docker:

For Free Tier (No License Key required):

docker run -d \
  --name wagate-free \
  -p 3000:3000 \
  -e API_KEY="my-secret-key" \
  -v $(pwd)/data:/app/data \
  elefgo/wagate:latest

For Pro Tier:

docker run -d \
  --name wagate-pro \
  -p 3000:3000 \
  -e API_KEY="my-secret-key" \
  -e LICENSE_KEY="your-jwt-license-key" \
  -v $(pwd)/data:/app/data \
  elefgo/wagate:latest

2. Install this Node in n8n

1. Go to Settings > Community Nodes.
2. Click Install a community node.
3. Enter n8n-nodes-whatsapp-gateway.
4. Click Install.

🛠️ Usage

Credentials Setup

1. In n8n, create a new Credential type: WhatsApp Gateway API.
2. Base URL: http://localhost:3000 (or your server IP).
3. API Key: The exact key you set in the Docker API_KEY environment variable.
4. Use the Connection Tester button to verify.

Available Operations

💬 Chat

• Send Text Message: Send simple text messages to any number.
• Send Media: (Basic/Pro) Send attachments. Supports auto-detection of MIME types.
• Check Numbers: Validate if numbers exist on WhatsApp.
  • Free Tier Note: Limited to 5 numbers at a time.

📱 Device Management

• Add Device: Returns a QR Code (raw string). Use with a QR generator node or view in the WAGate Dashboard.
• List Devices: See all connected sessions.
• Delete Device: Log out and remove a session.

⚠️ Important Notes

• License Limits: The node will return meaningful errors if you hit tier limits (e.g., trying to send media on Free tier).
• Security: The gateway includes active strict validation. Executable files (.exe, .sh, etc.) are blocked by default for your safety.

Support & License

• Get License: Gumroad
• Support Email: [email protected]
• License: MIT (Node code), WAGate Server is proprietary for Pro features.