About
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 willWhatsapp電腦版 網頁版 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.
Links
- Website
- Guide (source) (work in progress)
- Documentation (source)
- WWebJS Discord
- GitHub
- npm
Installation
The module is now available on npm! npm i whatsapp網頁版-web.js
[!NOTE] Node
v18+
is required.
QUICK STEPS TO UPGRADE NODE
Windows
Manual
Just get the latest LTS from the official node website.
npm
sudo npm install -g n
sudo n stable
Choco
choco install nodejs-lts
Winget
winget install OpenJS.NodeJS.LTS
Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | 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') {
msg.reply('pong');
}
});
client.initialize();
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!
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!
Supporting the project
You can support the maintainer of this project through the links below
- Support via GitHub Sponsors
- Support via PayPal
- Sign up for DigitalOcean and get $200 in credit when you sign up (Referral)
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 http://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.