Headless Multi Session Whatsapp Gateway NodeJS

Easy Setup Headless multi session Whatsapp Gateway with NodeJS

• Support Multi device
• Support Multi Session / Multi Phone Number
• Send Text Message
• Send Image
• Send Document

Read also wa-multi-session

⚠️ This application need to running in NodeJS v18 or later. ⚠️

Please Read How to install NodeJS

Install and Running

1. Clone the project

  git clone https://github.com/mimamch/wa_gateway.git

2. Go to the project directory

  cd wa_gateway

3. Install dependencies

  npm install

4. Start the server

  npm run start

5. Open On Browser & Start Scan QR

http://localhost:5001/session/start?session=mysession

6. Sending first message

http://localhost:5001/message/send-text?session=mysession&to=628123456789&text=Hello

API Reference

Add new session

  GET /session/start?session=NEW_SESSION_NAME
  or
  POST /session/start

Parameter	Type	Description
session	string	Required. Create Your Session Name

Send Text Message

  POST /message/send-text

Body	Type	Description
session	string	Required. Session Name You Have Created
to	string	Required. Receiver Phone Number with Country Code (e.g: 62812345678)
text	string	Required. Text Message

Send Image

  POST /message/send-image

Body	Type	Description
session	string	Required. Session Name You Have Created
to	string	Required. Receiver Phone Number with Country Code (e.g: 62812345678)
text	string	Required. Caption Massage
image_url	string	Required. URL Image

Send Document

  POST /message/send-document

Body	Type	Description
session	string	Required. Session Name You Have Created
to	string	Required. Receiver Phone Number with Country Code (e.g: 62812345678)
text	string	Required. Caption Massage
document_url	string	Required. Document URL
document_name	string	Required. Document Name

Delete session

  GET /session/logout?session=SESSION_NAME

Parameter	Type	Description
session	string	Required. Create Your Session Name

Get All Session ID

  GET /session

Examples

Using Axios

// send text
axios.post("http://localhost:5001/message/send-text", {
  session: "mysession",
  to: "62812345678",
  text: "hello world",
});

// send image
axios.post("http://localhost:5001/message/send-image", {
  session: "mysession",
  to: "62812345678",
  text: "hello world",
  image_url: "https://placehold.co/600x400",
});

Upgrading

npm install wa-multi-session@latest

Documentation

For detailed documentation, including guides and API references, please visit the official documentation.

Contributing

Contributions are welcome! Please follow the guidelines outlined in the CONTRIBUTING.md file.

License

This library is licensed under the MIT License.