AllWhatsPy
PT-BR | Whatsapp Wrapper para automação de Envio e Análise de Mensagens com Python e Selenium
Install / Use
/learn @DevLucasLourenco/AllWhatsPyREADME
PT-BR
Criado por Lucas Lourenço
Manutenido por Lucas Lourenço
v2.1.3
Sumário
Tutorial em Vídeo
<h1 align="center"> <a href="https://www.youtube.com/watch?v=5_jpKMmHdso&list=PLDEkcBIFEDjnjAuoyVOa0rkn8sdowuLCn&index=1&ab_channel=LucasLourenco"> <img src="/utilidades/videoicon.gif" alt="Tutorial" width="450px" href=/> </a> </h1>🚨Vídeo mais recente🚨 👇🏻
<h1 align="center"> <a href="https://youtu.be/5_jpKMmHdso"> <img src="/utilidades/thumbnails/1.png" alt="Tutorial" width="450px" href=/> </a> </h1>⭐ Avalie o Código! ⭐
É de muitíssima importância a Estrela que você pode estar dando para colaborar com a Manutenção e Atualização do código!
Se você utiliza o AllWhatsPy com frequência, gosta da forma que foi desenvolvido, se inspira nele, serei muito grato por sua avaliação!
Autor
<h2> <p>Linkedin: devlucaslourenco
</p> <p>Instagram: lucaslourencoo__
</p> <p>Email: dev.lucaslourenco@gmail.com
</p> </h2>Por que AllWhatsPy?
À medida que nossa dependência do WhatsApp, seja para fins profissionais ou pessoais, se torna incontestável, surge a inquietação de como otimizar essa aplicação essencial em nossas vidas. A resposta a essa inquietação se materializa na forma do AllWhatsPy, uma biblioteca inovadora e poderosa criada para revolucionar sua experiência de automação de processos no WhatsApp.
Inspirado por notáveis projetos como o PyWhatsapp e o PyWhatKit, iniciei uma jornada de exploração, imersão e pesquisa aprofundada nas possibilidades oferecidas por Bots e APIs do WhatsApp. Com um compromisso <b>inabalável com a qualidade e o aprimoramento</b> de software, decidi investir meu tempo e energia na criação do AllWhatsPy, um projeto que tem sido desenvolvido de forma exclusiva e independente.
Ao longo desse processo, foram dedicadas milhares de linhas de logs em testes, registrando cada passo do caminho para garantir o funcionamento perfeito da biblioteca. O resultado é uma ferramenta versátil e flexível que permite que você faça literalmente "o que quiser" no WhatsApp, proporcionando um nível inédito de eficiência e automação. O AllWhatsPy é a solução que você estava esperando para elevar a produtividade e a conveniência no uso do WhatsApp, tornando-o uma ferramenta ainda mais indispensável em sua vida.
</br> </br>Antes de Começar no AllWhatsPy
É de extrema importância a compreensão de alguns aspectos que podem redigir à situações problemáticas à sua conta.
1 - Utilize números aquecidos. Números que já tem histórico com o Meta em um geral. Estes por sua vez, terão uma chance inferior de ser bloqueados por SPAM. Da mesma forma funciona para conversas aquecidas. Se o Whatsapp perceber que está sendo enviado para uma grande massa e esta é a primeira mensagem troca entre vocês, a chance de ocorrer é maior.
2 - Contas/Números recém criados podem ocasionar em bloqueio imediato após instancias de utilização do AWP para grande massa de números.
3 - O Whatsapp é contra automações para envio de mensagem em massa. o AWP é construído para imitar o funcionamento ótico e interacional de um humano. Entretanto, é bom estar ciente e evitar a utilização de maneira excessiva às regras do Meta.
4 - Limite a quantidade de mensagens que podem ser enviadas. Utilize os métodos de Schedule para ocasionar no intervalo de uma massa de contatos acessados.
5 - Todas as libs de automação do Whatsapp funcionam baseado nestes tópicos acima. Em caso de dúvidas, basta abrir uma Issue ou enviar-me mensagem.
<br> </br>
Começando no AllWhatsPy
<div align="center"> <h2> INSTALAÇÃO </h2> </div>Para a instalação da lib, no terminal faça:
pip install -U allwhatspy-awp
Caso esteja tendo problemas de pacote, execute:
pip install -U allwhatspy-awp
pip install webdriver-manager
pip install selenium
pip install requests
pip install pyperclip
pip install Pillow
Você também pode estar baixando os arquivos e colar na sua pasta, caso sua máquina esteja tendo problemas em instalar esta lib.
</br>Lógica básica:
flowchart LR
AWPContato --> AllWhatsPy
AWPMensagem --> AllWhatsPy
AWPAudio --> AllWhatsPy
AWPCriptografia --> AllWhatsPy
AllWhatsPy ----> awp.msg.enviar_mensagem_por_link
AllWhatsPy ----> awp.msg.enviar_mensagem_direta
awp.msg.enviar_mensagem_por_link ----> awp.desconectar
awp.msg.enviar_mensagem_direta ----> awp.desconectar
AllWhatsPy ---> .ctt
AllWhatsPy --> .criptografia
.ctt --> awp.ctt.encontrar_contato
.ctt --> awp.ctt.encontrar_usuario
awp.ctt.encontrar_contato --> .msg
awp.ctt.encontrar_usuario --> .msg
.msg ---> awp.msg.enviar_mensagem_isolada
.msg ---> awp.msg.enviar_mensagem_paragrafada
.msg --> .audio
awp.msg.enviar_mensagem_paragrafada --> awp.desconectar
awp.msg.enviar_mensagem_isolada --> awp.desconectar
Objetivos a Serem Terminados
<details> <summary> ✅To Do List </summary>- [x] Criar alternativas para envio de mensagem (Realizado - 19/12/2022)
- [x] Tratar as
except Exception(Realizado - 21/12/2022) - [x] Resolver bug na urllib (Realizado - 21/12/2022)
- [x] Alimentar o código com opções alternativas para
awp.conexao()eawp.desconectar()(Realizado - 21/12/2022) - [x] Corrigir excepts de
NoSuchElementException(Realizado - 22/12/2022) - [x] Implementar WebDriverWait para melhor responsividade do software (Realizado - 27/12/2022)
- [x] Configurar a entrada de
logs(Realizado - 28/12/2022) - [x] Atualizar ActionChains (Realizado - 15/01/2023)
- [x] Terminar
ultimas_mensagens_conversa()(Realizado - 18/01/2023) - [x] Explicar todas as fórmulas (Realizado - 21/01/2023)
- [x] Aperfeiçoar a função de
agendamento(Realizado - 21/01/2023) - [x] Terminar o
sumário(Realizado - 21/01/2023) - [x] Implementar a área de
Exemplos Práticos(Realizado - 21/01/2023) - [x] Fazer vídeo e postar no Youtube de explicação para utilizar o código (Realizado - 22/01/2023)
- [x] Implementar exemplos convencionais (Realizado - 23/01/2023)
- [x] Alterar Imagem da lógica do AWP com Mermaid (Realizado - 23/01/2023)
- [x] Finalizar função
encontrar_numeros_não_salvos()(Realizado - 25/01/2023) - [x] Implementação de Classes (Realizado - 12/02/2023)
- [x] Desenvolver um
pip installpara AWP (Realizado - 12/02/2023) - [x] Atualizar
nome_usuario()(Realizado - 15/02/2023) - [x] Atualizar bug da função
desconectar()(Realizado - 20/02/2023) - [x] Corrigir bug na função
pegar_foto_contato()(Realizado - 21/02/2023) - [x] Atualizar icon do AWP (Realizado - 25/02/2023)
- [x] Realizar a explicação de como começar no AWP
- [x] Implementação de Classes, Métodos e Módulos auxiliaers
- [x] Lançamento da Versão 2 do AllWhatsPy (Realizado - 10/10/2023)
- [x] Propagar o erro AWPContatoNaoEncontrado
🚨Exemplos🚨
<details open> <summary> 🚨Exemplos Práticos🚨 </summary> <p> </p> </details> <div> <h1 style="float: left;">Utilizando AllWhatsPy</h1> <h6> - (Clique nas setas ou na linha para abrir e fechar as abas.)</h6> </div> <div align="center"> <img src="/utilidades/AWPgifprocreate.gif" alt="AllWhatsPy" width="450px"/> </div> <details open> <summary style="font-size: 25px"> <h1>Inicialização 👇</h1> </summary>Instanciando
from AllWhatsPy import AllWhatsPy
awp = AllWhatsPy()
Instancia do objeto AllWhatsPy.
`in
