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 an
Last verified:
What is Wppconnect?
WPPConnect is an open-source JavaScript library that exports WhatsApp Web functions to Node.js, enabling programmatic automation and integration with WhatsApp. It allows developers to send and receive messages (text, images, videos, audio, documents, stickers, stickers GIF), manage contacts, chats, groups, group members, and block lists, create groups, forward messages, send contacts, and send location data. The library handles authentication via QR code with automatic QR refresh and supports multiple sessions simultaneously.
The tool is designed for developers building customer service chatbots, automated messaging systems, AI-powered phrase recognition, media sending automation, and any WhatsApp-based interactions. It includes WPPConnect Server, a ready-to-use RESTful API built with Node.js (Express, Socket.io) and React frontend that simplifies message sending/receiving, contact management, and group creation. WAJS (WhatsApp JavaScript library) is also part of the ecosystem, enabling browser extension development and direct console use on WhatsApp Web.
WPPConnect is ideal for JavaScript/TypeScript developers who need to automate WhatsApp without building browser orchestration code from scratch. It supports Puppeteer and Playwright integration, offers Docker deployment, and provides comprehensive documentation. The project has 3.1k stars on GitHub and is licensed under Apache 2.0, making it suitable for both personal and commercial projects.
Key use cases include customer service automation, marketing campaigns, notification systems, chatbot development, CRM integrations, order management through WhatsApp catalogs, and business communication workflows. The library exports WhatsApp functions via webpack/babel, exposing them through the global WPP variable for easy access.
Wppconnect pricing
Pricing model: Freemium
WPPConnect is completely free and open-source under the Apache License 2.0. There is no paid tier, subscription, or premium plan. The library, WPPConnect Server, WAJS, and Docker images are all available at no cost. The project is community-driven and accepts sponsorships through OpenCollective to support developers, but usage itself is free. Users can redistribute and modify the software under the license terms.
Wppconnect pros
- Completely open-source under Apache 2.0 license
- No paid plans - entirely free to use
- Automatic QR code refresh for easier authentication
- Supports multiple simultaneous WhatsApp sessions
- Sends text, images, videos, audio, documents, and stickers
- Send stickers GIF support
- Full contact, chat, group, and block list management
- Built-in RESTful API server (Node.js + Express + Socket.io)
- Docker support for easy deployment
- Forward messages capability
- Send and receive messages fully automated
- Send contacts and location data
- TypeScript and JavaScript support (62.5% TypeScript)
- 3.1k GitHub stars with active community (42 contributors)
- Works with Puppeteer and Playwright browser automation
- WAJS enables browser extension development
- WebSocket support via Socket.io for real-time updates
- Comprehensive API documentation available
- Group management: create, add/remove participants, promote/demote admins
- Catalog and cart functions for e-commerce
Wppconnect cons
- Unofficial API - violates WhatsApp Terms of Service
- Risk of WhatsApp account ban or suspension
- Depends on WhatsApp Web which can break with updates
- Requires Node.js installation and setup knowledge
- No official customer support - community-driven only
- SSL library errors may occur on Windows installations
- Browser automation can be resource-intensive
- QR code scanning required for initial authentication
- No guarantee of long-term stability due to unofficial nature
- May require constant maintenance when WhatsApp updates
Frequently asked questions about Wppconnect
What is WPPConnect?
WPPConnect is an open-source project developed by the JavaScript community that exports functions from WhatsApp Web to Node.js. It enables developers to create any interaction like customer service, media sending, and AI phrase recognition by automating WhatsApp Web programmatically.
Is WPPConnect free to use?
Yes, WPPConnect is completely free and open-source under the Apache License 2.0. There are no paid plans, subscriptions, or premium features. All components including the library, server, WAJS, and Docker images are free.
How do I install WPPConnect?
Install the npm package by running: npm i --save @wppconnect-team/wppconnect. For WPPConnect Server, run yarn install or npm install, then start the server. Docker images are also available for easy deployment.
What messages can I send with WPPConnect?
WPPConnect supports sending text, images, videos, audio files, documents, contacts, stickers, stickers GIF, and location data. You can also forward messages and receive incoming messages automatically.
Does WPPConnect support multiple WhatsApp sessions?
Yes, WPPConnect supports multiple simultaneous sessions, allowing you to manage several WhatsApp accounts from the same application. Each session authenticates independently via QR code.
What is WPPConnect Server?
WPPConnect Server is a ready-to-use RESTful API made in Node.js with Express and Socket.io. It provides all WPPConnect functions through HTTP calls, with a React frontend, making it simple to send/receive messages, manage contacts, and create groups.
What is WAJS (WhatsApp JavaScript)?
WAJS is an open-source library that exports WhatsApp Web functions for browser extensions and console use. After injection into WhatsApp Web, it exposes the global WPP variable with functions for chat, contacts, groups, catalogs, privacy, and more.
How does authentication work?
WPPConnect uses QR code authentication like WhatsApp Web. It features automatic QR refresh to simplify the process. You scan the QR code with your phone to authenticate, and the library handles the connection to WhatsApp Web.
Can I build browser extensions with WPPConnect?
Yes, WAJS is specifically designed for browser extension development. You can inject the wppconnect-wa.js file into WhatsApp Web and use the WPP variable directly in the browser console to create extensions.
What are the legal risks of using WPPConnect?
WPPConnect is an unofficial WhatsApp API that works by automating WhatsApp Web. This violates WhatsApp's Terms of Service, which may result in account bans or suspension. The library is provided AS IS without warranties, and users should be mindful of WhatsApp's terms when using it.