Our take
Activeregular commits and releases- Activity
- 83
- Community
- 64
- Issues
- 51
- Pull requests
- 85
+14 stars in the last 30 days
- Merges more pull requests than 98% of the projects we track
- Releases more often than 83% of the projects we track
WA-JS is a broad, actively maintained interface for WhatsApp Web internals, with frequent recent development and releases, but it remains tied to a changing web client rather than a stable official API.
Good fit if
- You need browser-side access to WhatsApp Web functions and can inject JavaScript into a WhatsApp Web session.
- Your TypeScript or Node.js development workflow can build and test the library, and you are prepared to track WhatsApp Web changes.
- The Apache-2.0 license works for your project, and you value a project with regular commits and releases and a broad contributor base.
Look elsewhere if
- You need an integration that works without WhatsApp Web or without injecting code into a browser session.
- Your requirements call for a stable interface independent of WhatsApp Web’s internal changes.
- You cannot accept the maintenance work associated with testing against a changing web client.
All health signals
| Last commit | 2026-10-07 (today) |
|---|---|
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 38 (latest nightly, 2021-10-12, pre-release) |
| Contributors | 47 (top contributor: 55% of commits) |
| Issues closed, last 90 days | 7+ (typically closed in 9 days) |
| Pull requests merged, last 90 days | 98 (typically merged in 0 days) |
| Project age | 5 years |
Checked on 2026-10-08 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
840Forks
253Change since Nov 18, 2026: 0 stars·-1 forks
Overview
WA-JS extracts functions from WhatsApp Web and exposes them through a browser global called WPP. It provides a programmatic interface for working with chats, contacts, groups, business features, statuses, and connection events, rather than requiring an integration to interact with the page solely through its visible UI.
This is a client-side library for developers building browser automation, extensions, or WhatsApp integrations. It is not a standalone messaging service: it must be injected into WhatsApp Web, and its functions depend on the web client’s internal implementation.
Key Features
- Exposes WhatsApp Web functions through the
WPPglobal, organized into modules such asWPP.chat,WPP.contact, andWPP.group. - Supports chat operations including sending text and media, retrieving chat details, and deleting messages.
- Provides APIs for groups, communities, contacts, connection state, and event handling.
- Includes business-oriented functions for catalogs, carts, orders, labels, and business profiles.
- Offers status, profile, privacy, and custom chat-list operations.
- Documents injection examples for userscripts and Playwright, and supports building with a custom global name.
- Includes Playwright tests and a helper for comparing WhatsApp Web versions.
Use Cases
- A developer can add WhatsApp Web messaging to a browser automation workflow that already controls a logged-in session.
- A support or operations team can build custom tools for managing chats, groups, labels, or business catalog workflows.
- Extension authors can expose WhatsApp Web actions in their own browser interface, including using a custom global name to avoid collisions.
- Maintainers of WA-JS-based tools can run smoke tests and compare web-client versions to identify changes that may break integrations.
What you need
Detected in the repository
- Node.js (from package.json)
- A test suite and automated checks on GitHub Actions
License in plain words
Apache-2.0permissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the license, the NOTICE file and a note of your changes
- Share your changes: no
- Includes an explicit patent grant from the contributors:
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
Install dependencies and build the bundle:
npm install
npm run build:prd
The build produces dist/wppconnect-wa.js for injection into WhatsApp Web. See the README for injection examples, testing, and version-specific development details.
Alternatives
- builderbot: BuilderBot builds provider-independent WhatsApp conversation flows, while wa-js exposes functions from an active WhatsApp Web session.
- heyoo: heyoo wraps WhatsApp Cloud API messaging and webhooks in Python, while wa-js automates WhatsApp Web through JavaScript.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| wa-js | TypeScript | Apache-2.0 | 817 | Active |
| builderbot | TypeScript | MIT | 3k | Active |
| heyoo | Python | MIT | 513 | Inactive |
Considerations
- The library extracts functions from WhatsApp Web, so changes to that client can break integrations. The repository includes smoke tests and version comparison tools, but teams still need to validate their workflows as WhatsApp Web changes.
- It requires a Node.js development environment and a browser session with WhatsApp Web for use. The README describes authenticated tests that require scanning a QR code.
- Recent activity is strong: the project has regular commits and releases, a large contributor pool, and issue closure typically takes days. This indicates active maintenance, not a guarantee that every exposed function remains stable.
- The project is licensed under Apache-2.0. Review the license and any applicable platform terms before distributing or operating an integration.
Found this useful?
Share it with someone who would like wa-js.