venom

? Venom bot?

Venom est un système haute performance développé avec JavaScript pour créer un bot pour WhatsApp, une prise en charge de la création d'une interaction, telle que le service client, l'envoi de médias, la reconnaissance de phrases basée sur l'intelligence artificielle et tous les types d'architecture de conception pour WhatsApp.

AVIS: Ce référentiel n'est plus activement maintenu. Si vous voulez un bot WhatsApp activement entretenu, jetez un œil à Hydra-Bot ou à Venom Fork sur https://github.com/9cb14c1ec0/venom

Commencez rapidement et facile! API officielle!

Documentation complète

Il s'agit d'une API alternative haute performance à WhatsApp, vous pouvez envoyer, des messages texte, des fichiers, des images, des vidéos et plus encore.

N'oubliez pas que l'API a été développée sur une plate-forme appelée RESTFul Web Services, offrant l'interopérabilité entre les systèmes informatiques sur Internet.

Il utilise un ensemble d'opérations bien définies qui s'appliquent à toutes les ressources d'information: HTTP lui-même définit un petit ensemble d'opérations, le plus important étant publié, obtenez, mettez et supprime.

Utilisez-le dans votre langue préférée comme PHP, Python, C # et autres. Tant que votre langue est soutenue par le protocole HTTP, vous économiserez du temps et de l'argent. Vous n'avez pas besoin de savoir comment fonctionne Venom, nous avons la documentation complète de l'API, de manière professionnelle!

Obtenez notre venin API officiel! Contactez-nous!

Support de groupe Venom sur Telegram

Support de groupe Venom sur Discord

Rencontrez les Superchats

Superchats est une bibliothèque premium avec des fonctionnalités uniques qui contrôlent les fonctions WhatsApp avec socket. Avec Superchats, vous pouvez créer des bots de service, des chats multi-services ou tout système qui utilise WhatsApp

Superchats est une version premium de Venom , avec des fonctionnalités exclusives et un support pour les entreprises et les développeurs du monde entier
https://github.com/orkestral/superchats

Acheter une licence Superchats

La valeur de la licence est de 50 $ mensuelles, pour acquérir des contacts dans WhatsApp en cliquant sur l'image ci-dessous !!

?? Fonctions venin ??

? Rafraîchissement automatique du QR	✔
? Envoyer du texte, de l'image, de la vidéo, de l'audio et des documents	✔
Obtenez des contacts, des chats, des groupes, des membres du groupe, une liste de blocs	✔
? Envoyer des contacts	✔
Envoyer des boutons	✔
Envoyer des autocollants	✔
Envoyer des autocollants GIF	✔
Plusieurs séances	✔
⏩ Messages à terme	✔
? Recevoir un message	✔
? Insérer la section utilisateur	✔
? Envoyez l'emplacement !!	✔
?? Et bien plus encore	✔

Documentation à https://orkestral.github.io/venom/index.html

Installation

 > npm i --save venom-bot

ou pour les versions nocturnes:

 > npm i --save https://github.com/orkestral/venom/releases/download/nightly/venom-bot-nightly.tgz

Installation du référentiel actuel "Vous pouvez télécharger la version bêta du référentiel actuel!"

 > npm i github:orkestral/venom

Commencer

 // Supports ES6
// import { create, Whatsapp } from 'venom-bot';
const venom = require ( 'venom-bot' ) ;

venom
  . create ( {
    session : 'session-name' //name of session
  } )
  . then ( ( client ) => start ( client ) )
  . catch ( ( erro ) => {
    console . log ( erro ) ;
  } ) ;

function start ( client ) {
  client . onMessage ( ( message ) => {
    if ( message . body === 'Hi' && message . isGroupMsg === false ) {
      client
        . sendText ( message . from , 'Welcome Venom ?' )
        . then ( ( result ) => {
          console . log ( 'Result: ' , result ) ; //return object success
        } )
        . catch ( ( erro ) => {
          console . error ( 'Error when sending: ' , erro ) ; //return object error
        } ) ;
    }
  } ) ;
} 

Après avoir exécuté la fonction create() , Venom créera une instance de WhatsApp Web. Si vous n'êtes pas connecté, il imprimera un code QR dans le terminal. Scannez-le avec votre téléphone et vous êtes prêt à partir!

Venom se souviendra de la session, il n'est donc pas nécessaire de s'authentifier à chaque fois.

