1.0.4 • Published 3 years ago

@mayahq/waborn v1.0.4

Weekly downloads
1
License
H-DNH V1.0
Repository
github
Last release
3 years ago

waborn

A fork of @open-wa/wa-automate from the good people at @open-wa

This library is forked to resolve some issue with sharp dependencies used in the project

All the good work has been done by @smashah and others in at @open-wa

wa-automate-nodejs is the most advanced NodeJS library which provides a high-level API to control WA.

Installation

> npm i --save @mayahq/waborn

Usage

// import { create, Client } from '@open-wa/wa-automate';
const wa = require('@mayahq/waborn');

wa.create().then(client => start(client));

function start(client) {
  client.onMessage(message => {
    if (message.body === 'Hi') {
      client.sendText(message.from, '👋 Hello!');
    }
  });
}
After executing create() function, @open-wa/wa-automate will create an instance of WA web. If you are not logged in, it will print a QR code in the terminal. Scan it with your phone and you are ready to go!
@open-wa/wa-automate will remember the session so there is no need to authenticate every time

CLI

Want to convert your WA account to an API instantly? You can now with the CLI. For more details see Easy API

> npx @open-wa/wa-automate --help

Latest Changes

With the constant updates from WA. It is advisable to always use the latest version of @open-wa/wa-automate.

Functions list

FunctionReference
Receive messageonMessage
Automatic QR RefreshautoRefresh
Send textsendText
Get contactsgetContact
Get chatsgetAllChats
Get groupsgetAllGroups
Get group membersgetGroupMembersId
Send contactsendContact
Send Images (image)sendImage
Send media (audio, doc)sendFile
Send media (video)Send Videos
Send stickerssendStickerfromUrl
Decrypt media (image, audio, doc)Decrypt Media
Capturing QR CodeCapturing QR Code
Multiple SessionsMultiple Sessions
Last seengetLastSeen
isOnlineisChatOnline
📍 Send LocationsendLocation
Simulated '...typing'simulateTyping
Send GIFs!sendVideoAsGif
Send Giphy!sendGiphy
Forward MessagesforwardMessages
Listen to Read ReceiptsonAck
Listen to Live LocationsonLiveLocation
Group participant changesonParticipantsChanged
Create GroupsCreate Group
add, remove, promote, demote participantsManage Participants

Checkout all the available functions here.

Running the demo

You can clone this repo and run the demo, but you will need to use typescript/ts-node:

> git clone https://github.com/open-wa/wa-automate-nodejs.git
> cd wa-automate-nodejs
> npm i
> npm i -g ts-node typescript
> cd demo
> ts-node index.ts

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Support

If you need paid support, consulting, or just want support/sponsor the ongoing development of this project, you can in the following ways:

DescriptionLink
Get a License keyGet a License key
Donate or Book 1 hour consultBuy me a coffee
Per-minute consulting
Hire me!Consulting Request

License

Hippocratic + Do Not Harm Version 1.0

Legal

This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by WA or any of its affiliates or subsidiaries. This is an independent and unofficial software. Use at your own risk.

Cryptography Notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.