jeast-whatsapp-api

Jeast Whatsapp API

A Simple whatsapp api that connects through the whatsapp web, that is used for all needs such as sending messages, and authenticating on whatsapp via qr code.

🚀 Installation

Type the npm command below to install the package

npm i jeast-whatsapp-api

Please note that Node v12+ is required.

⭕ Basic usage

const { Jeast } = require("jeast-whatsapp-api");

const client = new Jeast();

client.connect({
  logger: true,
  qr_terminal: true,
  headless: true,
  authState: {
    isAuth: true,
    authType: "multidevice",
    authId: "example_account",
  },
});

client.ev.qr(async (qr) => {
  if (qr) {
    console.log(qr);
  }
});

client.ev.connection(async (connection) => {
  if (connection.isConnected) {
    console.log("connected!");
  }
});

client.ev.message(async (message) => {
  if (message.body == "Hello") {
    await client.sendMessage(message.id.remote, "Hai");
  }
});

Jeast Whatsapp API has various functions, there are several functions that are not tied to existing events, so we will provide documentation of these functions below

Events Listeners

This is a some event listener that return a callback

  const { Jeast } = require("jeast-whatsapp-api");

  const client = new Jeast();

  client.ev.qr(callback); //Event listener to get or print qr code
  client.ev.connection(callback); //Event listener that which will be called when connected or authenticated
  client.ev.message(callback); //Event listener that which will be called when some peoples send message
  client.ev.revokeMe(callback); //Event listener that which will be called when some peoples revoke to you
  client.ev.revokeAll(callback); //Event listener that which will be called when revoke all related to you
  client.ev.uploadMedia(callback); //Event listener that will be called if you are sending a message

Sending Message

This is a function to send a message

  const options = {
    sendAudioAsVoice: Boolean, // make it true if you use this options
    sendVideoAsGif: Boolean, // make it true if you use this options
    sendAsSticker: Boolean, // make it true if you use this options
    sendAsDocument: Boolean, // make it true if you use this options
  }

  sendMessage('receiver-number@.c.us', 'message', options); // asynchronous function

Get Chat List

This is a function to get all chat list

  getChats(); // asynchronous function

Logout

This is a function to logout from the whatsapp web

  logout(); // asynchronous function

Search Messages

This is a function to search messages with query type string

  const options = {
    page: number; // fill in how many messages the message page will retrieve
    limit: number; // fill in how many messages are limited
    chatId: string; // fill in the recipient's chat id
  }

  searchMessages(query = 'string', options); // asynchronous function

Send Seen

This is a function to send message seen

  sendMessageSeen('[e-mail]') // asynchronous function

Get Chat By Id

This is a function to get chat using chat id

  getChatById('[e-mail]') // asynchronous function

Get Phone Country Code

This is a function to get chat using chat id

  getPhoneCountry('phone-number') // asynchronous function

Create New Group

This is a function to create new group and add some participants

  createNewGroup("Test", ["List of participant number id"]); // asynchronous function

Get Whatsapp Version

This is a function to get whatsapp version

  getWAVersion() // asynchronous function

Get Contacts

This is a function to get all contacts

  getContacts() // asynchronous function

🖼 Send as Sticker

const { Jeast, MsgMedia } = require("jeast-whatsapp-api");

const client = new Jeast();

client.connect({
  logger: true,
  qr_terminal: true,
  headless: true,
  authState: {
    isAuth: true,
    authType: "multidevice",
    authId: "example_account",
  },
});

client.ev.qr(async (qr) => {
  if (qr) {
    console.log(qr);
  }
});

client.ev.connection(async (connection) => {
  if (connection.isConnected) {
    const sticker = MsgMedia.fromFilePath(
      __dirname + "/path/to/file"
    );
    await client.sendMessage('[e-mail]', sticker, {
      sendAsSticker: true,
    });
  }
});

🖻 Send as Document

const { Jeast, MsgMedia } = require("jeast-whatsapp-api");

const client = new Jeast();

client.connect({
  logger: true,
  qr_terminal: true,
  headless: true,
  authState: {
    isAuth: true,
    authType: "multidevice",
    authId: "example_account",
  },
});

client.ev.qr(async (qr) => {
  if (qr) {
    console.log(qr);
  }
});

client.ev.connection(async (connection) => {
  if (connection.isConnected) {
    const document = MsgMedia.fromFilePath(
      __dirname + "/path/to/file"
    );
    await client.sendMessage('[e-mail]', document, {
      sendAsDocument: true,
    });
  }
});

👾 Send Video as Gif

const { Jeast, MsgMedia } = require("jeast-whatsapp-api");

const client = new Jeast();

client.connect({
  logger: true,
  executablePath: "/path/to/chrome", //use executablePath to send video or gif
  qr_terminal: true,
  headless: true,
  authState: {
    isAuth: true,
    authType: "multidevice",
    authId: "example_account",
  },
});

client.ev.qr(async (qr) => {
  if (qr) {
    console.log(qr);
  }
});

client.ev.connection(async (connection) => {
  if (connection.isConnected) {
    const video = MsgMedia.fromFilePath(
      __dirname + "/path/to/file"
    );
    await client.sendMessage('[e-mail]', video, {
      sendVideoAsGif: true,
    });
  }
});

📑 License

MIT License

Copyright (c) 2022 Ferdian Satria Akbar

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.