Les séances de multiples peuvent être créées en même temps en passant un nom de session pour create() Fonction:

 // Init sales whatsapp bot
venom . create ( 'sales' ) . then ( ( salesClient ) => { ... } ) ;

// Init support whatsapp bot
venom . create ( 'support' ) . then ( ( supportClient ) => { ... } ) ; 

Création facultative Paramètres

Venom create() Méthode Le troisième paramètre peut avoir les paramètres facultatifs suivants:

Si vous utilisez le serveur Linux , n'oubliez pas de passer les paramètres d'origine ARGS --user-agent dans Browserargs

 const venom = require ( 'venom-bot' ) ;

venom
  . create (
    //session
    'sessionName' , //Pass the name of the client you want to start the bot
    //catchQR
    ( base64Qrimg , asciiQR , attempts , urlCode ) => {
      console . log ( 'Number of attempts to read the qrcode: ' , attempts ) ;
      console . log ( 'Terminal qrcode: ' , asciiQR ) ;
      console . log ( 'base64 image string qrcode: ' , base64Qrimg ) ;
      console . log ( 'urlCode (data-ref): ' , urlCode ) ;
    } ,
    // statusFind
    ( statusSession , session ) => {
      console . log ( 'Status Session: ' , statusSession ) ; //return isLogged || notLogged || browserClose || qrReadSuccess || qrReadFail || autocloseCalled || desconnectedMobile || deleteToken || chatsAvailable || deviceNotConnected || serverWssNotConnected || noOpenBrowser || initBrowser || openBrowser || connectBrowserWs || initWhatsapp || erroPageWhatsapp || successPageWhatsapp || waitForLogin || waitChat || successChat
      //Create session wss return "serverClose" case server for close
      console . log ( 'Session name: ' , session ) ;
    } ,
    // options
    {
      browserPathExecutable : '' , // browser executable path
      folderNameToken : 'tokens' , //folder name when saving tokens
      mkdirFolderToken : '' , //folder directory tokens, just inside the venom folder, example:  { mkdirFolderToken: '/node_modules', } //will save the tokens folder in the node_modules directory
      headless : 'new' , // you should no longer use boolean false or true, now use false, true or 'new' learn more https://developer.chrome.com/articles/new-headless/
      devtools : false , // Open devtools by default
      debug : false , // Opens a debug session
      logQR : true , // Logs QR automatically in terminal
      browserWS : '' , // If u want to use browserWSEndpoint
      browserArgs : [ '' ] , // Original parameters  ---Parameters to be added into the chrome browser instance
      addBrowserArgs : [ '' ] , // Add broserArgs without overwriting the project's original
      puppeteerOptions : { } , // Will be passed to puppeteer.launch
      disableSpins : true , // Will disable Spinnies animation, useful for containers (docker) for a better log
      disableWelcome : true , // Will disable the welcoming message which appears in the beginning
      updatesLog : true , // Logs info updates automatically in terminal
      autoClose : 60000 , // Automatically closes the venom-bot only when scanning the QR code (default 60 seconds, if you want to turn it off, assign 0 or false)
      createPathFileToken : false , // creates a folder when inserting an object in the client's browser, to work it is necessary to pass the parameters in the function create browserSessionToken
      addProxy : [ '' ] , // Add proxy server exemple : [e1.p.webshare.io:01, e1.p.webshare.io:01]
      userProxy : '' , // Proxy login username
      userPass : '' // Proxy password
    } ,

    // BrowserInstance
    ( browser , waPage ) => {
      console . log ( 'Browser PID:' , browser . process ( ) . pid ) ;
      waPage . screenshot ( { path : 'screenshot.png' } ) ;
    }
  )
  . then ( ( client ) => {
    start ( client ) ;
  } )
  . catch ( ( erro ) => {
    console . log ( erro ) ;
  } ) ; 

Session d'état de rappel

Gets the return if the session is isLogged or notLogged or browserClose or qrReadSuccess or qrReadFail or autocloseCalled or desconnectedMobile or deleteToken or chatsAvailable or deviceNotConnected or serverWssNotConnected or noOpenBrowser or initBrowser or openBrowser or connectBrowserWs or initWhatsapp or erroPageWhatsapp ou successPageWhatsapp ou waitForLogin ou waitChat ou successChat ou Create session wss return "serverClose" case server for close

