wppconnect-team

wa-js: Access WhatsApp Web Functions from TypeScript

WA-JS exposes WhatsApp Web functions through a JavaScript API for browser-based integrations and automation. It is actively maintained and suits developers who can run code in a WhatsApp Web session and adapt to changes in the web client.

ActiveTypeScriptApache-2.0LibraryAutomationWhatsapp Web
View on GitHub Compare
Stars
817
Forks
248
Stars, last 30 days
+14
Last commit
today
Contributors
47

Our take

Activeregular commits and releases

Health score

71/100

How it is scored
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 commit2026-10-07 (today)
Commits, last 90 days100+
Releases, last 12 months38 (latest nightly, 2021-10-12, pre-release)
Contributors47 (top contributor: 55% of commits)
Issues closed, last 90 days7+ (typically closed in 9 days)
Pull requests merged, last 90 days98 (typically merged in 0 days)
Project age5 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.

Selected snapshot

Stars

840

Forks

253

Change 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 WPP global, organized into modules such as WPP.chat, WPP.contact, and WPP.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.
ProjectLanguageLicenseStarsStatus
wa-jsTypeScriptApache-2.0817Active
builderbotTypeScriptMIT3kActive
heyooPythonMIT513Inactive

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.

Comparisons