wppconnect-team/wppconnect

WPPConnect is an open source project developed by the JavaScript community with the aim of exporting functions from WhatsApp Web to the node, which can be used to support the creation of any interaction, such as customer service, media sending, intelligence recognition based on phrases artificial and many other things, use your imagination

TypeScript

3,473

2,894 commits

updated Oct 14, 2026

See the code

README

WPPConnect πŸ“ž

WPPConnect Banner

npm version Downloads Average time to resolve an issue Percentage of issues still open Build Status Lint Status release-it

WPPConnect is an open source project developed by the JavaScript community with the aim of exporting functions from WhatsApp Web to the node, which can be used to support the creation of any interaction, such as customer service, media sending, intelligence recognition based on phrases artificial and many other things, use your imagination... πŸ˜€πŸ€”πŸ’­

Getting Started β€’ Basic Function β€’ Documentation

Our online channels

Discord Telegram Group WhatsApp Group YouTube

Functions

Automatic QR Refreshβœ”
Send text, image, video, audio and docsβœ”
Get contacts, chats, groups, group members, Block Listβœ”
Send contactsβœ”
Send stickersβœ”
Send stickers GIFβœ”
Multiple Sessionsβœ”
Forward Messagesβœ”
Receive messageβœ”
insert user sectionβœ”
Send locationβœ”
and much moreβœ”

See more at WhatsApp methods

Installation

The first thing that you had to do is install the npm package :

npm i --save @wppconnect-team/wppconnect

See more at Getting Started

Development

Building WPPConnect is really simple, to build the entire project just run

> npm run build

Update checking

Whatsapp is in constant change. In order to tackle this issue, we suggest always keeping your Wppconnect package up-to-date.

The method/function names won't change, only their core algorithm. This way you won't have to makes changes in your code at every update. They will remain the same forever but might experience deprecation.

Maintainers

Maintainers are needed, I cannot keep with all the updates by myself. If you are interested please open a Pull Request.

Contributing

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

Star History

Star History Chart

License

This file is part of WPPConnect.

WPPConnect is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

WPPConnect is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with WPPConnect. If not, see https://www.gnu.org/licenses/.

ai
api
automate
bot
chat
chatbot
framework
message
nodejs
open-source
puppeteer
sulla
typescript
wa
whatsapp
whatsapp-api
whatsapp-bot
wpp
wppconnect
zap-api

wppconnect-team/wppconnect

WPPConnect is an open source project developed by the JavaScript community with the aim of exporting functions from WhatsApp Web to the node, which can be used to support the creation of any interaction, such as customer service, media sending, intelligence recognition based on phrases artificial and many other things, use your imagination

TypeScript

3,473

2,894 commits

updated Oct 14, 2026

See the code

README

WPPConnect πŸ“ž

WPPConnect Banner

npm version Downloads Average time to resolve an issue Percentage of issues still open Build Status Lint Status release-it

WPPConnect is an open source project developed by the JavaScript community with the aim of exporting functions from WhatsApp Web to the node, which can be used to support the creation of any interaction, such as customer service, media sending, intelligence recognition based on phrases artificial and many other things, use your imagination... πŸ˜€πŸ€”πŸ’­

Getting Started β€’ Basic Function β€’ Documentation

Our online channels

Discord Telegram Group WhatsApp Group YouTube

Functions

Automatic QR Refreshβœ”
Send text, image, video, audio and docsβœ”
Get contacts, chats, groups, group members, Block Listβœ”
Send contactsβœ”
Send stickersβœ”
Send stickers GIFβœ”
Multiple Sessionsβœ”
Forward Messagesβœ”
Receive messageβœ”
insert user sectionβœ”
Send locationβœ”
and much moreβœ”

See more at WhatsApp methods

Installation

The first thing that you had to do is install the npm package :

npm i --save @wppconnect-team/wppconnect

See more at Getting Started

Development

Building WPPConnect is really simple, to build the entire project just run

> npm run build

Update checking

Whatsapp is in constant change. In order to tackle this issue, we suggest always keeping your Wppconnect package up-to-date.

The method/function names won't change, only their core algorithm. This way you won't have to makes changes in your code at every update. They will remain the same forever but might experience deprecation.

Maintainers

Maintainers are needed, I cannot keep with all the updates by myself. If you are interested please open a Pull Request.

Contributing

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

Star History

Star History Chart

License

This file is part of WPPConnect.

WPPConnect is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

WPPConnect is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with WPPConnect. If not, see https://www.gnu.org/licenses/.

ai
api
automate
bot
chat
chatbot
framework
message
nodejs
open-source
puppeteer
sulla
typescript
wa
whatsapp
whatsapp-api
whatsapp-bot
wpp
wppconnect
zap-api

Project health

Overall

5.2/10

Maintained

10/10

Code review

0/10
OpenSSF Scorecard

Latest release

2.3.4 Β· Oct 2, 2026

Releases this year

31

Significant stargazers

Usman Sabuwala

496 followers Β· starred Jul 2024

Ryan Zhu

179 followers Β· starred Oct 2025

webtecnica

10 followers Β· starred Jun 2022

Clairton Rodrigo Heinzen

127 followers Β· starred May 2022