Statut	Condition
isLogged	Lorsque l'utilisateur est déjà connecté au navigateur
notLogged	Lorsque l'utilisateur n'est pas connecté au navigateur, il est nécessaire de scanner le code QR via le téléphone portable dans l'option whatsApp Web
browserClose	Si le navigateur est fermé, ce paramètre est retourné
qrReadSuccess	Si l'utilisateur n'est pas connecté, le code QR est transmis sur le terminal, un rappel est renvoyé. Après la lecture correcte par téléphone portable, ce paramètre est retourné
qrReadFail	Si le navigateur s'arrête lorsque la numérisation du code QR est en cours, ce paramètre est renvoyé
autocloseCalled	Le navigateur a été fermé à l'aide de la commande AutoClose
desconnectedMobile	Le client est descendu au mobile
serverClose	Le client est tombé sur WSS
deleteToken	Si vous passez vrai dans la fonction
chatsAvailable	Lorsque Venom est connecté à la liste de discussion
deviceNotConnected	Chat non disponible car le téléphone est déconnecté (Trying to connect to the phone)
serverWssNotConnected	L'adresse WSS n'a pas été trouvée!
noOpenBrowser	Il n'a pas été trouvé dans le navigateur, ou une commande est manquante dans les args
initBrowser	Démarrer le navigateur
openBrowser	Le navigateur a été ouvert avec succès!
connectBrowserWs	Connexion avec Browserws avec succès!
initWhatsapp	Commencer WhatsApp!
erroPageWhatsapp	Erreur accéder à la page WhatsApp
successPageWhatsapp	Page WhatsApp accessible avec succès
waitForLogin	En attendant la vérification de la connexion!
waitChat	En attendant que le chat se charge
successChat	CHAT CHARDET avec succès!

 const venom = require ( 'venom-bot' ) ;
venom
  . create ( 'sessionName' , undefined , ( statusSession , session ) => {
    console . log ( 'Status Session: ' , statusSession ) ;
    //return isLogged || notLogged || browserClose || qrReadSuccess || qrReadFail || autocloseCalled || desconnectedMobile || deleteToken || chatsAvailable || deviceNotConnected || serverWssNotConnected || noOpenBrowser || initBrowser || openBrowser || connectBrowserWs || initWhatsapp || erroPageWhatsapp || successPageWhatsapp || waitForLogin || waitChat || successChat
    //Create session wss return "serverClose" case server for close
    console . log ( 'Session name: ' , session ) ;
  } )
  . then ( ( client ) => {
    start ( client ) ;
  } )
  . catch ( ( erro ) => {
    console . log ( erro ) ;
  } ) ; 

Exportation du code QR

Par défaut, le code QR apparaîtra sur le terminal. Si vous avez besoin de passer le QR ailleurs, voici comment:

 const fs = require ( 'fs' ) ;
const venom = require ( 'venom-bot' ) ;

venom
  . create (
    'sessionName' ,
    ( base64Qr , asciiQR , attempts , urlCode ) => {
      console . log ( asciiQR ) ; // Optional to log the QR in the terminal
      var matches = base64Qr . match ( / ^data:([A-Za-z-+/]+);base64,(.+)$ / ) ,
        response = { } ;

      if ( matches . length !== 3 ) {
        return new Error ( 'Invalid input string' ) ;
      }
      response . type = matches [ 1 ] ;
      response . data = new Buffer . from ( matches [ 2 ] , 'base64' ) ;

      var imageBuffer = response ;
      require ( 'fs' ) . writeFile (
        'out.png' ,
        imageBuffer [ 'data' ] ,
        'binary' ,
        function ( err ) {
          if ( err != null ) {
            console . log ( err ) ;
          }
        }
      ) ;
    } ,
    undefined ,
    { logQR : false }
  )
  . then ( ( client ) => {
    start ( client ) ;
  } )
  . catch ( ( erro ) => {
    console . log ( erro ) ;
  } ) ; 

Fichiers à téléchargement

Le marionnettiste s'occupe du téléchargement de fichiers. Le décryptage se fait le plus rapidement possible (dépasser les méthodes natives). Prend en charge les gros fichiers!

 import fs = require ( 'fs' ) ;
import mime = require ( 'mime-types' ) ;

client . onMessage ( async ( message ) => {
  if ( message . isMedia === true || message . isMMS === true ) {
    const buffer = await client . decryptFile ( message ) ;
    // At this point you can do whatever you want with the buffer
    // Most likely you want to write it into a file
    const fileName = `some-file-name. ${ mime . extension ( message . mimetype ) } ` ;
    fs . writeFile ( fileName , buffer , ( err ) => {
      ...
    } ) ;
  }
} ) ; 

