Fork: 3321 Star: 13854 (更新于 2024-05-22 03:11:00)

license: Apache-2.0

Language: JavaScript .

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

最后发布版本: v1.23.1-alpha.6 ( 2024-05-01 03:30:18)

官方网址 GitHub网址

WWebJS Website

npm Depfu WhatsApp_Web 2.2346.52 Discord server


A WhatsApp API client that connects through the WhatsApp Web browser app

The library works by launching the WhatsApp Web browser application and managing it using Puppeteer to create an instance of WhatsApp Web, thereby mitigating the risk of being blocked. The WhatsApp API client connects through the WhatsApp Web browser app, accessing its internal functions. This grants you access to nearly all the features available on WhatsApp Web, enabling dynamic handling similar to any other Node.js application.

[!IMPORTANT] 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.



The module is now available on npm! npm i whatsapp-web.js

[!NOTE] Node v18+ is required.




Just get the latest LTS from the official node website.


sudo npm install -g n
sudo n stable


choco install nodejs-lts


winget install OpenJS.NodeJS.LTS

Ubuntu / Debian

curl -fsSL | sudo -E bash - &&\
sudo apt-get install -y nodejs

Example usage

const { Client } = require('whatsapp-web.js');

const client = new Client();

client.on('qr', (qr) => {
    // Generate and scan this code with your phone
    console.log('QR RECEIVED', qr);

client.on('ready', () => {
    console.log('Client is ready!');

client.on('message', msg => {
    if (msg.body == '!ping') {


Take a look at example.js for another examples with additional use cases.
For further details on saving and restoring sessions, explore the provided Authentication Strategies.

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
Vote in polls 🔜
Communities 🔜
Channels 🔜

Something missing? Make an issue and let us know!


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!

Supporting the project

You can support the maintainer of this project through the links below


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" 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.


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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

最近版本更新:(数据更新于 2024-06-02 07:46:12)

2024-05-01 03:30:18 v1.23.1-alpha.6

2024-03-01 22:12:09 v1.23.1-alpha.5

2024-01-14 14:49:02 v1.23.1-alpha.4

2024-01-03 02:47:25 v1.23.1-alpha.3

2023-12-17 15:52:23 v1.23.1-alpha.2

2023-12-12 16:36:12 v1.23.1-alpha.1

2023-10-22 19:08:36 v1.23.1-alpha.0

2023-10-21 23:42:23 v1.23.0

2023-10-20 00:39:29 v1.22.2-alpha.4

2023-10-11 22:55:39 v1.22.2-alpha.3


api, bot, bot-api, hacktoberfest, whatsapp, whatsapp-api, whatsapp-bot, whatsapp-web, whatsapp-web-api

pedroslopez/whatsapp-web.js同语言 JavaScript最近更新仓库

2024-06-20 17:48:22 4ian/GDevelop

2024-06-18 06:07:40 langflow-ai/langflow

2024-06-15 01:21:11 serverless/serverless

2024-06-12 01:17:57 gchq/CyberChef

2024-06-02 14:21:21 Number178/kikoeru-express

2024-06-01 00:05:36 jgraph/drawio-desktop