whatsapp-web.js README

The project's README from github.com/wwebjs/whatsapp-web.js. As one markdown file: README.md.

WWebJS Website

npm NPM Downloads GitHub contributors Depfu Discord server

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.

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.

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.

whatsapp-web.js (wwebjs/whatsapp-web.js)

Searching Database…

22.7K ·GitHub
Whatsapp-web.js
Что это такое?Это клиентская библиотека для Node.js, работающая с WhatsApp: ваш код взаимодействует с WhatsApp Web и позволяет собрать собственный WhatsApp API почти со всеми возможностями веб-клиента.
То есть это не официальный WhatsApp API — как оно тогда работает?Это библиотека, которую вы используете в коде на Node.js, а не отдельное приложение. Под капотом она управляет настоящим клиентом WhatsApp Web через Puppeteer, запущенный в управляемом экземпляре браузера.
Как подключить её к своему проекту?Установите пакет в проект на Node.js v18+ командой 'npm install whatsapp-web.js', а начать можно с файла example.js; в README есть ссылки на руководство и полную документацию.
Что должно быть установлено, чтобы всё заработало?Node.js v18.0.0 или выше. Пакет подтягивает Puppeteer, а также вспомогательные библиотеки для медиа, вроде fluent-ffmpeg и node-webpmux; для отправки видео дополнительно нужен Google Chrome.
Насколько велика вероятность, что мой аккаунт забанят за использование?Риск реальный: это неофициальный клиент, а WhatsApp не разрешает ботов на своей платформе, поэтому ваш номер могут заблокировать, и проект не гарантирует безопасность.
Где это работает — нужна ли какая-то конкретная ОС?Это библиотека для Node.js, поэтому она работает везде, где работают Node 18+ и Chrome/Chromium — на Windows, macOS или Linux. Мобильной версии нет: она управляет сессией WhatsApp Web, а не приложением на телефоне.
А можно до сих пор отправлять интерактивные кнопки или списки?Нет — в таблице возможностей обе функции помечены ❌ (DEPRECATED), так что пользуйтесь обычными сообщениями, медиа, стикерами, опросами и реакциями.
Нужно ли что-то особенное для отправки видео?Да — в таблице возможностей отмечено, что для отправки видео нужен установленный Google Chrome.
Поддерживаются ли сообщества WhatsApp (Communities)?Пока нет — сообщества помечены как «скоро будет» (🔜), а каналы (Channels), опросы и обычное управление группами уже работают.
What are similar projects?Baileys, OpenWA, go-whatsapp-web-multidevice, wechaty, openclaw, python-telegram-bot, ItChat, wxpy
Which topics is it in?whatsapp-api, whatsapp, bot, messaging, chat, browser-automation, chatbot, hacktoberfest, backend, npm, api, automation
Creator
wwebjs
Size
6.3 MB
Stars
22.7K
Updated
CommitSep 28Releasev1.34.7Apr 24
Age
7y
Commits · 90 Days