ZAPI-JS

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.

Installation

``bash
bun install zapi-js # or npm install zapi-js
`

Basic Usages

$3

`javascript
import { Zalo } from "zapi-js";

const zalo = new Zalo();
const api = await zalo.loginQR();
`

$3

`javascript
import { Zalo, ThreadType } from "zapi-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();
`

Note: 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.

$3

`javascript
import { Zalo, ThreadType } from "zapi-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();
`

$3

`javascript
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
);
});
``

Example

See examples folder for more details.

Contributing

We welcome contributions from the community.

License

This project is licensed under the MIT License - see the LICENSE file for details.