Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/wppconnect-team/wa-js/llms.txt

Use this file to discover all available pages before exploring further.

WA-JS (@wppconnect/wa-js) is an open-source browser injection library that extracts and wraps WhatsApp Web’s internal modules, exposing them as a clean, stable public API under the global WPP object. Inject it into any WhatsApp Web session — via TamperMonkey, Playwright, Puppeteer, or your own tooling — and immediately access a rich set of functions for messaging, group management, contacts, business features, and more.

Quickstart

Send your first message in minutes with a working code example.

Installation

Install via npm or load from the nightly CDN release.

Core Concepts

Understand how WA-JS injects into WhatsApp Web and exposes the WPP API.

API Reference

Browse all available modules: chat, group, contact, status, and more.

​
What you can build

WA-JS gives you programmatic access to WhatsApp Web’s full feature set:

Messaging

Send text, files, locations, polls, lists, reactions, and interactive button messages.

Groups & Communities

Create groups, manage participants, set admin roles, handle invites and membership requests.

Channels (Newsletters)

Create and manage WhatsApp Channels, follow/unfollow, and retrieve subscribers.

Business Catalog

Manage products, collections, and carts for WhatsApp Business accounts.

Status Updates

Post text, image, and video statuses. Read and manage your status feed.

Privacy & Profile

Control who sees your last seen, profile picture, and status updates.

​
How it works

WA-JS intercepts WhatsApp Web’s internal module system at page load time, extracts the underlying functions and data models, and re-exports them as the global WPP object. Your code interacts with WPP directly in the browser context — no external server required. 
// Wait for WA-JS to be ready
WPP.loader.onReady(async () => {
  // Check authentication state
  const isAuth = WPP.conn.isAuthenticated();
  console.log('Authenticated:', isAuth);

  // Send a message
  await WPP.chat.sendTextMessage('5511999999999@c.us', 'Hello from WA-JS!');
});
WA-JS requires WhatsApp Web version 2.2326.10-beta or later. The library is actively maintained to track WhatsApp Web updates.

​
Integration methods

TamperMonkey / GreaseMonkey

Inject WA-JS directly into WhatsApp Web using a userscript manager.

Playwright / Puppeteer

Automate WhatsApp Web sessions in headless or headed browser environments.

Build docs developers (and LLMs) love

Get started for freeTalk to us