Note
This is an unofficial Zalo API for personal account. It work by simulating the browser to interact with Zalo Web.
Warning
Using this API could get your account locked or banned. We are not responsible for any issues that may happen. Use it at your own risk.
bun install zca-js # or npm install zca-jsSee API Documentation for more details.
import { Zalo } from "zca-js";
const zalo = new Zalo();
const api = await zalo.loginQR();import { Zalo, ThreadType } from "zca-js";
const zalo = new Zalo();
const api = await zalo.loginQR();
api.listener.on("message", (message) => {
const isPlainText = typeof message.data.content === "string";
switch (message.type) {
case ThreadType.User: {
if (isPlainText) {
// received plain text direct message
}
break;
}
case ThreadType.Group: {
if (isPlainText) {
// received plain text group message
}
break;
}
}
});
api.listener.start();Important
Only one web listener can run per account at a time. If you open Zalo in the browser while the listener is active, the listener will be automatically stopped.
import { Zalo, ThreadType } from "zca-js";
const zalo = new Zalo();
const api = await zalo.loginQR();
// Echo bot
api.listener.on("message", (message) => {
const isPlainText = typeof message.data.content === "string";
if (message.isSelf || !isPlainText) return;
switch (message.type) {
case ThreadType.User: {
api.sendMessage(
{
msg: "echo: " + message.data.content,
quote: message, // the message object to reply to (optional)
},
message.threadId,
message.type, // ThreadType.User
);
break;
}
case ThreadType.Group: {
api.sendMessage(
{
msg: "echo: " + message.data.content,
quote: message, // the message object to reply to (optional)
},
message.threadId,
message.type, // ThreadType.Group
);
break;
}
}
});
api.listener.start();api.getStickers("hello").then(async (stickerIds) => {
// Get the first sticker
const stickerObject = await api.getStickersDetail(stickerIds[0]);
api.sendMessageSticker(
stickerObject,
message.threadId,
message.type, // ThreadType.User or ThreadType.Group
);
});See examples folder for more details.
- ZaloDataExtractor - ZaloDataExtractor là công cụ trích xuất thông tin cần thiết như IMEI, Cookie và User-Agent từ Zalo Web.
- MultiZlogin - Hệ thống quản lý đa tài khoản Zalo, hỗ trợ đăng nhập và quản lý nhiều tài khoản Zalo cùng lúc, tích hợp proxy và webhook.
- n8n-nodes-zalo-tools - N8N node cho Zalo cá nhân.
We welcome contributions from the community! Please see our Contributing Guidelines for details on how to:
- 🐛 Report bugs and issues
- ✨ Suggest new features
- 🔧 Submit code contributions
- 📚 Improve documentation
- 🧪 Add or improve tests
- 🔒 Report security vulnerabilities
For more information, please read our Code of Conduct and Security Policy.
This project is licensed under the MIT License - see the LICENSE file for details.