royalgarter/Zalojs

an unofficial high-levels API for Zalo

About The Project

ZaloJS is a powerful high-level scraping API designed for accessing data from Zalo, a popular messaging platform in Vietnam. This versatile tool provides developers with the means to extract various types of data from Zalo, enabling them to build applications, gather insights, and automate tasks effectively.

Use Cases

• Chatbot Development: Develop chatbots capable of interacting with Zalo users, responding to messages, providing information, and executing tasks.

• Automated Workflows: Streamline repetitive tasks by automating actions within the Zalo client, such as sending notifications or gathering data.

Getting Started

Prerequisites

1. Prepare a Mobile Device: As Zalo imposes strict security measures, it's essential to have a mobile device ready for the setup process.

2. Installation: Install the Zalo.JS package by running

npm i zalojs@latest

Usage

const { init } = require('../dist/index.js');
const config = require('./config.json');
const Client = require('../dist/index.js').default;
const fs = require('fs');
const path = require('path');

const prefix = '!';

(async () => {
  const { browser, page } = await init({
    groupName: config.gname,
    groupSelector: config.gselector,
    headless: config.headless,
  });

  const client = new Client(page);

  client.on('message', async (message) => {
    console.log(message)
    if (!message.content.startsWith(prefix)) return;
    const args = message.content.slice(prefix.length).trim().split(/ +/);
    const commandName = args.shift().toLowerCase();

    try {
    if (command === 'ping') {
      await client.send({ message :'!Pong' });
    }
    } catch (error) {
      console.log(error);
      await client.send({ message :'There was an error executing the command.' });
    }
  });

  client.once('ready', () => {
    console.log('Bot is ready!');
  });
})();

Config File:

{
  "gselector": "your-group/user-selector", //#group-item-g5701541405487732670
  "gname": "your-group/user-name", //Testing
  "headless" : true //turn to true when production
}

3. Authentication: Upon running the program, a server will automatically start at http://localhost:3000. Next, use your mobile device to scan the QR code displayed on localhost:3000 using the Zalo app