🚀 WhatsApp QR Node for n8n

The easiest way to integrate WhatsApp into your n8n workflows!

Simply install and start using - no complex setup required!

⚡ Quick Start

1. Install the node:

   npm install @muhammadbinsaeed/n8n-nodes-whatsapp-qr

2. Restart n8n

3. That's it! The node will automatically handle browser setup for you.

🎯 Features

• ✅ Zero-configuration - Works out of the box
• ✅ Auto-browser detection - Finds or installs Chrome/Chromium automatically
• ✅ QR code authentication - Simple WhatsApp Web login
• ✅ Send messages - Text, images, documents
• ✅ Receive messages - Real-time webhook support
• ✅ Cross-platform - Windows, macOS, Linux, Docker
• ✅ Secure - No data storage, memory-only operations

📱 How It Works

1. Add the WhatsApp node to your workflow
2. Run the workflow - a QR code will appear in the n8n interface
3. Scan the QR code with your WhatsApp mobile app
4. Start sending/receiving messages!

🔧 Advanced Configuration (Optional)

If you need custom browser settings:

• Browser Path: Specify custom Chrome/Chromium location
• Webhook URL: Set custom webhook for message receiving
• Session Name: Use multiple WhatsApp accounts

🚨 Troubleshooting

Getting mock/test messages instead of real WhatsApp?

• Make sure Chrome or Chromium is installed
• On Linux servers, the node will try to install it automatically
• For Docker: Use our pre-configured image or install Chrome in your container

Need help?

• Check the Setup Guide for detailed instructions
• See Quick Start Examples for common use cases

🐳 Docker Support

The node works in Docker containers! It will automatically:

• Detect the Docker environment
• Configure headless browser settings
• Set up virtual display if needed

🔒 Security & Privacy

• No QR code storage - QR codes are never saved to disk
• Memory-only sessions - All data cleared when workflow stops
• Local processing - Everything runs on your server
• No external dependencies - Direct WhatsApp Web connection

📋 Requirements

• n8n: Version 0.190.0 or higher
• Node.js: Version 16 or higher
• Browser: Chrome/Chromium (auto-installed if missing)
• Memory: 512MB RAM minimum for browser

📖 Documentation

• Complete Setup Guide - Detailed installation for all platforms
• Quick Start Examples - Common workflow examples
• API Reference - Full node documentation

🆘 Support

Issues or questions?

• 📧 Email: [email protected]
• 💬 GitHub Issues: Report a bug
• 📚 Documentation: Full guides

Made with ❤️ by Rhino Clicks

This node is not affiliated with WhatsApp or Meta. WhatsApp is a trademark of Meta Platforms, Inc.