Automate WhatsApp with n8n

ZapWhat ships a free community node for n8n. Send and receive WhatsApp messages, manage contacts and groups, and plug any AI model into your flows — without writing code.

Open source (MIT) community node, maintained by ZapWhat.

Ready in three steps

1

Install the node

Go to Settings → Community nodes, install n8n-nodes-zapwhat and restart n8n once. On Docker you can instead run npm install n8n-nodes-zapwhat inside the container.

2

Connect your account

Create a ZapWhat API credential with your instance ID and API token. The Test button confirms the connection by listing your instances.

3

Build your flow

Add the ZapWhat action node or the ZapWhat Trigger to any workflow. Every WhatsApp message becomes an n8n item you can filter, enrich or answer.

What the node does

Send anything

Text, images, video, audio, documents, stickers, contact cards and locations, including quoted replies.

React in real time

The ZapWhat Trigger receives every incoming message through your own webhook and starts the workflow instantly.

Contacts and groups

List, sync, block or unblock contacts, fetch profile pictures and manage group participants.

Add your own AI

Connect OpenAI, Anthropic or any LLM node to answer customers in their own language, without a custom backend.

Three recipes to start

Recreate these flows node by node. The ZapWhat node labels are in Spanish for now; every operation maps to the API reference on this site.

1. Automatic replies with AI

Every incoming message goes through a language model and the answer is sent back to the same chat, quoting the original message.

ZapWhat Trigger → AI Agent / Basic LLM Chain → ZapWhat · Mensaje · Enviar texto
  1. Use the ZapWhat Trigger with the incoming event and ignore messages where fromMe is true, otherwise the workflow answers itself.
  2. Add an AI node (OpenAI, Anthropic or the AI Agent) and paste the prompt below as the system message.
  3. Reply with ZapWhat · Mensaje · Enviar texto: to = {{ $json.from }} and replyTo = {{ $json.messageId }}.
You are a WhatsApp support agent. Answer in the same language the customer used, in 60 words or fewer. Never invent prices, stock or delivery dates: when you do not know, reply "Te paso con un asesor" and stop. Do not use markdown, emojis or links unless the customer asks for them.
The message text leaves your server and goes to your AI provider: review your privacy policy and add a human fallback when the model is unsure. Keep answers short — WhatsApp is a chat, not email.

2. Route messages without AI

Use the WhatsApp message category or simple keywords to send each message down a different branch of the workflow.

ZapWhat Trigger → Switch → Enviar texto / Enviar archivo / Contacto · Sincronizar
  1. Switch on {{ $json.category }} to separate text, image, audio, document and group events.
  2. Inside the text branch use the expression below to tag price, schedule or support questions.
  3. Save leads with ZapWhat · Contacto · Sincronizar using phone = {{ $json.from }}.
{{ $json.text.toLowerCase().includes('precio') ? 'pricing' : ($json.text.toLowerCase().includes('horario') ? 'hours' : 'other') }}
Keywords are free, predictable and instant: use them before paying for a model call.

3. Notifications from your own system

Start the flow from your ERP, your CRM or a schedule and deliver the message to a number or a group.

Webhook / Schedule Trigger → Número · Verificar número → ZapWhat · Mensaje
  1. Check the recipient first with Número · Verificar número and skip numbers that are not on WhatsApp.
  2. Send text, a document (an invoice PDF, for example) or a location with the Mensaje resource.
  3. For groups use the group JID as destination, for example [email protected].
# Your own system calls the n8n webhook POST https://your-n8n.example.com/webhook/zapwhat-notify { "to": "5215512345678", "text": "Tu pedido está listo" }
The ZapWhat Trigger listens on one fixed path, so keep a single instance per workflow and route several numbers with a Switch.

Download the templates

Import the JSON files in n8n (Workflows → Import from file), type your instance ID into the ZapWhat node and select your ZapWhat API credential.

Templates are plain n8n workflow exports and never include credentials or API tokens.

Frequently asked questions

Do I need my own server?

For now, yes: community nodes are installed on a self-hosted n8n (Docker, VPS or your own machine). n8n Cloud only accepts verified nodes and this package is not verified yet.

How much does the n8n node cost?

The node is free and open source. You only pay your ZapWhat plan, which includes the API, webhooks and as many instances as your plan allows.

Which n8n versions work?

Any recent n8n 1.x release with community nodes enabled, on a self-hosted installation. Node.js 20.15 or newer is required.

Connect WhatsApp to n8n today

Create your ZapWhat account, copy your instance ID and API token, and your first workflow is minutes away.

Create free account