venom

? Bot de veneno?

Venom es un sistema de alto rendimiento desarrollado con JavaScript para crear un bot para WhatsApp, soporte para crear cualquier interacción, como servicio al cliente, envío de medios, reconocimiento de oraciones basado en inteligencia artificial y todo tipo de arquitectura de diseño para WhatsApp.

Aviso: este repositorio ya no se mantiene activamente. Si desea un Bot de WhatsApp de mantenimiento activo, eche un vistazo a Hydra-Bot o el Venom Fork en https://github.com/9CB14C1EC0/venom

¡Comienza rápido y fácil! ¡API oficial!

Documentación completa

Es una API alternativa de alto rendimiento a WhatsApp, puede enviar, mensajes de texto, archivos, imágenes, videos y más.

Recuerde, la API se desarrolló en una plataforma llamada Restful Web Services, que proporciona interoperabilidad entre los sistemas informáticos en Internet.

Utiliza un conjunto de operaciones bien definidas que se aplican a todos los recursos de información: HTTP en sí define un pequeño conjunto de operaciones, la más importante es Post, Get, Put and Elimine.

Úselo en su idioma favorito como PHP, Python, C# y otros. Mientras su idioma sea compatible con el protocolo HTTP, ahorrará tiempo y dinero. No necesita saber cómo funciona Venom, ¡tenemos la documentación completa de la API, de manera profesional!

¡Obtenga nuestro Venom API oficial! ¡Contáctenos!

Venom Group Support on Telegram

Soporte del grupo Venom en Discord

Conocer a los superchats

SuperChats es una biblioteca premium con características únicas que controlan las funciones de WhatsApp con Socket. Con los superchats puede crear bots de servicio, chats multiservicio o cualquier sistema que use WhatsApp

SuperChats es una versión premium de Venom , con características exclusivas y soporte para empresas y desarrolladores de todo el mundo
https://github.com/orkestral/superchats

Comprar una licencia superchats

¡El valor de la licencia es de $ 50 dólares mensuales, para adquirir contacto en WhatsApp haciendo clic en la imagen a continuación!

? Funciones Venom?

? Actualización automática de QR	✔
? Enviar texto, imagen, video, audio y documentos	✔
Obtenga contactos, chats, grupos, miembros del grupo, lista de bloques	✔
? Enviar contactos	✔
Enviar botones	✔
Enviar pegatinas	✔
Enviar pegatinas gif	✔
Múltiples sesiones	✔
⏩ Reenviar mensajes	✔
? Mensaje de recibir	✔
? Insertar la sección de usuario	✔
? Enviar ubicación !!	✔
? y mucho mas	✔

Documentación en https://orkestral.github.io/venom/index.html

Instalación

 > npm i --save venom-bot

o para lanzamientos nocturnos:

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

Instalación del repositorio actual "¡Puede descargar la versión beta del repositorio actual!"

 > npm i github:orkestral/venom

Empezando

 // 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
        } ) ;
    }
  } ) ;
} 

Después de ejecutar la función create() , Venom creará una instancia de WhatsApp Web. Si no ha iniciado sesión, imprimirá un código QR en el terminal. ¡Escanee con su teléfono y estará listo para comenzar!

Venom recordará la sesión, por lo que no hay necesidad de autenticarse cada vez.

Las sesiones de múltiplos se pueden crear al mismo tiempo al fregar un nombre de sesión para create() función:

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

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

Parámetros de creación opcionales

Venom create() Método El tercer parámetro puede tener los siguientes parámetros opcionales:

Si está utilizando el servidor Linux , no olvide pasar los parámetros originales --user-agent en navegador

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

Sesión de estado de devolución de llamada

autocloseCalled serverWssNotConnected initBrowser erroPageWhatsapp deleteToken sesión es isLogged o notLogged o browserClose initWhatsapp qrReadSuccess noOpenBrowser qrReadFail openBrowser desconnectedMobile chatsAvailable connectBrowserWs deviceNotConnected successPageWhatsapp o waitForLogin o waitChat o successChat o Create session wss return "serverClose" case server for close

