Baileys API

An implementation of @adiwajshing/Baileys as a simple RESTful API service with multiple device support. This project implements both Legacy (Normal WhatsApp Web) and Beta Multi-Device client so that you can choose and use one of them easily.

Installation

Download or clone this repo.
Enter to the project directory.
Copy .env.example to .env
Execute npm i to install the dependencies.

`.env` Configurations

# Listening Host
HOST=127.0.0.1

# Listening Port
PORT=8000

# Maximum Reconnect Attempts
MAX_RETRIES=5

# Reconnect Interval (in Milliseconds)
RECONNECT_INTERVAL=5000

Usage

You can start the app by executing npm run start or node ..
Now the endpoint should be available according to your environment variable configurations. Default is at http://localhost:8000.

API Docs

The API documentation is available online here. You can also import the Postman Collection File (postman_collection.json) into your Postman App alternatively.

The server will respond in following JSON format:

{
    success: true|false, // bool
    message: "", // string
    data: {}|[] // object or array of object
}

Known Issue

Logging out from your phone manually when the session is still active will kill the entire app after a few minutes. As for now you should only destroy a session by using the delete session endpoint to avoid this issue. This issue only occurs for Beta Multi-Device users.

Notes

The app only provide a very simple validation, you may want to implement your own.
There's no authentication, you may want to implement your own.
The Beta Multi-Device client use provided baileys's makeInMemoryStore method which will store your data in memory and a json file, you may want to use a better data management.
There's no reading message occured before sending message. The reading message only occurs when the client received message from someone, it will read them immediately. You should always read messages before starting the app and start sending messages to avoid abnormal detection.

Notice

This project is intended for learning purpose only, don't use it for spamming or any activities that's prohibited by WhatsApp.

arisawali2014/baileys-api