November 16, 2026 · 9 min read

Connect Nod to WhatsApp: AI Agent by n8n

Graphic title card for the article “Connect Nod to WhatsApp: AI Agent by n8n” with a stylised motif: a computer with a terminal and a smartphone, connected by a dashed line with a padlock.
Graphic: HumanITy

You connect Nod to WhatsApp in the app under Channels: select Connect on WhatsApp, choose your own number or a second bot number, and scan the QR code with your phone under Linked Devices. According to n8n, you need neither a Meta developer account, nor an API token, nor a public address. From then on you send Nod texts, voice messages, photos and documents from WhatsApp, and Nod replies in the same chat. Three catches come with it: the QR connection runs through an unofficial WhatsApp client, with a small risk that WhatsApp restricts your account. Nod only replies while the computer running it is on and awake. And Nod only understands voice messages once a speech service with an API key or free local voices is set up; a ChatGPT or Claude subscription alone is not enough. Everything about Nod here comes from n8n's official docs and repository as of November 16, 2026.

On November 16, 2026, I connected Nod in the desktop app on my Mac to my own WhatsApp number and sent it a voice message and a text message. Nod replied to both in WhatsApp. What Nod is and how it works is explained in Nod by n8n: What the AI Agent Can Do, the installation in Install Nod: Set Up the AI Agent by n8n.

What you need

  • Nod running: as the desktop app on your computer or on your own server. The desktop app is available for Mac, and as a preview for Windows 11 and Linux.
  • A connected model. If you send a file before that, Nod only replies with a setup notice, according to the docs.
  • WhatsApp on your phone with a registered account.
  • For a bot number, a second number registered in WhatsApp or WhatsApp Business.
  • For voice messages, a speech service, more on that below.

You don't need a Meta developer account, an API token or a domain for the QR connection. It connects from the inside out, which is why it also works on a laptop.

Your own number or a separate bot number

Nod offers two ways. I took the simplest one, my own number. n8n recommends a separate bot number.

Your own number Separate bot number
Where you write to Nod in the “Message yourself” chat from your personal number to the bot number
Setup fastest, only your own account register a second number in WhatsApp or WhatsApp Business, then enter your personal number in Nod, with the country code and without plus sign or spaces
Who can give Nod tasks only you, in the chat with yourself only your personal number
Note Nod is a linked device on your account according to n8n, a separate bot number keeps your own chats safe

Either way, Nod ignores groups, status updates, other senders and message history, according to the docs. In the chat with yourself, Nod skips its own replies. Your other chats stay outside.

Connect Nod to WhatsApp step by step

  1. In Nod, open Channels in the sidebar and select Connect on WhatsApp.
  2. Choose Use my own number or Separate bot number. For a bot number, enter your personal number; only that number can start tasks.
  3. Read the note on account risk and terms, then select Show QR code. At this point Nod itself says that WhatsApp does not officially support this way.
  4. On the phone with the account you are linking, open WhatsApp settings, then Linked Devices, and link a new device. Scan the code in Nod. A code is valid for one minute and refreshes itself; the whole setup expires after five minutes.
  5. With your own number, open the chat with yourself and write there. With a bot number, write from your personal number to the bot number.

Once WhatsApp is connected, you can close the window and the connection stays. Nod keeps the device keys encrypted on your installation. You disconnect in Nod with Disconnect or on your phone under Linked Devices. If messages stop arriving, select Reconnect under Channels in Nod.

What you can send Nod on WhatsApp

WhatsApp is not a separate assistant in Nod but another way into the same conversation as in the app, with the same memory and the same tasks. Nod replies where you wrote; a schedule you set up in WhatsApp reports its results there too.

  • Texts and tasks, just like in the app.
  • Photos, documents, videos and audio, with or without a caption. If you reply directly to a task message from Nod or its file, Nod continues that task.
  • Forwarded messages. When customers send me an invoice or details on WhatsApp, I can forward them to my own chat and Nod processes them further, for example into an email draft or an appointment. The matching app has to be connected in Nod for that.

What never goes through WhatsApp: passwords, saved logins, app sign-ins and payment approvals. When a task needs such a step, Nod sends you to the app and then carries on in the chat. You approve an action by text; according to the docs, a file or voice message approves nothing. How Nod checks approvals and what it shares with whom is covered in Nod Privacy: What the AI Agent by n8n Shares.