Fonctions de base (utilisation)

Toutes les fonctions disponibles ne sont pas répertoriées, pour plus de regard, toutes les fonctions disponibles peuvent être trouvées ici et ici

Bavardage

Ici, chatId pourrait être <phoneNumber>@c.us ou <phoneNumber>-<groupId>@g.us

 // Send Poll
const poll = {
  name : 'new poll' ,
  options : [
    {
      name : 'option 1'
    } ,
    {
      name : 'option 2'
    }
  ] ,
  selectableOptionsCount : 1
} ;
await client . sendPollCreation ( '[email protected]' , poll )
. then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
} )
. catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
} ) ;

// Send List menu
const list = [
    {
      title : "Pasta" ,
      rows : [
        {
          title : "Ravioli Lasagna" ,
          description : "Made with layers of frozen cheese" ,
        }
      ]
    } ,
    {
      title : "Dessert" ,
      rows : [
        {
          title : "Baked Ricotta Cake" ,
          description : "Sweets pecan baklava rolls" ,
        } ,
        {
          title : "Lemon Meringue Pie" ,
          description : "Pastry filled with lemonand meringue." ,
        }
      ]
    }
  ] ;

await client . sendListMenu ( '[email protected]' , 'Title' , 'subTitle' , 'Description' , 'menu' , list )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Send Messages with Buttons Reply
const buttons = [
  {
    "buttonText" : {
      "displayText" : "Text of Button 1"
      }
    } ,
  {
    "buttonText" : {
      "displayText" : "Text of Button 2"
      }
    }
  ]
await client . sendButtons ( '[email protected]' , 'Title' , 'Description' , buttons )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;
// Send audio file MP3
await client . sendVoice ( '[email protected]' , './audio.mp3' ) . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Send audio file base64
await client . sendVoiceBase64 ( '[email protected]' , base64MP3 )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Send contact
await client
  . sendContactVcard ( '[email protected]' , '[email protected]' , 'Name of contact' )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Send a list of contact cards
await client
  . sendContactVcardList ( '[email protected]' , [
    '[email protected]' ,
    '[email protected]' ,
  ] )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Send basic text
await client
  . sendText ( '[email protected]' , ' Hello from venom!' )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;


// Send text message by injecting keystrokes into WhatsApp, thus maintaining the typing indicator
let success = await client . sendTextViaTyping ( '[email protected]' , ' Hello from venom!' ) ;

// Send photo or video by injecting keystrokes
let success = await client . sendPhotoVideoViaTyping ( '[email protected]' , 'path/to/file.jpg' , 'Pretty sunset' ) ;

// Send location
await client
  . sendLocation ( '[email protected]' , '-13.6561589' , '-69.7309264' , 'Brasil' )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Automatically sends a link with the auto generated link preview. You can also add a custom message to be added.
await client
  . sendLinkPreview (
    '[email protected]' ,
    'https://www.youtube.com/watch?v=V1bFr2SWP1I' ,
    'Kamakawiwo ole'
  )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Send image (you can also upload an image using a valid HTTP protocol)
await client
  . sendImage (
    '[email protected]' ,
    'path/to/img.jpg' ,
    'image-name' ,
    'Caption text'
  )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;


// Send image file base64
await client . sendImageFromBase64 ( '[email protected]' , base64Image , "name file" )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Send file (venom will take care of mime types, just need the path)
// you can also upload an image using a valid HTTP protocol
await client
  . sendFile (
    '[email protected]' ,
    'path/to/file.pdf' ,
    'file_name' ,
    'See my file in pdf'
  )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Sends file
// base64 parameter should have mime type already defined
await client
  . sendFileFromBase64 (
    '[email protected]' ,
    base64PDF ,
    'file_name.pdf' ,
    'See my file in pdf'
  )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Generates sticker from the provided animated gif image and sends it (Send image as animated sticker)
// image path imageBase64 A valid gif and webp image is required. You can also send via http/https (http://www.website.com/img.gif)
await client
  . sendImageAsStickerGif ( '[email protected]' , './image.gif' )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Generates sticker from given image and sends it (Send Image As Sticker)
// image path imageBase64 A valid png, jpg and webp image is required. You can also send via http/https (http://www.website.com/img.jpg)
await client
  . sendImageAsSticker ( '[email protected]' , './image.jpg' )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Forwards messages
