Easy Tech Tuts
WhatsApp

How to Connect WhatsApp to n8n, Link, Use & Trigger it Easily 2026

By Impran M NLast checked against official docs

Connecting WhatsApp to n8n turns your automation canvas into a two-way messaging hub. You can fire outbound notifications and, just as importantly, react the moment a customer replies. n8n ships an official WhatsApp Business Cloud integration alongside a long list of third-party alternatives, and picking the right one up front saves you from re-wiring credentials later. This guide walks through starting a fresh workflow, finding the right node, setting up both the trigger and the reply credential, and the webhook limitation that catches people mid-build.

Before you start

  • A Meta developer account with a WhatsApp Business Cloud API app already set up, including a connected WhatsApp Business phone number
  • An n8n instance, cloud or self-hosted, where you can create and activate workflows

01Start a new workflow

From your n8n Overview screen, click Create workflow to open a blank canvas. Two options sit in the center of the empty editor: Add first step manually, or let n8n's Build with AI assistant scaffold something for you. For a WhatsApp integration where you want full control over credentials and trigger behavior, adding the first step manually is the more predictable route.

A brand-new, empty n8n workflow canvas with the option to add a first step manually or build with AI.
A brand-new, empty n8n workflow canvas with the option to add a first step manually or build with AI.

02Search for the WhatsApp node

Click Add first step and type "whatsapp" into the trigger search. n8n surfaces the official WhatsApp Business Cloud trigger at the top of the list, followed by community-built alternatives, Z-API, SyncMate, AllSign, YCloud, Hyperflow, GREEN-API, and others, each with its own setup and pricing outside of n8n. Unless you have a specific reason to use one of the third-party options, the official WhatsApp Business Cloud node is the one to pick, since it talks directly to Meta's API instead of through an intermediary service.

Searching "whatsapp" in the trigger picker surfaces the official WhatsApp Business Cloud node plus several third-party alternatives underneath it.
Searching "whatsapp" in the trigger picker surfaces the official WhatsApp Business Cloud node plus several third-party alternatives underneath it.

03Configure the WhatsApp Trigger node

Once it's on the canvas, open the WhatsApp Trigger node's parameters. Trigger On defaults to Messages, which fires the workflow whenever a new inbound chat arrives; n8n also lists nine other event types here (Account Update, Account Review Update, Business Capability Update, Message Template Status Update, Message Template Quality Update, Phone Number Name Update, Phone Number Quality Update, Security, and Template Category Update), useful for reacting to template approvals or account changes instead of chat messages. The node also flags a real constraint: WhatsApp only allows one registered webhook per connected Meta app. n8n's own docs note that activating a test workflow and a production workflow on the same app overwrites each other's webhook registration, so plan for one trigger per app instead of discovering the conflict mid-build.

The WhatsApp Trigger node's settings, with Trigger On set to Messages and a note about the one-trigger-per-app limitation.
The WhatsApp Trigger node's settings, with Trigger On set to Messages and a note about the one-trigger-per-app limitation.

04Set up your credential

Click Set up credential to open the WhatsApp OAuth account dialog. This trigger credential needs a Client ID and Client Secret, not a simple API key: both come from your Meta app's App settings > Basic page, where the App ID becomes the Client ID and the App Secret becomes the Client Secret.

That app needs to already exist and be configured on Meta's side before this step will work. Enterprise-plan users can pull these from an external vault instead of pasting them directly.

The WhatsApp OAuth credential dialog, requiring a Client ID and Client Secret from your Meta developer app.
The WhatsApp OAuth credential dialog, requiring a Client ID and Client Secret from your Meta developer app.

05Add an outbound WhatsApp node for replies or notifications

With the trigger catching inbound messages, add a separate WhatsApp Business Cloud node further down the canvas to send messages back out, either a pre-approved template for the first contact with a customer, or a free-text reply within the window Meta allows after they've messaged you. This node takes a different credential type from the trigger: an API Key built from an Access Token and a Business Account ID, generated in the Meta app under WhatsApp > API Setup > Generate access token.

That's not the Client ID and Secret the trigger uses, so the two credentials can't be swapped for each other. Map dynamic fields, like a customer's name or order number, into the message body so replies read as personal instead of canned.

06Test with your own number before going live

Save the workflow, activate it, and send a test message from your own phone to the connected WhatsApp Business number. Confirm the trigger fires with the data you expect, then confirm any outbound message arrives. Because production and test workflows fight over the same webhook, n8n suggests unpublishing the production workflow while you test with the test webhook URL, then republishing once you're done, instead of running both at once.

When it doesn't work

The trigger stopped firing after I activated the production workflow, or after testing

Why: WhatsApp registers only one webhook per Meta app, so activating a workflow overwrites whichever webhook, test or production, was registered before it.

Fix: Unpublish the production workflow while testing with the test webhook URL, then republish it once testing is done, instead of running both at once.

The outbound WhatsApp node fails even though the trigger works fine

Why: The two node types use different credentials. The Trigger takes OAuth2 (Client ID and Secret from the Meta app's Basic settings); the WhatsApp Business Cloud action node takes an API Key (Access Token and Business Account ID from WhatsApp > API Setup).

Fix: Create and attach the API Key credential to the outbound node instead of reusing the trigger's OAuth2 credential.

n8n won't let me add a second WhatsApp Trigger

Why: Meta's API limits a connected app to one registered webhook, and n8n enforces one active WhatsApp Trigger per app as a result.

Fix: Route different behaviors through IF or Switch nodes downstream of a single trigger instead of adding a second one.

FAQ

Frequently asked questions

Do I need a WhatsApp Business account to use this integration?

Yes, you need a Meta developer app connected to a WhatsApp Business Cloud API setup, which supplies the Client ID and Client Secret n8n's OAuth credential requires.

Can I send free-form messages to any customer?

Generally only within a limited response window after a customer messages you first. Meta doesn't charge for those in-window replies; outside the window you need an approved, and billable, message template.

How do I trigger a workflow from an incoming WhatsApp message?

Add the official WhatsApp Trigger node, set Trigger On to Messages, and connect its credential. It fires automatically whenever a new inbound chat arrives.

Can I have more than one WhatsApp trigger running?

Not on the same Meta app. WhatsApp allows only one registered webhook per app, so n8n can run only one active WhatsApp Trigger per connected app at a time.

Does sending WhatsApp messages through n8n cost anything?

n8n doesn't add its own fee for the nodes. Meta bills separately, per delivered template message since July 2025, with the rate depending on the template category and the recipient's country. Non-template replies inside the 24-hour window are free.

Should I test with my own number before going live?

Yes. Testing the full send-and-receive path with a personal number first catches credential or formatting problems before a broadcast reaches real customers.

Sources and last check

Click path and screens come from a walkthrough recorded in July 2025. The trigger's event list, the one-webhook-per-app limitation, the separate credential types for the Trigger versus the outbound node, and current Meta message pricing were re-checked against n8n's official docs and Meta's developer pricing page in September 2026. The webhook conflict and the second credential type were missing from the original guide.

About the author

Impran M N
Written by

Impran M N

I've been hooked on technology for as long as I can remember — especially the new tools and AI apps that seem to land every other week. Easy Tech Tuts is where I write up whatever I've just worked out: I do the task in the real product, record the screen, and turn it into the guide I wish I'd found first.