À propos

Un client API WhatsApp qui se connecte via l'application de navigateur Web WhatsApp

La bibliothèque fonctionne en lançant l'application du navigateur Web WhatsApp et en la gérant à l'aide de Puppeteer pour créer une instance de WhatsApp Web, atténuant ainsi le risque d'être bloqué. Le client API WhatsApp se connecte via l'application de navigateur Web WhatsApp, accédant à ses fonctions internes. Cela vous donne accès à presque toutes les fonctionnalités disponibles sur WhatsApp Web, permettant une gestion dynamique similaire à n'importe quelle autre application Node.js.

Important

Il n'est pas garanti que vous ne serez pas bloqué en utilisant cette méthode. WhatsApp n'autorise pas les robots ou les clients non officiels sur sa plateforme, cela ne doit donc pas être considéré comme totalement sûr.

Links

Site web
Guide (source) (travail en cours)
Documentation (source)
Discorde WWebJS
GitHub
npm

Installation

Le module est désormais disponible sur npm ! npm i whatsapp-web.js

Note

Le nœud v18+ est requis.

ÉTAPES RAPIDES POUR METTRE À NIVEAU LE NŒUD

Fenêtres

Manuel

Obtenez simplement la dernière LTS sur le site Web officiel du nœud.

npm

sudo npm install - g n
sudo n stable

Choco

choco install nodejs - lts

Aile

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

Exemple d'utilisation

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

Jetez un œil à example.js pour d'autres exemples avec des cas d'utilisation supplémentaires.
Pour plus de détails sur l'enregistrement et la restauration des sessions, explorez les stratégies d'authentification fournies.

Fonctionnalités prises en charge

Fonctionnalité	Statut
Multi-appareil	✅
Envoyer des messages	✅
Recevoir des messages	✅
Envoyer des médias (images/audio/documents)	✅
Envoyer des médias (vidéo)	✅ (nécessite Google Chrome)
Envoyer des autocollants	✅
Recevoir des médias (images/audio/vidéo/documents)	✅
Envoyer des fiches de contact	✅
Envoyer l'emplacement	✅
Boutons d'envoi	❌ (OBSERVÉ)
Envoyer des listes	❌ (OBSERVÉ)
Emplacement de réception	✅
Réponses aux messages	✅
Rejoignez des groupes par invitation	✅
Recevoir une invitation pour un groupe	✅
Modifier les informations du groupe (sujet, description)	✅
Modifier les paramètres du groupe (envoyer des messages, modifier les informations)	✅
Ajouter des participants au groupe	✅
Participants au groupe de kick	✅
Promouvoir/rétrograder les participants du groupe	✅
Mentionner les utilisateurs	✅
Mentionner des groupes	✅
Activer/désactiver les discussions	✅
Bloquer/débloquer des contacts	✅
Obtenir les coordonnées	✅
Obtenez des photos de profil	✅
Définir le message d'état de l'utilisateur	✅
Réagissez aux messages	✅
Créer des sondages	✅
Votez dans les sondages
Communautés
Canaux

Il manque quelque chose ? Faites un problème et faites-le nous savoir !

Contribuer

N'hésitez pas à ouvrir des demandes de tirage ; nous apprécions les contributions! Cependant, pour des changements importants, il est préférable d'ouvrir un ticket au préalable. Assurez-vous de consulter nos directives de contribution avant de créer une pull request. Avant de créer votre propre problème ou pull request, vérifiez toujours s’il en existe déjà un !

Accompagner le projet

Vous pouvez soutenir le responsable de ce projet via les liens ci-dessous

Assistance via les sponsors GitHub
Assistance via PayPal
Inscrivez-vous à DigitalOcean et obtenez 200 $ de crédit lors de votre inscription (parrainage)

Clause de non-responsabilité

Ce projet n'est pas affilié, associé, autorisé, approuvé par ou officiellement connecté de quelque manière que ce soit à WhatsApp ou à l'une de ses filiales ou de ses sociétés affiliées. Le site Web officiel de WhatsApp peut être trouvé sur WhatsApp.com. « WhatsApp » ainsi que les noms, marques, emblèmes et images associés sont des marques déposées de leurs propriétaires respectifs. Il n’est pas non plus garanti que vous ne serez pas bloqué en utilisant cette méthode. WhatsApp n'autorise pas les robots ou les clients non officiels sur sa plateforme, cela ne doit donc pas être considéré comme totalement sûr.

Licence

Sous licence Apache, version 2.0 (la « Licence » );
vous ne pouvez pas utiliser ce projet sauf en conformité avec la licence.
Vous pouvez obtenir une copie de la licence sur http://www.apache.org/licenses/LICENSE-2.0.

Sauf si requis par la loi applicable ou convenu par écrit, le logiciel
distribué sous la Licence est distribué sur une BASE « TEL QUEL »,
SANS GARANTIE NI CONDITIONS D'AUCUNE SORTE, expresses ou implicites.
Consultez la licence pour connaître la langue spécifique régissant les autorisations et
limitations en vertu de la licence.

Développer

Informations supplémentaires