Package Exports

n8n-nodes-zalo-bot-official
n8n-nodes-zalo-bot-official/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-zalo-bot-official) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

n8n Zalo Bot Community Node

Developed and maintained by Jay Nguyen (Nguyễn Thiệu Toàn).

🛡️ Verified n8n Creator | 💼 CEO/Founder of GenStaff

Connect with me:

This is an n8n community node that integrates the Zalo Bot Platform into your n8n workflows. It allows you to send text messages (supporting rich text formats), photos, stickers, voice messages, chat actions, retrieve bot information, and trigger workflows dynamically on real-time webhook events from Zalo.

Features

Zalo Bot Action Node:
- Message Resource:
  - Send Text Message: Supports Markdown or HTML parse modes for rich text formatting.
  - Send Photo: Send photos via public URLs with custom captions.
  - Send Sticker: Send expressive stickers using official Zalo Sticker IDs.
  - Send Voice Message: Send audio recordings (.aac format) to 1-1 user chats.
  - Send Chat Action: Simulates user action indicators (e.g., typing).
- Bot Info Resource:
  - Get Info: Validates credentials and fetches details about the configured Bot.
Zalo Bot Trigger Node (Webhook):
- Automates webhook registration and lifecycle events.
- Implements SHA256 webhook security validation checks (x-bot-api-secret-token).
- Implements auto-healing URL comparisons.
Zero Runtime Dependencies: Strict packaging conformance prevents bundle bloat or runtime collision.

Installation

For Self-Hosted n8n Instance

In your self-hosted n8n instance directory, run:

npm install n8n-nodes-zalo-bot-official

Or use the Community Nodes menu in your n8n settings dashboard:

Go to Settings > Community Nodes.
Click Install a Node.
Type: n8n-nodes-zalo-bot-official
Accept and install.

Credentials

To authenticate your node, you will need a Bot Token from the Zalo Bot Manager.

Bot Token: A long-lived token structured as {bot_id}:{secret_key}.

Local Development & Compilation

Requirements

Node.js v22.22.0+
npm

Steps

Clone this repository:

git clone https://github.com/nguyenthieutoan/n8n-nodes-zalo-bot-official.git
cd n8n-nodes-zalo-bot-official

Install dependencies:
```
npm install
```
Build the node:
```
npm run build
```

Local Verification using Docker Compose

A compose.yaml file is provided in the repository to mount your compiled output directory directly into a local n8n instance for testing:

Compile your TS files:
```
npm run build
```
Launch n8n using Docker Compose:
```
docker compose up -d
```
Open http://localhost:5678 in your browser, configure your credentials, and start adding Zalo Bot nodes to your workflows!

License

MIT