await client . forwardMessages (
  '[email protected]' ,
  [ '[email protected]_B70847EE89E22D20FB86ECA0C1B11609' , '[email protected]_B70847EE89E22D20FB86ECA0C1B11777' ]
) . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
} )
. catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
} ) ;

// Send @tagged message
await client . sendMentioned (
  '[email protected]' ,
  'Hello @5218113130740 and @5218243160777!' ,
  [ '5218113130740' , '5218243160777' ]
) ;

// Reply to a message
await client . reply (
  '[email protected]' ,
  'This is a reply!' ,
  '[email protected]_7C22WHCB6DKYHJKQIEN9'
) . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
} ) . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
} ) ;

// Send message with options
await client .
        . sendMessageOptions (
          '[email protected]' ,
          'This is a reply!' ,
           {
              quotedMessageId : reply ,
            }
        )
        . then ( ( retorno ) => {
          resp = retorno ;
        } )
        . catch ( ( e ) => {
          console . log ( e ) ;
        } ) ;

// Send gif
await client . sendVideoAsGif (
  '[email protected]' ,
  'path/to/video.mp4' ,
  'video.gif' ,
  'Gif image file'
) ;

//checks and returns whether a message and a reply
// exemple:
// await client.onMessage(async (message) => {
//     console.log(await client.returnReply(message)); // replicated message
//     console.log(message.body ); //customer message
//   })
checkReply = await client . returnReply ( messagem ) ;

// Send seen ✔️✔️
await client . sendSeen ( '[email protected]' ) ;

// Start typing...
await client . startTyping ( '[email protected]' ) ;

// Set chat state (0: Typing, 1: Recording, 2: Paused)
await client . setChatState ( '[email protected]' , 0 | 1 | 2 ) ; 

Récupération des données

 // Retrieve all chats
const chats = await client . getAllChats ( ) ;

//Retrieves all chats new messages
const chatsAllNew = getAllChatsNewMsg ( ) ;

//Retrieves all chats Contacts
const contacts = await client . getAllChatsContacts ( ) ;

//Retrieve all contacts new messages
const contactNewMsg = await client . getChatContactNewMsg ( ) ;

// Retrieve all groups
// you can pass the group id optional use, exemple: client.getAllChatsGroups('[email protected]')
const chats = await client . getAllChatsGroups ( ) ;

//Retrieve all groups new messages
const groupNewMsg = await client . getChatGroupNewMsg ( ) ;

//Retrieves all chats Transmission list
const transmission = await client . getAllChatsTransmission ( ) ;

// Retrieve contacts
const contacts = await client . getAllContacts ( ) ;

// Returns a list of mute and non-mute users
// "all" List all mutes
// "toMute" List all silent chats
// "noMute" List all chats without silence
const listMute = await client . getListMute ( 'all' ) ;

// Calls your list of blocked contacts (returns an array)
const getBlockList = await client . getBlockList ( ) ;

// Retrieve messages in chat
//chatID chat id
//includeMe will be by default true, if you do not want to pass false
//includeNotifications will be by default true, if you do not want to pass false
//const Messages = await client.getAllMessagesInChat(chatID, includeMe, includeNotifications)
const Messages = await client . getAllMessagesInChat ( '[email protected]' ) ;

// Retrieve more chat message
const moreMessages = await client . loadEarlierMessages ( '[email protected]' ) ;

// Retrieve all messages in chat
const allMessages = await client . loadAndGetAllMessagesInChat (
  '[email protected]'
) ;

// Retrieve contact status
const status = await client . getStatus ( '[email protected]' ) ;

// Retrieve user profile
// Please note that this function does not currently work due to a bug in WhatsApp itself.
// There is no telling if or when this function might work again.
const user = await client . getNumberProfile ( '[email protected]' ) ;

// Retrieve all unread message
const messages = await client . getUnreadMessages ( ) ;

// Retrieve profile fic (as url)
const url = await client . getProfilePicFromServer ( '[email protected]' ) ;

// Retrieve chat/conversation
const chat = await client . getChat ( '[email protected]' ) ;

// Check if the number exists
const chat = await client
  . checkNumberStatus ( '[email protected]' )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ; 

Fonctions de groupe

 // groupId or chatId: leaveGroup [email protected]

//change group description
await client
  . setGroupDescription ( '[email protected]' , 'group description' )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Leave group
