How to Connect WhatsApp to n8n Using Evolution API (Full Setup Guide)
Most businesses know WhatsApp automation could transform their customer support - but Meta's per-message fees make it prohibitively expensive. This Evolution API solution lets you automate WhatsApp messaging through n8n with no ongoing costs, AI-powered responses, and full control over your communication workflows.
What is Evolution API? Key Benefits Explained
Every business using WhatsApp faces the same dilemma - manual messaging doesn't scale, but Meta's Business API comes with complex approval processes and per-message fees that can cost thousands monthly. Evolution API solves this by automating WhatsApp Web functionality through an open-source solution.
Unlike official integrations that convert your number to a business account, Evolution API works like having an automated version of WhatsApp Web. This means you keep using your existing number normally on your phone while automating responses through n8n. The system acts as a bridge between WhatsApp's web interface and your automation workflows.
Cost comparison: Meta's Business API charges $0.005-$0.08 per message (1000 messages = $50-$80), while Evolution API has no per-message fees - just your server hosting costs (~$24/month for 8GB RAM). For businesses sending 5000+ messages monthly, this saves $250-$400/month.
Key Advantages Over Official WhatsApp API
- No message limits: Send unlimited messages without template approvals
- Group messaging: Automate responses in WhatsApp groups (prohibited by Meta's API)
- Keep personal use: Continue using your number normally on your phone
- AI integration: Connect advanced n8n workflows with LLM agents
- Multi-number support: Manage 50-100+ numbers from one dashboard
Step 1: Digital Ocean Server Setup
The first roadblock many hit is server requirements - Evolution API needs self-hosting, but the process is simpler than most expect. Digital Ocean provides the most straightforward hosting solution with one-click deployment.
At the 4:30 mark in the video tutorial, you'll see the exact droplet configuration used. While the minimum 2GB RAM ($12/month) plan works, we recommend the 4GB ($24) or 8GB ($48) options for better performance, especially if running n8n on the same server.
Server Configuration Checklist
- Create Digital Ocean account (use this link for $100 free credits)
- Choose Bangalore (Asia) or Frankfurt (Europe) data centers for best latency
- Select "EasyPanel" from Marketplace during droplet creation
- Set root password and hostname (e.g., whatsapp-automation)
- Configure firewall rules to allow ports 3000-3001 (Evolution API) and 5678 (n8n if hosted)
Pro Tip: If the EasyPanel fails to load after setup (common firewall issue), go to Networking → Firewalls and add rules for SSH (TCP), HTTP/HTTPS, and ports 3000-3001 before reassigning the firewall to your droplet.
Step 2: Installing Evolution API
With your server ready, installation takes just minutes through EasyPanel's template system. At 7:15 in the video, you'll see the exact steps to deploy Evolution API with zero command line work.
The process involves creating a new project in EasyPanel, searching for the Evolution API template, and clicking deploy. Once all services show green status (may take 2-3 minutes), you'll access the Evolution API manager at your droplet's IP on port 3000.
Post-Installation Configuration
- API Key: Found in Environment → Authentication Key (save this for n8n setup)
- Webhooks: Enable "webhook global" in environment variables if using n8n integration
- Domains: Note your server URL (without trailing slash) for n8n configuration
At this point, you should see the Evolution API dashboard when visiting your server's IP:3000. The interface will be empty until you connect your first WhatsApp number in the next step.
Step 3: Connecting Your WhatsApp Number
The moment of truth - linking your actual WhatsApp number to the automation system. This works similarly to pairing WhatsApp Web, just with more control and integration possibilities.
At 12:40 in the tutorial, you'll see the QR code generation process. Key points: create your instance name without spaces (e.g., "main-business") and don't enter the phone number initially - let the QR scan handle that automatically.
QR Scan Troubleshooting: If your phone shows "logging in" indefinitely after scanning (common issue), try this sequence: 1) Scan QR, 2) Wait 5 seconds, 3) Close QR window in browser, 4) Force quit WhatsApp on phone, 5) Reopen WhatsApp. This resolves a connection/disconnection loop bug.
Verifying Successful Connection
- Check Evolution API dashboard shows your number under "Instances"
- Verify WhatsApp → Linked Devices shows your server as connected
- Send a test message to confirm receipt in Evolution API's message log
Remember: This number remains fully usable on your phone - Evolution API simply mirrors the web interface functionality for automation purposes.
Step 4: n8n Integration & Configuration
Now for the powerful part - connecting Evolution API to n8n to build intelligent workflows. At 18:20 in the video, you'll see the community node installation process that enables this integration.
The key components are: 1) Installing the "n8n-nodes-evolution-api" community node, 2) Configuring the server URL and API key connection, 3) Setting up triggers for incoming messages.
Critical n8n Setup Steps
- Go to Settings → Community Nodes
- Install "n8n-nodes-evolution-api" package
- Add Evolution API credentials (server URL + API key)
- Set instance name to match your Evolution API dashboard
- Enable "message received" and "chat created/updated" events
Webhook Backup: If the community node fails (happens occasionally), set up a webhook in n8n and configure Evolution API to send events to it. Enable "webhook global" in Evolution's environment variables and point it to your n8n webhook URL.
Step 5: Adding an AI Agent for Automated Responses
The real magic happens when you connect an LLM to handle conversations. At 22:50 in the tutorial, you'll see how to add an OpenAI agent that responds to customer queries with contextual awareness.
This setup uses n8n's OpenAI node to process incoming WhatsApp messages through GPT-3.5/4, crafting responses based on your business rules before sending them back via Evolution API.
Building Your AI Support Agent
- Add OpenAI node after the message trigger
- Create system prompt defining your agent's role and boundaries
- Extract sender number using JSON expression:
{{$node["Evolution API"].json["sender"]}} - Connect Evolution API "Send Text" node to deliver responses
- Format phone number by removing "@s.whatsapp.net" suffix
The result? An AI agent that handles routine customer queries 24/7, escalates complex issues to humans, and maintains consistent brand voice across all WhatsApp communications.
Common Issues & Troubleshooting
Even with perfect setup, you might encounter occasional hiccups - especially since this interacts with WhatsApp's unofficial web interface. Here are solutions to the most frequent problems.
Message Delivery Failures: If messages stop sending, first check your WhatsApp phone has internet. Evolution API mirrors your phone's connection - if it's offline, the automation stops working until reconnected.
Quick Fixes for Common Problems
- QR code not scanning: Try incognito mode, different browser, or mobile hotspot
- Messages not triggering n8n: Verify webhook global is "true" in Evolution environment
- Connection drops: Re-scan QR code and restart both Evolution API and n8n
- Rate limiting: Stay under 50 messages/hour/number to avoid bans
Remember: This isn't an official WhatsApp product. Occasional breaks happen when Meta changes their web interface, but the active Evolution API community usually releases patches within 24-48 hours.
Watch the Full Tutorial
While this guide covers the key steps, seeing the process in action helps - especially for troubleshooting moments like QR scanning issues (demonstrated at 14:30) and n8n node configuration (18:20 mark).
Key Takeaways
WhatsApp automation doesn't have to mean expensive per-message fees or limited template approvals. Evolution API combined with n8n creates a powerful alternative that puts you in control of your messaging workflows.
In summary: 1) Evolution API automates WhatsApp Web with no per-message costs, 2) n8n provides the brain for intelligent response handling, 3) Together they enable AI customer support, group moderation, and CRM integration - all through WhatsApp's familiar interface.
The setup requires some technical steps, but the long-term savings and capabilities far outweigh the initial effort. For businesses sending 1000+ messages monthly, this solution can save $500-$1000+ compared to Meta's official API.
Frequently Asked Questions
Common questions about this topic
Evolution API is an open-source solution that automates WhatsApp Web functionality without per-message fees. Unlike Meta's official API which charges for each message and requires template approval, Evolution API lets you send unlimited messages through WhatsApp Web with no restrictions on content.
The key difference is Evolution API doesn't require converting your number to a business account, allowing you to continue using the same number on your phone. It essentially creates an automated version of WhatsApp Web that integrates with tools like n8n.
- No per-message fees (vs $0.005-$0.08/message with Meta)
- Works with personal/business numbers without conversion
- Allows group messaging automation (prohibited by Meta's API)
Combining Evolution API with n8n creates a powerful automation system where n8n serves as the brain handling complex logic. You can connect multiple WhatsApp numbers (50-100+) to a single dashboard, build AI-powered customer support bots without template restrictions, and automate group moderation tasks.
Unlike Meta's API which prohibits group messaging, Evolution API allows you to monitor and automate responses in WhatsApp groups. The integration with n8n enables advanced workflows like routing messages based on content, integrating with CRMs, and creating AI agents that handle 80% of routine inquiries automatically.
- Build unlimited custom automations without template approval
- Create AI agents that understand context and conversation history
- Integrate WhatsApp with 300+ other apps through n8n
For basic Evolution API functionality, a Digital Ocean droplet with 2GB RAM works, but we recommend starting with at least 4GB ($24/month plan) for better performance. If planning to run additional services like n8n or chatbot interfaces on the same server, opt for 8GB or higher.
The Bangalore data center provides good latency for Asian users, while European/American businesses should choose locations closest to their customer base. Storage needs are minimal (25GB SSD suffices), but CPU should be at least 2 vCPUs for smooth operation during message spikes.
- Minimum: 2GB RAM, 1 vCPU ($12/month)
- Recommended: 4GB RAM, 2 vCPUs ($24/month)
- High-volume: 8GB+ RAM, 4 vCPUs ($48+/month)
If your phone shows 'logging in' indefinitely after scanning the QR code, first ensure your phone has stable internet. If the issue persists, try this sequence: 1) Scan QR code, 2) Wait 5 seconds, 3) Close the QR window in your browser, 4) Force quit WhatsApp on your phone, 5) Reopen WhatsApp.
This resolves a common connection/disconnection loop bug. Also verify firewall settings allow ports 3000-3001 for Evolution API traffic. If problems continue, try scanning from a different network (mobile data vs WiFi) or reinstalling WhatsApp on your phone.
- 90% of issues solved by the 5-second close method
- Check firewall allows ports 3000-3001 inbound
- Try different browsers if QR won't display properly
The main risk is potential account banning since Evolution API isn't officially sanctioned by Meta. To minimize risk, limit messages to 30-50/day per number initially. Avoid spammy behavior and don't send identical messages to multiple recipients.
You won't get the green verification badge available through Meta's API, and group management features may occasionally break when WhatsApp updates its interface. However, the Evolution API community is very active, usually releasing patches within 24-48 hours of WhatsApp changes.
- Account banning risk if sending spammy content
- No official support (community-driven fixes)
- Occasional breaks during WhatsApp updates
If the Evolution API community node fails, set up a webhook in n8n and configure Evolution API to send events to it. In Evolution API's environment settings, enable 'webhook global' and set it to true. Configure the webhook URL in n8n to receive chat events.
Key events to enable include 'on chat created', 'message upsert', and 'chat set'. This alternative method ensures message delivery even if the native node has issues. The webhook will receive JSON payloads containing message details that you can process in n8n.
- Works when community node has compatibility issues
- Requires enabling webhook in Evolution environment
- Delivers same data just through different channel
This integration enables several powerful automations: 1) AI customer support bots that handle FAQs 24/7, 2) Lead qualification systems that route inquiries to CRM, 3) Group moderators that enforce community rules, 4) Notification systems for appointments/payments, 5) Two-way communication bridges between WhatsApp and other platforms like email or Slack.
The n8n workflow allows conditional logic based on message content, sender, and timing. You can build workflows that escalate complex queries to humans, send follow-up messages after delays, or even process payments through WhatsApp by connecting to payment gateways.
- AI agents handling 80% of routine inquiries
- CRM integration (HubSpot, Salesforce, etc.)
- Payment processing through WhatsApp messages
GrowwStacks helps businesses implement WhatsApp automation solutions using Evolution API and n8n. Our team handles server setup, API configuration, n8n workflow design, and AI agent training specific to your use case.
We ensure proper rate limiting to prevent account bans and can integrate with your existing CRM or helpdesk systems. Book a free consultation to discuss automating your WhatsApp communications while avoiding Meta's per-message fees.
- Complete Evolution API server setup
- Custom n8n workflows for your business needs
- AI agent training with your brand voice and knowledge base
Ready to Automate Your WhatsApp Communications?
Stop paying per-message fees for basic customer interactions. Let us build you a custom WhatsApp automation system that handles inquiries 24/7 while integrating with your existing tools.