n8n has no built-in Zalo node: n8n’s integrations documentation lists none. Zalo community nodes fall into two groups that work very differently: nodes for the official Zalo Bot Platform, which use a bot token, and nodes that automate a personal Zalo account by simulating Zalo Web, mostly with the unofficial zca-js library. Several READMEs of the second group warn that this breaks Zalo’s terms and can get the account locked. Most READMEs are in Vietnamese, so this guide sums them up in English, using the description and README each author publishes on npm and our own download data.
Official bot or personal account?
| Zalo Bot Platform nodes | Personal account nodes | |
|---|---|---|
| How they connect | Official API with a bot token | Simulate Zalo Web with your personal login (QR code or cookies) |
| What you can do | Receive messages, send messages, photos and stickers as a bot | Almost everything your account can: chats, groups, friends, polls and more |
| Risk | Official API, no README warns of account locks | READMEs warn it breaks Zalo’s terms and can get the account locked |
Zalo community nodes
Our Zalo hub lists 47 packages that pass our quality rule, with 1,417 npm downloads a week between them. The most downloaded packages still on npm, with the description each author gives there (weekly npm downloads as of 28 October 2026):
| Package | Weekly downloads | Latest version | Type | Author’s description, in English |
|---|---|---|---|---|
| n8n-nodes-zalo-tools | 228 | 0.6.1 (7 April 2026) | Personal | Zalo support nodes for n8n |
| n8n-nodes-zalo-nnt | 110 | 1.3.0 (10 August 2026) | Personal | Unofficial Zalo integration: messages, groups and users with QR login, no API key |
| n8n-nodes-zalo-platform | 100 | 2.2.0 (14 October 2026) | Bot | Zalo Bot Platform: send messages, photos and stickers, manage webhooks |
| n8n-nodes-zalo-gemazo | 68 | 0.10.64 (29 August 2026) | Both | Personal account (zca-js) and the official Zalo Bot Platform |
| n8n-nodes-zalo-tokado | 49 | 0.4.29 (7 October 2026) | Personal | Zalo personal account automation with a message trigger, QR login, friends and groups, using zca-js |
Versions and dates come from the npm registry. Weekly downloads: npm, last 7 days, adjusted for npm outage days. The hub’s most downloaded entry, n8n-nodes-zalo-custom, has been unpublished from npm, so it can no longer be installed and isn’t covered here.
n8n-nodes-zalo-platform (official Zalo Bot Platform)
Built on the Zalo Bot Platform with a bot token. A Zalo Bot Trigger receives messages through a webhook that the node registers with Zalo when the workflow is activated, checks with a secret token and removes again when it is deactivated. The Zalo Bot node sends messages, photos, stickers and chat actions, reads updates by long polling, and gets bot info or manages the webhook. Its README says it is verified by n8n, so it installs from the nodes panel on n8n Cloud as well.
n8n-nodes-zalo-gemazo (both)
Offers both routes side by side: two nodes for the official Zalo Bot Platform, which its README recommends for businesses (you create a bot through the Zalo Bot Manager account in the Zalo app and get a bot token), and nodes for a personal account through zca-js. For the personal side, the README warns that the API is unofficial, simulates Zalo Web, may violate Zalo’s terms and can lead to the account being locked, and advises testing with a secondary account.
Personal account packages
- n8n-nodes-zalo-tools: simulates a browser to work with Zalo Web from inside n8n, with no third-party API. Its README states that using the library goes against Zalo’s policy and can get your account disabled, and that the authors take no responsibility.
- n8n-nodes-zalo-nnt: messages, groups and users with a QR code login. Its README marks version 1.3.0 as a release candidate not yet tested on a real account, and flags the Official Account and business operations as carrying a higher policy risk than ordinary messaging.
- n8n-nodes-zalo-tokado: built on zca-js 2.2.0, with a Zalo Login By QR node that saves the credential for you and one trigger for all events (messages, reactions, friend requests, recalls). Its disclaimer says automating a personal account violates Zalo’s terms of service and that Zalo can lock the account permanently without warning.
Check each node page here for the latest release and, where it has one, its GitHub repository for open issues before you build on a package.
How to choose
- A business chatbot or auto-reply: the official Zalo Bot Platform, with n8n-nodes-zalo-platform or the bot nodes of n8n-nodes-zalo-gemazo.
- n8n Cloud: n8n-nodes-zalo-platform, which its README says is verified.
- Automating a personal account: only if you accept the risk the READMEs describe, and on a secondary account as they advise.
To install a package on a self-hosted instance, an owner or admin enters its npm name in Settings > Community Nodes; full steps are in How to Install n8n Community Nodes. On n8n Cloud only verified community nodes can be installed, see Verified vs Unverified n8n Community Nodes. Similar guides: Telegram and WhatsApp.
FAQ
Does n8n have a Zalo node?
Not a built-in one. Zalo support comes from community nodes, either for the official Zalo Bot Platform or for automating a personal account.
Can my Zalo account be locked if I automate it with n8n?
Several READMEs say so. n8n-nodes-zalo-tokado’s disclaimer says personal account automation violates Zalo’s terms and that Zalo can lock the account permanently without warning; n8n-nodes-zalo-tools and n8n-nodes-zalo-gemazo give similar warnings. The official Zalo Bot Platform avoids this by using a bot token.
How do I build a Zalo bot in n8n?
Create a bot through the Zalo Bot Manager account in the Zalo app to get a bot token, then use n8n-nodes-zalo-platform: its trigger receives messages through a webhook and its action node sends replies.
What is the most used Zalo community node?
Of the packages still on npm, n8n-nodes-zalo-tools, with 228 weekly npm downloads on 28 October 2026.
