# wwebjs/whatsapp-web.js

A WhatsApp client library for NodeJS that connects through the WhatsApp Web browser app

Repository: https://github.com/wwebjs/whatsapp-web.js
Canonical: https://ross.abutalabs.com/products/whatsapp-webjs
Homepage: https://wwebjs.dev
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: whatsapp, whatsapp-web, whatsapp-bot, whatsapp-api, bot, api, bot-api, whatsapp-web-api, hacktoberfest
Last push: 2026-08-23T12:03:28+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 81, longevity 100
- inputs: {"age_days": 2755, "days_push": 10, "days_rel": 131, "gap_med": 23, "n_releases_24m": 18}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 22475, forks 5129 (observed 2026-08-28T04:11:32.650775+00:00)

## What it is
whatsapp-web.js is a Node.js client library that connects to WhatsApp through the WhatsApp Web browser app using Puppeteer, exposing nearly all web client features programmatically. It enables building bots and automation for user or business accounts with an object-oriented API.

## Use cases
- build a whatsapp bot that auto-replies to messages
- send whatsapp messages programmatically from nodejs
- automate whatsapp group management
- send media and stickers via whatsapp api
- create whatsapp polls and channels programmatically
- monitor and receive whatsapp messages in an app

## When to choose
- you need a full-featured unofficial WhatsApp API in Node.js
- you want to automate WhatsApp for user or business accounts
- you need multi-device support, media, groups, and polls in one library

## When to avoid
- you need an officially supported WhatsApp Business API with guaranteed compliance
- you cannot run a headless browser (Puppeteer) on your infrastructure
- you need guaranteed uptime - unofficial automation risks account bans

## Facets
- artifact type: library
- maturity: active
- function: http-client, chatbot, workflow-automation, sdk
- domain: messaging-platforms, developer-tools, apis
- platform: cross-platform
- tags: whatsapp, whatsapp-web, whatsapp-bot, puppeteer, unofficial-api, messaging, chat-automation, automation, nodejs

## Member repositories
- wwebjs/whatsapp-web.js (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:32.650775+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:57:09.712269+00:00, confidence not recorded.
  - readme: https://github.com/wwebjs/whatsapp-web.js (fetched 2026-08-28T04:11:32.650775+00:00, sha 371a8800fcb8)
  - homepage: https://wwebjs.dev (fetched 2026-08-29T07:55:50.236240+00:00, sha 90256c381b66)
  - site_page: https://docs.wwebjs.dev/ (fetched 2026-08-29T07:55:50.245671+00:00, sha 84f4cbfbc36f)
  - registry_npm: https://registry.npmjs.org/whatsapp-web.js (fetched 2026-08-29T07:55:50.248847+00:00, sha 41b144e3dd17)
- Data as of 2026-08-30T08:39:29.467469+00:00.