Voice messages: what you need

For me this is a really exciting and very useful case: forward a five-minute voice message and Nod sends back the transcript. For that, Nod needs a speech service, which you set up under Settings → Voice & audio.

Option What you need What it costs
Free local voices download them in Voice & audio nothing per message; according to the docs, transcription stays local in your Nod installation
OpenAI, OpenRouter or ElevenLabs an account with an API key, or an OpenRouter sign-in usage-based with the provider; every call shows in Nod under Usage, with the price from OpenRouter and as an estimate for OpenAI
Only a ChatGPT or Claude subscription not enough for cloud speech, according to the docs

Without a speech service, Nod points you to Voice & audio and asks for text. Texts and files keep working. A single voice message can be up to 25 MB, according to the docs. What Nod costs with which model is covered in Nod Pricing: What the AI Agent by n8n Costs.

The catches

The QR connection is unofficial. According to the docs, it uses Baileys, an unofficial WhatsApp client. n8n itself writes that there is a small risk of WhatsApp restricting the account, and that a WhatsApp update can break the connection for a while. n8n advises reading the WhatsApp terms before connecting and writes that a separate bot number keeps your own chats safe. That is exactly why it can make sense to give Nod a second number, especially if your own number matters for your business.

Nod only replies while it runs. With the desktop app, Nod only replies in WhatsApp while it runs on an awake computer with internet. Closing the window is fine, Nod keeps running. If you quit the app or the computer goes to sleep, replies stop. Messages from that time may arrive after a restart, according to the docs, but Nod does not read old history; if no reply comes, send the message again. If Nod should be reachable around the clock, it belongs on your own server or a Mac mini, as in Nod Self-Hosted: AI Agent by n8n on Mac mini. For me, the benefits outweigh these two catches.

Voice messages need a speech service. With a ChatGPT or Claude subscription alone, Nod does not understand voice messages; you need local voices or an API key (see above).

The official way takes more effort. Instead of the QR code, you can connect WhatsApp through Meta's Cloud API. According to the docs, that needs a Meta app with WhatsApp, a business number and a public HTTPS address, meaning your own server or a proxy that exposes only the webhook. This way accepts text only, no voice messages, and replies only within 24 hours of your last message.

On top of that, Nod is a research preview according to n8n, so it is not finished. An alternative is Telegram: there you create your own bot with BotFather, and only your linked Telegram account can message it.

Frequently asked questions

Do I need WhatsApp Business or a Meta developer account?

Not for the QR connection. You only need a registered WhatsApp account. WhatsApp Business is one way to register a second number as a bot number. You only need a Meta developer account for the Cloud API route.

Does Nod read my other WhatsApp chats?

No. According to the docs, Nod ignores groups, status updates, other senders and message history. Nod only responds to your chat with yourself or, with a bot number, to your personal number.

Can WhatsApp block my account?

n8n names a small risk that WhatsApp restricts the account, because the connection runs through an unofficial client. With a separate bot number, your own chats stay safe, according to n8n.

Does Nod reply when my laptop lid is closed?

Only if the computer stays awake. With the desktop app: sleep or a closed app means no replies. For always-on use, Nod runs on your own server.

Does Nod understand voice messages with my ChatGPT subscription?

Not with the subscription alone. Download free local voices in Voice & audio or connect OpenAI, OpenRouter or ElevenLabs with an API key. With local voices, transcription stays local in your Nod installation.

What does Nod with WhatsApp cost?

Nod and the QR connection to WhatsApp are free. What counts is the model you connected and, for voice messages, the speech service: local voices cost nothing per message, an API service bills by usage.

How to continue

Start with something you already send to yourself on WhatsApp today: a note, a forwarded invoice, a long voice message. Connect Nod with a separate bot number if your WhatsApp number matters for your business, and set up local voices for voice messages. How I build AI employees with clear permissions and approvals is something I show in my community Claude Practitioners.

Kevin Welter

Kevin Welter

Developer, IT architect, author of technical books (Kubernetes, cloud infrastructures) and speaker. Runs his business with an AI workforce of fifteen AI employees and shows solo business owners in his community how to hire their first AI employee.

More about AI employees

Your first AI employee up and running within an hour

Join the community

$5/month founding price, first 50 members