O Venom é um sistema de alto desempenho desenvolvido em JavaScript para criar um bot para o WhatsApp, com suporte para criar qualquer interação, como atendimento ao cliente, envio de mídia, reconhecimento de frases com base em inteligência artificial e todos os tipos de arquitetura de design para WhatsApp.
É uma API de alternativa de alto desempenho para o Whatzapp, você pode enviar mensagens de texto, arquivos, imagens, vídeos e muito mais.
Lembre-se, a API foi desenvolvida em uma plataforma chamada Serviços da Web RESTful, fornecendo interoperabilidade entre sistemas de computador na Internet.
Ele usa um conjunto de operações bem definidas que se aplicam a todos os recursos de informação: HTTP em si define um pequeno conjunto de operações, as mais importantes são POST, GET, PUT e DELETE.
Use-a na sua linguagem preferida como PHP, Python, C# e outras. Contanto que sua linguagem seja suportada pelo protocolo HTTP, você economizará tempo e dinheiro. Você não precisa saber como o Venom funciona, temos a documentação completa da API, de uma forma profissional!
/i.s3.glbimg.com/v1/AUTH_63b422c2caee4269b8b34177e8876b93/internal_photos/bs/2021/d/N/zJs579QOGxKVRxfPILCA/discord-app.png "Discord")
SuperChats é uma biblioteca premium com recursos exclusivos que controlam as funções do Whatsapp com socket. Com Superchats, você pode criar chatbots de serviço, chats multisserviços ou qualquer sistema que use o Whatsapp.
Superchats é uma versão premium do Venom, com recursos exclusivos e suporte para empresas e desenvolvedores em todo o mundo.
https://github.com/orkestral/superchats
O valor da licença é de $50 dólares mensais, para comprar, entre em contato pelo Whatsapp clicando na imagem abaixo!!
| 🚻 Atualização automática do QR | ✔ |
| 📁 Envie texto, imagem, vídeo, áudio e documentos | ✔ |
| 👥 Obtenha contatos, conversas, grupos, membros de grupo, lista de bloqueios | ✔ |
| 📞 Envie contatos | ✔ |
| Enviar botões | ✔ |
| Enviar adesivos | ✔ |
| Enviar adesivos GIF | ✔ |
| Múltiplas sessões | ✔ |
| ⏩ Encaminhar mensagens | ✔ |
| 📥 Receber mensagem | ✔ |
| 👤 Inserir seção de usuário | ✔ |
| 📍 Enviar localização!! | ✔ |
| 🕸🕸 e muito mais | ✔ |
Documentação em https://orkestral.github.io/venom/index.html
> npm i --save venom-botou para [Releases Noturnas] (https://github.com/orkestral/venom/releases/tag/nightly):
> npm i --save https://github.com/orkestral/venom/releases/download/nightly/venom-bot-nightly.tgzInstalando o repositório atual "você pode baixar a versão beta do repositório atual!"
> 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
});
}
});
}Após executar a função create(), o venom criará uma instância do whatsapp web. Se você não estiver conectado, ele imprimirá um código QR no terminal. Digitalize-o com seu telefone e você estará pronto para começar!
// Init sales whatsapp bot
venom.create('sales').then((salesClient) => {...});
// Init support whatsapp bot
venom.create('support').then((supportClient) => {...});O terceiro parâmetro do método create() do Venom pode ter os seguintes parâmetros opcionais:
Se você estiver usando o servidor Linux, não se esqueça de passar os argumentos --user-agent
Parâmetros originais em browserArgs
(bloco de código omitido-c16b59)Retorna se a sessão está isLogged ou notLogged ou browserClose ou qrReadSuccess ou qrReadFail ou autocloseCalled ou desconnectedMobile ou deleteToken ou chatsAvailable ou deviceNotConnected ou serverWssNotConnected ou noOpenBrowser or initBrowser or openBrowser or connectBrowserWs or initWhatsapp or erroPageWhatsapp or successPageWhatsapp or waitForLogin or waitChat or successChat or Create session wss return "serverClose" case server for close
| Status | Condição |
|---|---|
isLogged |
Quando o usuário já está conectado no navegador |
notLogged |
Quando o usuário não está conectado no navegador, é necessário escanear o código QR pelo celular na opção WhatsApp Web |
browserClose |
Se o navegador for fechado, esse parâmetro é retornado |
qrReadSuccess |
Se o usuário não estiver conectado, o código QR é mostrado no terminal e um retorno é passado. Após a leitura correta pelo celular, esse parâmetro é retornado |
qrReadFail |
Se o navegador parar quando o código QR estiver em processo de escaneamento, este parâmetro será retornado |
autocloseCalled |
O navegador foi fechado usando o comando autoClose |
desconnectedMobile |
O cliente desconectou-se em relação ao celular |
serverClose |
O cliente desconectou-se em relação ao wss |
deleteToken |
Se você passar verdadeiro dentro da função |
chatsAvailable |
Quando Venom está conectado à lista de chats |
deviceNotConnected |
Chat indisponível porque o celular não está conectado (tentando se conectar ao celular) |
serverWssNotConnected |
O endereço wss não foi encontrado! |
noOpenBrowser |
Não foi encontrado no navegador, ou algum comando está faltando em args |
initBrowser |
Iniciando o navegador |
openBrowser |
O navegador foi aberto com sucesso! |
connectBrowserWs |
Conexão com o BrowserWs realizada com sucesso! |
initWhatsapp |
Iniciando o whatsapp! |
erroPageWhatsapp |
Erro ao acessar a página do whatsapp |
successPageWhatsapp |
Página do Whatsapp acessada com sucesso. |
waitForLogin |
Aguardando verificação de login! |
waitChat |
Aguardando o chat carregar |
successChat |
Chat carregado com sucesso! |
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);
});Por padrão, o código QR aparecerá no terminal. Se você precisar passar o QR para outro lugar, aqui está como:
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);
});Puppeteer se encarrega do download do arquivo. A descriptografia é feita o mais rápido possível (supera os métodos nativos). Suporta arquivos grandes!
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)}`;
await fs.writeFile(fileName, buffer, (err) => {
...
});
}
});Não estão listadas todas as funções disponíveis. Para mais informações, todas as funções disponíveis podem ser encontradas aqui e aqui
// 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', buttons, 'Description')
.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 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]');
// Stop typing
await client.stopTyping('[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
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 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]');Existem alguns truques para um melhor uso do venom.
// 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");
});Feche a sessão corretamente para garantir que a sessão seja salva para a próxima vez que você fizer login (para não pedir outra verificação QR). Então, em vez do CTRL + C,
// Catch ctrl+C
process.on('SIGINT', function() {
client.close();
});
// Try-catch close
try {
...
} catch (error) {
client.close();
}O fechamento automático é ativado por padrão e o tempo limite é definido como 60 segundos. Recebe o tempo em milissegundos para fazer a contagem regressiva até ser pareado.
Use "autoClose: 0 | false" para desativar o fechamento automático.
A construção do venom é realmente simples, embora contenha 3 projetos principais dentro
- Projeto Wapi
> npm run build:wapi- Middleware
> npm run build:middleware
> npm run build:jsQR- Venom
> npm run build:venomPara construir todo o projeto, execute
> npm run buildMantenedores são necessários, não consigo acompanhar todas as atualizações sozinho. Se você estiver interessado, abra um Pull Request.
Pull requests são bem-vindos. Para mudanças importantes, por favor, abra uma issue primeiro para discutir o que você gostaria de alterar.