Automating WhatsApp used to mean choosing between two bad options: wrestle with Meta's official Business API — business verification, template approval, per-message billing — or duct-tape a browser extension that breaks every other week. There's now a middle path: a session-based WhatsApp API wired into n8n, the open-source workflow automation tool. Here's what that setup actually looks like, what you can build with it, and where each approach makes sense.
n8n is a visual workflow builder. You drag nodes onto a canvas, connect them, and the workflow runs — on a schedule, on a webhook, or on an event from another app. It talks to hundreds of services, and it can be self-hosted for free.
WhatsApp is where a huge share of customer conversations already happen. Open rates dwarf email. The hard part has always been programmatic access: getting messages into your automation stack and replies back out.
Connect the two and any n8n workflow becomes a WhatsApp sender, receiver, or AI agent — with no backend to write and no server to babysit.
Before the how-to, be clear about the trade-off — most articles gloss over it.
| Meta WhatsApp Cloud API (official) | Session-based API (e.g. SimpleWA) | |
|---|---|---|
| Setup time | Days to weeks (business verification) | Minutes — scan a QR / pairing code |
| Message templates | Required for business-initiated messages | Not required — free-form send & receive |
| Pricing model | Per delivered message (+ possible provider fees) | Typically a flat monthly plan |
| Group messaging | Not supported | Supported |
| Official status | Official Meta product | Unofficial / independent |
| Best for | Enterprise brands needing official status & template marketing at scale | Developers, SaaS, agencies, internal tools that need speed |
The honest summary: if you're a regulated enterprise doing template-based marketing at scale, use Meta's official API. If you're a developer or a small team that needs a working WhatsApp integration this week, a session-based API is dramatically faster — with the trade-off that it's unofficial, so responsible, opt-in messaging matters a lot more.
SimpleWA publishes an n8n community node. In n8n, open Settings → Community Nodes → Install and enter the package name:
n8n-nodes-simplewaPrefer the command line? Install it manually, then restart n8n:
cd ~/.n8n/custom
npm install n8n-nodes-simplewaThe node handles three things: sending WhatsApp messages, managing sessions, and registering webhooks.
Copy your API key from the provider's dashboard. In n8n, add any WhatsApp node to a workflow, create a new credential from it, paste the key, and save. You should see the connection succeed.
Keep this key private — it's what authorizes messages to be sent from your number.
Sending is only half of it. To react to incoming messages, you need a webhook.
Now every incoming message — plus delivery receipts, read receipts, and session disconnects — pushes into n8n in real time. A typical payload:
{
"event": "message.received",
"from": "1555XXXXXXX",
"type": "text",
"text": { "body": "Hi, is anyone there?" },
"timestamp": 1751808000
}Add the Send Message node, map the recipient into the to field and your text into the message body, then hit Execute. Check your phone — it should land within a second or two.
That's the entire foundation: trigger in, send out. Everything below is built on those two nodes.
Trigger → Switch node (branch by keyword) → Send. Ten minutes of work, and your common questions start answering themselves.
The one most people are after. Wire the trigger into n8n's AI Agent node, attach a chat model and a memory node keyed by the customer's phone number, then send the output back through WhatsApp:
[Trigger] → [AI Agent + Chat Model + Memory] → [Send Message]Give the agent a tight system prompt (role, tone, length limit), and add an IF branch that escalates low-confidence answers to a human via Slack or email. There's a full step-by-step n8n integration guide if you want the detailed version.
Shopify or WooCommerce trigger → format the message → send. Customers get "your order shipped" on WhatsApp instead of an email they'll never open.
An AI agent extracts the requested time, a Google Calendar node checks free/busy, the workflow books the slot and confirms — then a scheduled workflow fires reminders 24 hours out.
Read rows, loop, personalize with each row's values, and send. A spreadsheet becomes a no-code sender.
Session-based WhatsApp numbers are more sensitive than official API numbers. A few rules keep yours healthy:
200 immediately, then do the heavy AI work asynchronously so nothing times out or double-fires.Yes. n8n's builder is drag-and-drop, and the WhatsApp node exposes send and trigger operations as configurable fields. You can build an auto-reply bot — or even an AI agent — without writing code.
Not with a session-based API. You link an existing WhatsApp number by scanning a QR or pairing code, so there's no business verification and no message-template approval. Meta's official Cloud API requires both.
n8n is free to self-host (n8n Cloud has paid tiers). Session-based WhatsApp APIs typically charge a flat monthly fee rather than per message — SimpleWA's entry plan starts around $8/month — while Meta's Cloud API bills per delivered message.
Yes. Attach a memory node keyed by the customer's phone number. A window of around 10 messages balances useful context against token cost; clear it after 24 hours of inactivity.
It can — if you spam. Bans come from spam reports and unsolicited blasts, not from automation itself. Opt-in contacts, paced sending, personalized content, and easy opt-out keep a number healthy.
If you need WhatsApp inside your automation stack and you don't want to spend two weeks in Meta's verification queue, a session-based API plus n8n gets you from zero to a working two-way integration in an afternoon. Install the node, add a key, connect a webhook, send. From there the same connection powers auto-replies, AI agents, order updates, and booking flows.
Just remember the trade-off you're accepting: speed and simplicity in exchange for unofficial status. Message people who actually want to hear from you, and it holds up well.
Send your first WhatsApp message from n8n in minutes.
Try SimpleWA freeDisclosure: this guide references SimpleWA, an independent session-based WhatsApp API. It is not affiliated with WhatsApp Inc. or Meta.