Estado	Condición
isLogged	Cuando el usuario ya ha iniciado sesión en el navegador
notLogged	Cuando el usuario no está conectado al navegador, es necesario escanear el código QR a través del teléfono celular en la opción WhatsApp Web
browserClose	Si el navegador está cerrado, se devuelve este parámetro
qrReadSuccess	Si el usuario no está iniciado, el código QR se pasa en el terminal Se devuelve una devolución de llamada. Después de la lectura correcta por teléfono celular, se devuelve este parámetro
qrReadFail	Si el navegador se detiene cuando el escaneo de código QR está en progreso, se devuelve este parámetro
autocloseCalled	El navegador se cerró usando el comando AutoClose
desconnectedMobile	El cliente se ha desaconsejado en Mobile
serverClose	El cliente se ha desanimado en WSS
deleteToken	Si pasa verdadero dentro de la función
chatsAvailable	Cuando el veneno está conectado a la lista de chat
deviceNotConnected	Chat no disponible porque el teléfono está desconectado (Trying to connect to the phone)
serverWssNotConnected	¡No se encontró la dirección WSS!
noOpenBrowser	No se encontró en el navegador, o falta algún comando en Args
initBrowser	Comenzando el navegador
openBrowser	¡El navegador se ha abierto con éxito!
connectBrowserWs	¡Conexión con Browserws hecha con éxito!
initWhatsapp	¡Comenzando whatsapp!
erroPageWhatsapp	Error a acceder a la página de WhatsApp
successPageWhatsapp	Página WhatsApp accedida correctamente
waitForLogin	¡Esperando la verificación de inicio de sesión!
waitChat	Esperando que la chat se cargue
successChat	¡Chatear con éxito!

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

Exportación del código QR

Por defecto, el código QR aparecerá en el terminal. Si necesita pasar el QR en otro lugar, aquí hay cómo:

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

Descargar archivos

Puppeteer se encarga de la descarga de archivos. El descifrado se está haciendo lo más rápido posible (supera los métodos nativos). ¡Admite grandes archivos!

 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 ) => {
      ...
    } ) ;
  }
} ) ; 

Funciones básicas (uso)

No todas las funciones disponibles se enumeran, para ver más, cada función disponible se puede encontrar aquí y aquí

Chatear

Aquí, chatId podría ser <phoneNumber>@c.us o <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 ) ; 

Recuperar datos

 // 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
  } ) ; 

Funciones grupales

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

Funciones de perfil

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

Funciones del dispositivo

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

Eventos

 //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 => {
  ...
} ) ; 

Otro

 //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]' ) ; 

Maga

Hay algunos trucos para un mejor uso de veneno.

Mantenga viva la sesión:

 // 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" ) ;
} ) ; 

Sesiones de cierre (guardado)

Cierre la sesión correctamente para asegurarse de que la sesión se guarde la próxima vez que inicie sesión (para que no solicite el escaneo QR nuevamente). Entonces, en lugar de Ctrl+C,

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

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

Cierre automático de sesiones no sincronizadas

El cierre automático está habilitado de forma predeterminada y el tiempo de espera se establece en 60 segundos. Recibe el tiempo en milisegundos para la cuenta regresiva hasta que se combina.

Use "AutoClose: 0 | False" para deshabilitar el cierre automático.

Depuración

Versiones web de WhatsApp

Puede usar versiones en caché de WhatsApp Web pasando los argumentos webVersion como parte de sus opciones de veneno:

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

Esta característica puede usar cualquier versión disponible en la lista en https://github.com/wppconnect-team/wa-version/tree/main/html

Desarrollo

Construir el veneno es realmente simple, aunque contiene 3 proyectos principales en el interior

1. Proyecto WAPI

 > npm run build:wapi

2. Middleware

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

3. Veneno

 > npm run build:venom

Para construir todo el proyecto, solo se ejecuta

 > npm run build

Mantenedores

Se necesitan mantenedores, no puedo seguir con todas las actualizaciones por mí mismo. Si está interesado, abra una solicitud de extracción.

Que contribuye

Las solicitudes de extracción son bienvenidas. Para cambios importantes, abra primero un problema para discutir lo que le gustaría cambiar.