venom
v5.3.0
Venom은 JavaScript를 사용하여 WhatsApp 용 봇을 만들기 위해 개발 한 고성능 시스템이며, 고객 서비스, 미디어 보내기, 인공 지능을 기반으로 한 문장 인식 및 WhatsApp을위한 모든 유형의 설계 아키텍처와 같은 상호 작용을 만드는 지원을 지원합니다.
전체 문서
WhatsApp에 대한 고성능 대안 API입니다. 문자 메시지, 파일, 이미지, 비디오 등을 보낼 수 있습니다.
API는 인터넷의 컴퓨터 시스템간에 상호 운용성을 제공하는 Restful Web Services라는 플랫폼에서 개발되었습니다.
HTTP 자체는 소규모 작업 세트를 정의하고 가장 중요한 것은 게시, Get, Put 및 Delete입니다.
PHP, Python, C# 등과 같은 좋아하는 언어로 사용하십시오. 귀하의 언어가 HTTP 프로토콜을 지원하는 한 시간과 비용을 절약 할 수 있습니다. Venom이 어떻게 작동하는지 알 필요는 없으며 전문적인 방식으로 완전한 API 문서를 가지고 있습니다!
Superchats는 소켓으로 WhatsApp 기능을 제어하는 고유 한 기능을 갖춘 프리미엄 라이브러리입니다. 슈퍼 차트를 사용하면 서비스 봇, 멀티 서비스 채팅 또는 WhatsApp을 사용하는 시스템을 만들 수 있습니다.
Superchats는 전 세계 회사 및 개발자를위한 독점적 인 기능과 지원을 제공하는 Venom 의 프리미엄 버전입니다.
https://github.com/orkestral/superchats
라이센스의 가치는 월 $ 50 달러이며 아래 이미지를 클릭하여 WhatsApp에서 연락을 취합니다 !!
| ? 자동 QR 새로 고침 | ✔ |
| ? 텍스트, 이미지, 비디오, 오디오 및 문서를 보내십시오 | ✔ |
| 연락처, 채팅, 그룹, 그룹 멤버, 블록 목록을 받으십시오 | ✔ |
| ? 연락처를 보냅니다 | ✔ |
| 버튼을 보내십시오 | ✔ |
| 스티커를 보내십시오 | ✔ |
| 스티커 gif를 보내십시오 | ✔ |
| 여러 세션 | ✔ |
| ⏩ 전달 메시지 | ✔ |
| ? 메시지를받습니다 | ✔ |
| ? 사용자 섹션을 삽입하십시오 | ✔ |
| ? 위치 보내기 !! | ✔ |
| ?? 그리고 훨씬 더 | ✔ |
https://orkestral.github.io/venom/index.html의 문서
> npm i --save venom-bot또는 야간 릴리스 :
> npm i --save https://github.com/orkestral/venom/releases/download/nightly/venom-bot-nightly.tgz현재 저장소 설치 "현재 저장소에서 베타 버전을 다운로드 할 수 있습니다!"
> npm i github:orkestral/venom // 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
} ) ;
}
} ) ;
} create() 함수를 실행 한 후 Venom은 WhatsApp 웹의 인스턴스를 만듭니다. 로그인하지 않은 경우 터미널에 QR 코드가 인쇄됩니다. 휴대 전화로 스캔하면 갈 준비가되었습니다! create() 하여 동시에 만들 수 있습니다. // Init sales whatsapp bot
venom . create ( 'sales' ) . then ( ( salesClient ) => { ... } ) ;
// Init support whatsapp bot
venom . create ( 'support' ) . then ( ( supportClient ) => { ... } ) ; Venom create() 메소드 세 번째 매개 변수는 다음과 같은 선택적 매개 변수를 가질 수 있습니다.
Linux 서버를 사용하는 경우 Browserargs의 Args --user-agent 원본 매개 변수)를 전달하는 것을 잊지 마십시오.
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 ) ;
} ) ; 세션이 isLogged 또는 notLogged 또는 browserClose 또는 qrReadSuccess 또는 qrReadFail 또는 autocloseCalled 또는 desconnectedMobile 또는 deleteToken 또는 chatsAvailable 또는 deviceNotConnected 또는 devicenotconnected 또는 serverWssNotConnected 또는 noOpenBrowser 또는 initBrowser 또는 openBrowser 또는 connectBrowserWs or the initport 또는 interport or initWhatsapp 또는 erroPageWhatsapp 또는 int successPageWhatsapp 또는 waitForLogin 또는 waitChat 또는 successChat 또는 Create session wss return "serverClose" case server for close
| 상태 | 상태 |
|---|---|
isLogged | 사용자가 이미 브라우저에 로그인 한 경우 |
notLogged | 사용자가 브라우저에 연결되지 않은 경우 whatsapp 웹 옵션에서 휴대 전화를 통해 QR 코드를 스캔해야합니다. |
browserClose | 브라우저가 닫히면이 매개 변수가 반환됩니다 |
qrReadSuccess | 사용자가 로그인되지 않으면 QR 코드가 터미널에 전달됩니다. 콜백이 반환됩니다. 휴대 전화로 올바른 읽기 후이 매개 변수는 반환됩니다. |
qrReadFail | QR 코드 스캔이 진행 중이면 브라우저가 중지되면이 매개 변수가 반환됩니다. |
autocloseCalled | Autoclose 명령을 사용하여 브라우저가 닫혔습니다 |
desconnectedMobile | 클라이언트는 모바일에 연결되었습니다 |
serverClose | 고객은 WSS에 연결되어 있습니다 |
deleteToken | 함수 내에서 true를 전달하는 경우 |
chatsAvailable | Venom이 채팅 목록에 연결되면 |
deviceNotConnected | 전화가 연결이 끊어져서 채팅을 할 수 없습니다 (Trying to connect to the phone) |
serverWssNotConnected | 주소 WSS를 찾을 수 없었습니다! |
noOpenBrowser | 브라우저에서는 발견되지 않았거나 일부 명령이 Args에서 누락되었습니다. |
initBrowser | 브라우저 시작 |
openBrowser | 브라우저가 성공적으로 열렸습니다! |
connectBrowserWs | Browserws와의 연결이 성공적으로 수행되었습니다! |
initWhatsapp | WhatsApp 시작! |
erroPageWhatsapp | whatsapp 페이지에 액세스하는 오류 |
successPageWhatsapp | Page WhatsApp가 성공적으로 액세스했습니다 |
waitForLogin | 로그인 확인을 기다리고 있습니다! |
waitChat | 채팅이로드되기를 기다리고 있습니다 |
successChat | 채팅이 성공적으로로드되었습니다! |
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 ) ;
} ) ; 기본적으로 QR 코드가 터미널에 나타납니다. 다른 곳에서 QR을 통과 해야하는 경우 다음과 같은 방법이 있습니다.
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 ) ;
} ) ; 인형극은 파일 다운로드를 처리합니다. 암호 해독은 가능한 빨리 수행되고 있습니다 (기본 방법을 능가). 큰 파일을 지원합니다!
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 ) => {
...
} ) ;
}
} ) ; 모든 사용 가능한 기능이 나열되는 것은 아니며, 추가로 사용 가능한 모든 기능을 여기와 여기에서 찾을 수 있습니다.
chatId <phoneNumber>@c.us 또는 <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 ) ; // 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
} ) ; // 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 ) ; // 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 ( ) ; // 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 ( ) ; //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 => {
...
} ) ; //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]' ) ; 독을 더 잘 사용하기위한 몇 가지 요령이 있습니다.
// 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" ) ;
} ) ; 다음에 로그인 할 때 세션이 저장되도록 세션을 올바르게 닫으십시오 (QR 스캔을 다시 요청하지 않으므로). Ctrl+C 대신
// Catch ctrl+C
process . on ( 'SIGINT' , function ( ) {
client . close ( ) ;
} ) ;
// Try-catch close
try {
...
} catch ( error ) {
client . close ( ) ;
}자동 클로즈는 기본적으로 활성화되며 타임 아웃은 60 초로 설정됩니다. 쌍을 이루기 전까지 밀리 초까지 시간을받습니다.
"autoclose : 0 | false"를 사용하여 자동 폐쇄를 비활성화하십시오.
Venom 옵션의 일부로 webVersion 인수를 전달하여 캐시 된 버전의 WhatsApp 웹을 사용할 수 있습니다.
venom . create ( {
session : 'sessionname' , //name of session
headless : false ,
logQR : true ,
webVersion : '2.2402.5'
} )
. then ( ( client ) => {
start ( client ) ;
} ) ;이 기능은 https://github.com/wppconnect-team/wa-version/tree/main/html에서 사용 가능한 모든 버전을 사용할 수 있습니다.
Venom Building Venom은 내부에 3 개의 주요 프로젝트가 포함되어 있지만 정말 간단합니다.
> npm run build:wapi > npm run build:middleware
> npm run build:jsQR > npm run build:venom전체 프로젝트를 구축하려면 방금 실행됩니다
> npm run build관리자가 필요합니다. 모든 업데이트를 혼자서 유지할 수는 없습니다. 관심이 있으시면 풀 요청을여십시오.
풀 요청을 환영합니다. 주요 변경 사항을 위해 먼저 문제를 열어 변경하고 싶은 것을 논의하십시오.
