О

Клиент API WhatsApp, который подключается через приложение веб-браузера WhatsApp.

Библиотека работает путем запуска приложения веб-браузера WhatsApp и управления им с помощью Puppeteer для создания экземпляра WhatsApp Web, тем самым снижая риск блокировки. Клиент API WhatsApp подключается через приложение веб-браузера WhatsApp, получая доступ к его внутренним функциям. Это предоставляет вам доступ практически ко всем функциям, доступным в WhatsApp Web, обеспечивая динамическую обработку, аналогичную любому другому приложению Node.js.

Важный

Не гарантируется, что вы не будете заблокированы при использовании этого метода. WhatsApp не допускает использование ботов или неофициальных клиентов на своей платформе, поэтому не следует считать это абсолютно безопасным.

Ссылки

Веб-сайт
Руководство (источник) (в разработке)
Документация (источник)
WWebJS Дискорд
GitHub
НПМ

Установка

Модуль теперь доступен на npm! npm i whatsapp-web.js

Примечание

Требуется узел v18+ .

БЫСТРЫЕ ШАГИ ДЛЯ ОБНОВЛЕНИЯ УЗЛА

Окна

Руководство

Просто скачайте последнюю версию LTS с официального сайта узла.

НПМ

sudo npm install - g n
sudo n stable

Чоко

choco install nodejs - lts

Вингет

winget install OpenJS.NodeJS.LTS

Убунту / Дебиан

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && 
sudo apt-get install -y nodejs

Пример использования

 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 ( ) ;

Взгляните на example.js, чтобы найти другие примеры с дополнительными вариантами использования.
Для получения дополнительной информации о сохранении и восстановлении сеансов изучите предоставленные стратегии аутентификации.

Поддерживаемые функции

Особенность	Статус
Мульти-устройство	✅
Отправлять сообщения	✅
Получать сообщения	✅
Отправка мультимедиа (изображения/аудио/документы)	✅
Отправить медиа (видео)	✅ (требуется Google Chrome)
Отправить стикеры	✅
Получение мультимедиа (изображения/аудио/видео/документы)	✅
Отправить карточки контактов	✅
Отправить местоположение	✅
Кнопки отправки	❌ (УСТАРЕЛО)
Списки отправки	❌ (УСТАРЕЛО)
Получить местоположение	✅
Ответы на сообщения	✅
Вступайте в группы по приглашению	✅
Получить приглашение в группу	✅
Изменить информацию о группе (тема, описание)	✅
Изменение настроек группы (отправка сообщений, редактирование информации)	✅
Добавить участников группы	✅
Выгнать участников группы	✅
Повышение/понижение участников группы	✅
Упоминание пользователей	✅
Группы упоминаний	✅
Отключить/включить звук в чатах	✅
Блокировать/разблокировать контакты	✅
Получить контактную информацию	✅
Получить фотографии профиля	✅
Установить сообщение о статусе пользователя	✅
Реагировать на сообщения	✅
Создание опросов	✅
Голосуйте в опросах
Сообщества
Каналы

Чего-то не хватает? Создайте проблему и дайте нам знать!

Содействие

Не стесняйтесь открывать запросы на включение; мы приветствуем вклады! Однако для существенных изменений лучше всего открыть вопрос заранее. Обязательно ознакомьтесь с нашими рекомендациями по участию, прежде чем создавать запрос на включение. Прежде чем создавать собственную задачу или запрос на включение, всегда проверяйте, существует ли она уже!

Поддержка проекта

Вы можете поддержать сопровождающего этого проекта по ссылкам ниже.

Поддержка через спонсоров GitHub
Поддержка через PayPal
Зарегистрируйтесь в DigitalOcean и получите 200 долларов США на счет при регистрации (Реферал)

Отказ от ответственности

Этот проект не связан, не связан, не авторизован, не одобрен и не связан каким-либо образом официально с WhatsApp или какой-либо из его дочерних компаний или филиалов. Официальный сайт WhatsApp можно найти по адресу WhatsApp.com. «WhatsApp», а также связанные с ним названия, знаки, эмблемы и изображения являются зарегистрированными торговыми марками соответствующих владельцев. Также не гарантируется, что вы не будете заблокированы при использовании этого метода. WhatsApp не допускает использование ботов или неофициальных клиентов на своей платформе, поэтому не следует считать это абсолютно безопасным.

Лицензия

Лицензия Apache версии 2.0 («Лицензия»);
вы не можете использовать этот проект, кроме как в соответствии с Лицензией.
Вы можете получить копию Лицензии по адресу http://www.apache.org/licenses/LICENSE-2.0.

Если это не требуется действующим законодательством или не согласовано в письменной форме, программное обеспечение
распространяется по Лицензии, распространяется на условиях «КАК ЕСТЬ»,
БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ ИЛИ УСЛОВИЙ, явных или подразумеваемых.
См. Лицензию для конкретного языка, регулирующего разрешения и
ограничения по Лицензии.

Расширять

Дополнительная информация