await client . leaveGroup ( '[email protected]' ) ;

// Get group members
await client . getGroupMembers ( '[email protected]' ) ;

// Get group members ids
await client . getGroupMembersIds ( '[email protected]' ) ;

// Generate group invite url link
await client . getGroupInviteLink ( '[email protected]' ) ;

// Create group (title, participants to add)
await client . createGroup ( 'Group name' , [
  '[email protected]' ,
  '[email protected]'
] ) ;

// Remove participant
await client . removeParticipant ( '[email protected]' , '[email protected]' ) ;

// Add participant
await client . addParticipant ( '[email protected]' , '[email protected]' ) ;

// Promote participant (Give admin privileges)
await client . promoteParticipant ( '[email protected]' , '[email protected]' ) ;

// Demote particiapnt (Revoke admin privileges)
await client . demoteParticipant ( '[email protected]' , '[email protected]' ) ;

// Get group admins
await client . getGroupAdmins ( '[email protected]' ) ;

// Return the group status, jid, description from it's invite link
await client . getGroupInfoFromInviteLink ( InviteCode ) ;

// Join a group using the group invite code
await client . joinGroup ( InviteCode ) ; 

Fonctions de profil

 // Set client status
await client . setProfileStatus ( 'On vacations! ✈️' ) ;

// Set client profile name
await client . setProfileName ( 'Venom bot' ) ;

// Set client profile photo
await client . setProfilePic ( 'path/to/image.jpg' ) ;

// Get device info
await client . getHostDevice ( ) ; 

Fonctions de l'appareil

 // Disconnect from service
await client . logout ( ) ;

// Delete the Service Worker
await client . killServiceWorker ( ) ;

// Load the service again
await client . restartService ( ) ;

// Get connection state
await client . getConnectionState ( ) ;

// Get battery level
await client . getBatteryLevel ( ) ;

// Is connected
await client . isConnected ( ) ;

// Get whatsapp web version
await client . getWAVersion ( ) ; 

Événements

 //Listens to all new messages
