API My WhatsApp

Este projeto usa como base o Venom, um navegador virtual sem interface gráfica que abre o whatsapp web e executa todos os comandos via código possibilitando assim a automação de todas as funções, e um fork do projeto myzap do @billbarsch.

Legenda

Status	Descrição
✔️	Testado, funcionado normalmente
❌	Com erro no código
⚠️	Funcionado de forma anormal
✔️⚠️	Testado, funcionado de forma anormal(TIMEOUT/LOOP)
❌⚠️	Testado, erro desconhecido(lib)

Rotas

Router Started		Router Profile		Router Device
Start	✔️	setProfileStatus	✔️	killServiceWorker	✔️
Status	✔️	setProfileName	✔️	restartService	✔️
Close	✔️	setProfilePic	✔️	getHostDevice	✔️
Logout	✔️			getConnectionState	✔️
getHardware	✔️			getBatteryLevel	✔️
QRCode	✔️			isConnected	✔️
getSessions	✔️			getWAVersion	✔️
getBase64Encoding	✔️
getBase64Decoding	✔️

Router Basic		Router Retrieving		Router Group
sendVoice	✔️	getAllContacts	✔️	leaveGroup	✔️
sendVoiceBase64	✔️	getSessionTokenBrowser	✔️	getGroupMembers	✔️
sendVoiceFileBase64	✔️	getBlockList	✔️	getGroupMembersIds	✔️
sendContactVcard	✔️	getStatus	✔️	getGroupInviteLink	✔️
sendContactVcardList	✔️	getNumberProfile	✔️	createGroup	✔️
sendText	✔️	checkNumberStatus	✔️	createGroupSetAdminMembers	✔️
sendTextMassa	✔️	checkNumberStatusMassa	✔️	createCountGroupSetAdminMembers	✔️
sendTextGrupo	✔️			removeParticipant	✔️
sendLocation	✔️			addParticipant	✔️⚠️
sendLocationGroup	✔️			promoteParticipant	✔️
sendLinkPreview	✔️			demoteParticipant	✔️
sendImage	✔️			getGroupInfoFromInviteLink	✔️
sendImageMassa	✔️			joinGroup	✔️
sendMultImage	✔️
sendMultImageMassa	✔️
sendImageGrupo	✔️
sendFile	✔️
sendFileBase64	✔️
sendFileToBase64	✔️
sendFileFromBase64	✔️
sendImageAsStickerGif	✔️
sendImageAsStickerGifUrl	✔️
sendImageAsSticker	✔️

Dependências (Ubuntu)

sudo apt-get install -y gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget build-essential apt-transport-https libgbm-dev python3-pip libssl-dev libffi-dev python3-dev build-essential cmake clang libicu-dev procps xvfb

Instale o NodeJs (Ubuntu)

Instalar

# Ir para seu diretório home
cd ~

# Recuperar o script de instalação para sua versão de preferência
curl -sL https://deb.nodesource.com/setup_14.x -o nodesource_setup.sh

# Execute o script 
sudo bash nodesource_setup.sh

# Instalar o pacote Node.js
sudo apt install -y git nodejs yarn gcc g++ make

# Remover pacotes que não são mais necessários
sudo apt autoremove -y

Rodando a aplicação

# Ir para seu diretório home
cd ~

# Clone este repositório
git clone https://github.com/AlanMartines/mywhatsapp-api-node-venom.git

# Acesse a pasta do projeto no terminal/cmd
cd mywhatsapp-api-node-venom

# Instale as dependências
npm install

# Execute a aplicação 
node server.js

# Manter os processos ativos a cada reinicialização do servidor
sudo npm install pm2 -g

pm2 start server.js

pm2 save

pm2 startup

sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u ${USER} --hp /home/${USER}

# Para remover do init script
pm2 unstartup systemd

# O servidor iniciará na porta:9000

# Pronto, escaneie o código QR-Code do Whatsapp e aproveite!

Iniciar sessão whatsapp (POST method)

router.post("/Start", (req, res, next) => {
  const response = await fetch('http://localhost:9000/sistema/Start', {
    method: 'POST',
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(
        {
            sessionName: req.body.SessionName
        }
    )
  });
  const content = await response.json();
  return content;
});

Exibir QR-Code no navegador (POST method)

router.post("/QRCode", (req, res, next) => {
  const response = await fetch('http://localhost:9000/sistema/QRCode', {
    method: 'POST',
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(
        {
            sessionName: req.body.SessionName,
            View: "true"
        }
    )
  });
  const content = await response.json();
  return content;
});

Retorna json com (base64) do QR-Code (POST method)

