@wwebjs/whatsapp-web.js (1.34.49)
Installation
@wwebjs:registry=npm install @wwebjs/whatsapp-web.js@1.34.49"@wwebjs/whatsapp-web.js": "1.34.49"About this package
About
whatsapp‑web.js is a powerful Node.js library that lets you interact with WhatsApp Web, making it easy to build a dynamic WhatsApp API with nearly all features of the web client. It uses Puppeteer to access WhatsApp Web’s internal functions and runs them in a managed browser instance to reduce the risk of being blocked.
Links
Installation
Node.js v18.0.0 or higher, is required.
npm install whatsapp-web.js
yarn add whatsapp-web.js
pnpm add whatsapp-web.js
Having trouble installing? Take a peak at the Guide for more detailed instructions.
Example usage
const { Client } = require('whatsapp-web.js');
const qrcode = require('qrcode-terminal');
const client = new Client();
client.on('qr', (qr) => {
qrcode.generate(qr, { small: true });
});
client.on('ready', () => {
console.log('Client is ready!');
});
client.on('message', (msg) => {
if (msg.body == '!ping') {
msg.reply('pong');
}
});
client.initialize();
Take a look at example.js for additional examples and use cases.
For more details on saving and restoring sessions, check out the Authentication Strategies.
Realtime monitor
Use the dedicated monitor script to pair a development session and trace the runtime compatibility surface in realtime:
npm run monitor
What it does:
- Starts a
Clientwith persistentLocalAuth; the paired session is reused - Prints a QR only in the interactive terminal when one is required
- Captures the current WhatsApp Web HTML in
.wwebjs_monitor_cache/for certification; this never changes the production pin automatically - Checks every private
window.require()module referenced by the library - Writes redacted JSONL telemetry to
logs/wwebjs-monitor.log(mode0600) and rotates it at 10 MiB
Notes:
- If the saved session is valid, no QR is shown (normal behavior)
- QR strings, pairing codes, messages, media, cookies, and session material are never written to the monitor log
- Use
WWEBJS_MONITOR_WEB_CACHE_MODE=pinnedto test the bundled, strict cache instead of the discovery capture
Bundled WhatsApp Web build
The default client ships a SHA-256- and size-verified WhatsApp Web bootstrap
HTML, so a clean install does not need a cache directory, download step, or
custom cache configuration. It intentionally fails closed if that pinned file
is absent, modified, or reports a different window.Debug.VERSION.
This pin covers the bootstrap document only. WhatsApp Web still retrieves its own dynamic scripts and assets from WhatsApp's official infrastructure; the library is not an offline mirror of those resources.
Supported features
| Feature | Status |
|---|---|
| Multi Device | ✅ |
| Send messages | ✅ |
| Receive messages | ✅ |
| Send media (images/audio/documents) | ✅ |
| Send media (video) | ✅ (requires Google Chrome) |
| Send stickers | ✅ |
| Receive media (images/audio/video/documents) | ✅ |
| Send contact cards | ✅ |
| Send location | ✅ |
| Send buttons | ❌ (DEPRECATED) |
| Send lists | ❌ (DEPRECATED) |
| Receive location | ✅ |
| Message replies | ✅ |
| Join groups by invite | ✅ |
| Get invite for group | ✅ |
| Modify group info (subject, description) | ✅ |
| Modify group settings (send messages, edit info) | ✅ |
| Add group participants | ✅ |
| Kick group participants | ✅ |
| Promote/demote group participants | ✅ |
| Mention users | ✅ |
| Mention groups | ✅ |
| Mute/unmute chats | ✅ |
| Block/unblock contacts | ✅ |
| Get contact info | ✅ |
| Get profile pictures | ✅ |
| Set user status message | ✅ |
| React to messages | ✅ |
| Create polls | ✅ |
| Channels | ✅ |
| Vote in polls | ✅ |
| Communities | 🔜 |
Something missing? Make an issue and let us know!
Supporting the project
You can support the maintainer of this project through the links below:
Contributing
Feel free to open pull requests; we welcome contributions! However, for significant changes, it's best to open an issue beforehand. Make sure to review our contribution guidelines before creating a pull request. Before creating your own issue or pull request, always check to see if one already exists!
Disclaimer
This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at whatsapp.com. "WhatsApp" as well as related names, marks, emblems and images are registered trademarks of their respective owners. Also it is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.
License
Copyright 2019 Pedro S Lopez
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this project except in compliance with the License.
You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Dependencies
Dependencies
| ID | Version |
|---|---|
| @noble/post-quantum | 0.6.1 |
| archiver | 7.0.1 |
| fluent-ffmpeg | 2.1.3 |
| mime | 3.0.0 |
| node-fetch | 2.7.0 |
| node-webpmux | 3.2.1 |
| pg | 8.22.0 |
| puppeteer | 24.38.0 |
Development Dependencies
| ID | Version |
|---|---|
| @commitlint/cli | ^20.4.3 |
| @commitlint/config-conventional | ^20.4.3 |
| @eslint/js | ^9.39.4 |
| @types/node-fetch | ^2.6.13 |
| chai | ^4.5.0 |
| chai-as-promised | ^7.1.2 |
| dotenv | ^17.3.1 |
| eslint | ^9.39.4 |
| eslint-config-prettier | ^10.1.8 |
| eslint-plugin-mocha | ^11.2.0 |
| eslint-plugin-prettier | ^5.5.5 |
| globals | ^17.4.0 |
| is-ci | ^4.1.0 |
| jsdoc | ^3.6.4 |
| jsdoc-baseline | ^0.1.5 |
| lint-staged | ^16.3.2 |
| mocha | ^11.7.5 |
| prettier | ^3.8.1 |
| qrcode-terminal | ^0.12.0 |
| sinon | ^21.0.2 |
Optional Dependencies
| ID | Version |
|---|---|
| fs-extra | 11.4.0 |
| unzipper | 0.12.5 |