//To receiver or recipient
client . onAnyMessage ( message => {
  ...
} ;

// Listen to messages
client . onMessage ( message => {
...
} )

// Listen for messages that have been edited
client . onMessageEdit ( message => {
...
} )

// Listen for messages that have been deleted
client . onMessageDelete ( message => {
...
} )

// Listen to state changes
client . onStateChange ( state => {
  ...
} ) ;

// Listen to ack's
// See the status of the message when sent.
// When receiving the confirmation object, "ack" may return a number, look {@link AckType} for details:
// -7 = MD_DOWNGRADE,
// -6 = INACTIVE,
// -5 = CONTENT_UNUPLOADABLE,
// -4 = CONTENT_TOO_BIG,
// -3 = CONTENT_GONE,
// -2 = EXPIRED,
// -1 = FAILED,
//  0 = CLOCK,
//  1 = SENT,
//  2 = RECEIVED,
//  3 = READ,
//  4 = PLAYED =

client . onAck ( ack => {
  ...
} ) ;

// Listen to live location
// chatId: '[email protected]'
client . onLiveLocation ( "[email protected]" , ( liveLocation ) => {
  ...
} ) ;

// chatId looks like this: '[email protected]'
// Event interface is in here: https://github.com/s2click/venom/blob/master/src/api/model/participant-event.ts
client . onParticipantsChanged ( "[email protected]" , ( event ) => {
  ...
} ) ;

// Listen when client has been added to a group
client . onAddedToGroup ( chatEvent => {
  ...
} ) ; 

Autre

 //Check if there is chat
await client
  . checkChat ( chatId )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Pin chat and Unpin chat messages with true or false
// Pin chat, non-existent (optional)
await client
  . pinChat ( chatId , true , false )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

///mute a contact
await client
  . sendMute (
    '[email protected]' , //contact mute
    30 , //duration of silence, example: 30 minutes
    'minutes' ///kind of silence "hours" "minutes" "year"
  )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

///unmute contact
await client
  . sendMute (
    '[email protected]' //contact unmute
  )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Change the theme
// string types "dark" or "light"
await client . setTheme ( 'dark' ) ;

// Receive the current theme
// returns string light or dark
await client . getTheme ( ) ;

// Delete chat
await client . deleteChat ( '[email protected]' ) ;

// Clear chat messages
await client . clearChatMessages ( '[email protected]' ) ;

// Archive and unarchive chat messages with true or false
await client . archiveChat ( chatId , true ) ;

// Delete message (last parameter: delete only locally)
await client
  . deleteMessage ( '[email protected]' , [
    '[email protected]_B70847EE89E22D20FB86ECA0C1B11609' ,
    '[email protected]_B70847EE89E22D20FB86ECA0C1B11777'
  ] )
  . then ( ( result ) => {
    console . log ( 'Result: ' , result ) ; //return object success
  } )
  . catch ( ( erro ) => {
    console . error ( 'Error when sending: ' , erro ) ; //return object error
  } ) ;

// Mark chat as not seen (returns true if it works)
await client . markUnseenMessage ( '[email protected]' ) ;

// Blocks a user (returns true if it works)
await client . blockContact ( '[email protected]' ) ;

// Unlocks contacts (returns true if it works)
await client . unblockContact ( '[email protected]' ) ; 

Mission

Il y a quelques astuces pour une meilleure utilisation du venin.

Gardez la séance en vie:

 // function to detect conflits and change status
// Force it to keep the current session
// Possible state values:
// CONFLICT
// CONNECTED
// DEPRECATED_VERSION
// OPENING
// PAIRING
// PROXYBLOCK
// SMB_TOS_BLOCK
// TIMEOUT
// TOS_BLOCK
// UNLAUNCHED
// UNPAIRED
// UNPAIRED_IDLE
client . onStateChange ( ( state ) => {
  console . log ( 'State changed: ' , state ) ;
  // force whatsapp take over
  if ( 'CONFLICT' . includes ( state ) ) client . useHere ( ) ;
  // detect disconnect on whatsapp
  if ( 'UNPAIRED' . includes ( state ) ) console . log ( 'logout' ) ;
} ) ;

// DISCONNECTED
// SYNCING
// RESUMING
// CONNECTED
let time = 0 ;
client . onStreamChange ( ( state ) => {
  console . log ( 'State Connection Stream: ' + state ) ;
  clearTimeout ( time ) ;
  if ( state === 'DISCONNECTED' || state === 'SYNCING' ) {
    time = setTimeout ( ( ) => {
      client . close ( ) ;
    } , 80000 ) ;
  }
} ) ;

// function to detect incoming call
client . onIncomingCall ( async ( call ) => {
  console . log ( call ) ;
  client . sendText ( call . peerJid , "Sorry, I still can't answer calls" ) ;
} ) ; 

Séances de fermeture (économie)

Fermez correctement la session pour vous assurer que la session est enregistrée pour la prochaine fois que vous vous connectez (afin qu'il ne demande plus la numérisation QR). Donc, au lieu de Ctrl + C,

 // Catch ctrl+C
process . on ( 'SIGINT' , function ( ) {
  client . close ( ) ;
} ) ;

// Try-catch close
try {
   ...
} catch ( error ) {
   client . close ( ) ;
}

Fermeture automatique Séances nonchisées

La fermeture automatique est activée par défaut et le délai d'attente est défini sur 60 sec. Reçoit le temps en millisecondes à Countdown jusqu'à ce qu'il soit jumelé.

Utilisez "AutoClose: 0 | Faux" pour désactiver la fermeture automatique.

Débogage

Versions Web WhatsApp

Vous pouvez utiliser des versions en cache de WhatsApp Web en passant les arguments webVersion dans le cadre de vos options de venin:

 venom . create ( {
    session : 'sessionname' , //name of session
    headless : false ,
    logQR : true ,
    webVersion : '2.2402.5'
  } )
  . then ( ( client ) => {
    start ( client ) ;
  } ) ;

Cette fonctionnalité peut utiliser n'importe quelle version disponible dans la liste à https://github.com/wppconnect-team/wa-version/tree/main/html

Développement

La construction de venin est vraiment simple bien qu'elle contient 3 projets principaux à l'intérieur

1. Projet WAPI

 > npm run build:wapi

2. Middleware

 > npm run build:middleware
> npm run build:jsQR

3. Venin

 > npm run build:venom

Pour construire l'intégralité du projet, il suffit d'exécuter

 > npm run build

Maintient

Les mainteneurs sont nécessaires, je ne peux pas rester avec toutes les mises à jour par moi-même. Si vous êtes intéressé, veuillez ouvrir une demande de traction.

Contributif

Les demandes de traction sont les bienvenues. Pour les changements majeurs, veuillez d'abord ouvrir un problème pour discuter de ce que vous souhaitez changer.