router.post("/QRCode", (req, res, next) => {
  const response = await fetch('http://localhost:9000/sistema/QRCode', {
    method: 'POST',
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(
        {
            sessionName: req.body.SessionName,
            View: "false"
        }
    )
  });
  const content = await response.json();
  return content;
});

Fecha sessão whatsapp (POST method)

router.post("/Close", (req, res, next) => {
  const response = await fetch('http://localhost:9000/sistema/Close', {
    method: 'POST',
    headers: {
      'Accept': 'application/json',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(
        {
            sessionName: req.body.SessionName
        }
    )
  });
  const content = await response.json();
  return content;
});

Gerar TOKEN_SECRET para uso no jwt

node -e "console.log(require('crypto').randomBytes(256).toString('base64'));"

Configuração inicial do arquivo "config/server.config.json"

{
  "_comment_host": "Configuração do host",
  "host": "0.0.0.0",
  "port": "9000",
  "_comment_jwt": "Configuração do jwt",
  "jwt_secret": "09f26e402586e2faa8da4c98a35f1b20d6b033c60"
}

Dockerfile

# Ir para seu diretório home
cd ~

# Clone este repositório
git clone https://github.com/AlanMartines/mywhatsapp-api-node-venom.git

# Acesse a pasta do projeto no terminal/cmd
$ cd nodejs-mywhatsapp-api-node-venom

# Processando o arquivo Dockerfile
$ docker build -t alanmartines/nodejs-mywhatsapp-api-node-venom:1.0

# Criar um contêiner
docker container run --name mywhatsapp-api-node-venom -p 9000:9000 -d alanmartines/nodejs-mywhatsapp-api-node-venom:1.0

Para instalar o certbot e criar o certificado SSL para domínios https

sudo apt update

sudo apt install -y software-properties-common

sudo add-apt-repository universe

sudo add-apt-repository ppa:certbot/certbot

sudo apt update

sudo apt install -y certbot

sudo certbot certonly --manual --force-renewal -d *.yourdomain.net -d yourdomain.net --agree-tos --no-bootstrap --manual-public-ip-logging-ok --preferred-challenges dns-01 --server https://acme-v02.api.letsencrypt.org/directory

Em desenvolvimento

Este projeto se encontra em desenvolvimento, então pode conter erros.

---

Ban Whatsapp

Existem dois tipos diferentes de banimento.

BANIMENTO TEMPORÁRIO Uma técnica para banir temporariamente uma conta. Eu sei que eles não estão mais acostumados a aplicar banimento temporário, ou eles são tão raros hoje em dia, exceto pelo uso de versões não autorizadas do WhatsApp.

• O WhatsApp pode banir temporariamente sua conta se você estiver usando uma versão não autorizada do WhatsApp.

• Versões não autorizadas do WhatsApp, também conhecidas como “Mods do WhatsApp” no Android, costumam oferecer vários novos recursos, mas sua privacidade pode ser comprometida: esses aplicativos editam o WhatsApp, injetando um código diferente, e não podemos saber se esse código é perigoso para sua privacidade e segurança.    

• Usar uma versão modificada do WhatsApp viola os Termos de Serviço, então o WhatsApp pode banir sua conta quando iniciar uma nova onda de banimento. Se o usuário não mudar para a versão oficial do WhatsApp da App Store e Google Play Store dentro de um determinado tempo, ele definitivamente banirá sua conta.    

• O WhatsApp deve proteger seus produtos e usuários, portanto, sua ação de banir as versões modificadas é absolutamente correta. Talvez eles pudessem agir de forma diferente, por exemplo, impedindo o acesso a versões modificadas do WhatsApp sem banir o usuário, mas é compreensível. Há alguns anos o WhatsApp está tentando convencer as pessoas a parar de usar versões modificadas do WhatsApp, implementando alguns recursos incluídos nessas versões.

• O WhatsApp pode banir temporariamente sua conta se você criar muitos grupos com pessoas que não têm seu número de telefone salvo em suas listas de endereços.

• O WhatsApp pode banir temporariamente sua conta se você enviar muitas mensagens para pessoas que não têm seu número de telefone salvo em suas listas de endereços.

• O WhatsApp pode banir temporariamente sua conta se você enviar muitas mensagens para uma lista de difusão.

• O WhatsApp poderia anteriormente banir sua conta se você enviar a mesma mensagem para muitas pessoas. O WhatsApp não consegue ler o conteúdo da mensagem, mas se o aplicativo WhatsApp entender que você está encaminhando a mesma mensagem para muitos contatos, você pode ser banido temporariamente. Não deveria estar ativo hoje em dia ou é muito raro, pois o WhatsApp permite encaminhar uma mensagem para no máximo 5 contatos, a fim de evitar a divulgação de notícias falsas.

• O WhatsApp pode banir temporariamente sua conta se muitas pessoas bloquearem você em um determinado tempo.

• Se o usuário foi banido temporariamente várias vezes, ele pode ser banido permanentemente de usar o WhatsApp.

BANIMENTO PERMANENTE Principais razões pelas quais o WhatsApp pode banir sua conta:

• O WhatsApp proíbe permanentemente contas que executam ações em massa ou automatizadas: elas violam totalmente seus Termos de Serviço porque essas ações usam os serviços do WhatsApp sem qualquer autorização. O WhatsApp proíbe mais de 2,5 milhões de contas por mês devido a mensagens em massa e automatizadas.

• O WhatsApp pode banir permanentemente sua conta se o número de telefone associado tiver sido usado para ações suspeitas. Essa verificação acontece durante o registro da conta.

• O WhatsApp proíbe contas que usam seu serviço intensamente, por exemplo, se a conta enviar muitas mensagens em um determinado período. Não se preocupe, o WhatsApp introduziu um limite que é realmente inalcançável para uma pessoa. Se uma conta atingiu o limite, significa que não é humana, mas é um sistema automatizado.

• O WhatsApp bane todas as contas que recebem vários relatórios de outros usuários.

• O WhatsApp avisa que eles não podem emitir um aviso antes de banir qualquer conta (de acordo com seus Termos de Serviço, eles podem reter o direito de bani-lo sem qualquer comunicação), mas, se o usuário pensa que sua conta foi banida por engano, ele pode enviar um e-mail para que eles vai examinar o caso dele.

• O WhatsApp também proíbe contas com nomes suspeitos em seus nomes de grupo.

• Conforme mencionado no artigo sobre os rótulos de privacidade da Apple para WhatsApp, o WhatsApp pode visualizar todos os nomes e descrições de grupos, a fim de banir automaticamente todas as contas que violam as leis (mas não são coletadas para fins publicitários e esses detalhes não são compartilhados com seus pais empresa, Facebook). Isso é para ajudar o WhatsApp a combater a exploração infantil.

• Infelizmente, o WhatsApp também pode banir sua conta por engano.

---

Reflexão

O conhecimento que adquirimos não merece ficar parado. Compartilhar tudo o que sabemos e gerar valor na vida de outras pessoas pode ter efeitos incríveis. Viver em constante compartilhamento de informações ajuda nossa comunidade profissional a evoluir cada vez mais.

Todos nós, independente do nível de conhecimento técnico, temos algum tipo de diferencial a oferecer para o próximo.

Já que temos a incrível capacidade de oferecer algo diferente para o próximo, devemos aproveitar isso para compartilhar todo esse nosso conhecimento.

Às vezes temos o sentimento de que aquilo que estamos fazendo de tão especial merece ser compartilhado, a internet está aí para nos possibilitar isso.

Temos a chance de buscar um conhecimento hoje e amanhã criar um artigo, vídeo ou qualquer outro tipo de material para compartilhar com as pessoas esse conhecimento que adquirimos.

Muitas pessoas, e talvez você se inclua nesse grupo, ainda têm aquele sentimento forte de mudar o próximo. Um sentimento que a faz ter um propósito de vida para buscar algo a mais, algo que possa contribuir para as gerações que por aqui estão e que ainda virá a passar.

Isso fica ainda mais expressivo quando se trata da comunidade específica de seu campo de estudo ou trabalho, pois deixar algum “legado” para sua área de conhecimento é algo que chama atenção de profissionais, pesquisadores e estudantes do mundo todo.

Muitos são movidos exatamente por essa energia de deixar seu nome registrado para o mundo.

A sua carreira é construída ao longo do tempo com uma série de conhecimentos e habilidades que são adquiras ao longo da vida.

Mas essa tarefa não precisa ser uma ação solitária e tão complicada assim, ainda mais levando em conta que uma sede grande pela busca de conhecimento e alguns ainda mais motivados para compartilhar tudo aquilo que já aprenderam.

Em outras palavras, as pessoas acabam tendo uma certa tendência em escutar o que as outras pessoas têm a dizer e também fazer a sua voz ser ouvida.

A informação não fica parada!

Quando entendemos a força desse hábito de compartilhar conhecimento, estamos contribuindo para que as pessoas ao nosso redor, que também precisam desse conhecimento, não parem de aprender.

Informação que fica parada, se perde! Tudo está na rede, esperando por você.

Faça dessa prática um de seus hábitos também. As informações que são compartilhadas por você podem contribuir para o crescimento e ascensão de alguém, já imaginou isso?

Envolva-se com as pessoas. Isso é ter propósito!

---

License

MIT