Rode o comando abaixo em seu terminal ou CMD!
pip install authwa
Importe o modulo e adicione a uma variavel, chamando a classe desejada!
import authWA
whats = authWA.WA()
whats.enviar_msg()
Após criar abra o terminal(PowerShell) ou CMD.
No windows:
apertando WIN + R e digitando CMD pressione Enter
No Linux:
apertando CTRL + T ou CTRL + ALT + T ou pressione COMMAND ou WIN e digite TERMINAL
Terminal
Agora abra o WhatsApp faça o seguinte atalho ALT + TAB, Para voltar ao terminal !
Para que seu codigo funcione é importante que deixe o whatsapp aberto, pois o codigo irá usar o atalho Alt + Tab para acessa-lo.
É importante também que não movimente ou clique com o mouse e nem pressione nenhuma tecla durante o processo, o indicado é ter uma maquina como servidor para que o codigo tenha mais eficiencia, mas não é obrigatório.
Envio de mensagens simples e com Imagens no o Whatsapp, para deixar sua imaginação fluir e construir suas automações!
Objetivo
A Intenção deste modulo do AuthWA, é que você consiga usar a critividade para criar suas automações.
Para envio de mensagens simples, usando o modulo WA, é bem fácil, porém lembre-se bem deste módulo, pois ele será muito importante nos módulos a frente!
Importando o WA()
from authWA import WA
whats = WA()
A partir dai podemos utilizar seus modulos
Dentro do WA() temos os seguintes modulos
- enviar_msg( )
- sql_connection( )
- criar_imagem_SQL( )
Está função faz um envio simples ou com uma imagem embutida, para isto precisa ter preparado o ambiente.
Parametros
Nome = Nome do Contato a ser enviado a mensagem
Mensagem = Mensagem a ser enviada ou a Legenda que vai na imagem
Img = Aqui você devera colocar o caminho da Imagem a ser enviada
from authWA import WA
whats = WA()
# Envio sem imagem
whats.enviar_msg(
nome = "Nome do contato",
mensagem = "Isto foi enviado pelo AuthWA"
)
# Envio com imagem
whats.enviar_msg(
nome = "Nome do contato",
mensagem = "Isto foi enviado pelo AuthWA"
img = "imagens/image.png"
)
Para realizar uma conexão com o banco de dados, precisamos de alguns parametros, lembre-se sempre que for realizar uma conexão com o banco de dados, faze-la no incio do projeto!
Parametros
Obrigatórios
uid = Usuário DB
pwd = Senha de Acesso do DB
server = Servidor do DB
Opcional caso for utilizar o SQL Server
database = Banco de Dados a ser utilizado
driver = Qual driver usar você encontra no site do SQL Alchemy:
SQLite
SQL Server
MySQL
Exemplo de código
from authWA import WA
whats = WA()
# Obrigatorio
conn = whats.sql_connection(
uid = "usuario.aqui",
pwd = "suasenhavemaqui",
server = "10.0.1.0",
)
# Opcionais
conn = whats.sql_connection(
uid = "usuario.aqui",
pwd = "suasenhavemaqui",
server = "10.0.1.0",
database = "DATABASE",
driver = "SQL Server"
)
print(conn)
# Saida do código
// "Conexão realizada com sucesso!"
ou
// "Conexão Invalida"
Com a conexão realizada você pode agora fazer pesquisas e elas seram tranformadas em um arquivo PNG
Parametros
- consulta = Consulta SQL para gerar o Dataframe.
- arquivo = Diretorio onde salvar o arquivo, este item é OPCIONAL, ja que o diretório padrão é dist/temp.png e indicamos utilizar ele.
from authWA import WA
whats = WA()
# Se conectando ao DB
whats.sql_connection(
uid = 'usuario.db',
pwd = 'minhasenha',
server = '10.10.0.10'
)
# Criando Imagem
img = whats.criar_imagem_SQL(
consulta = """
SELECT Nome, TerminoReal as Data
FROM Table
""",
arquivo = './img.png' # Lembrando que passar o arquivo é OPCIONAL
)
print(img)
Detalhe: A saida do print acima não será a imagem de fato e sim o caminho até ela, exemplo: caminho/arquivo.png
Saida:
./img.png
Imagem:
Parcial é basicamente algo mais intenso do que uma simples mensagem !
Sabe aquele acompanhamento que você quer fazer seja pra sua empresa ou pra uso pessoal? Aquele acompanhamento Hora a Hora, pois é com o Parcial você consegue facilmente.
Sabe Aquela mensagem te lembrando de fazer algo ou de uma agenda que você não pode esquecer e tem que receber essa mensagem numa hora especifica, com o Parcial é mais facil.
Aquela mensagem para seus clientes que lembrando das promoções, sempre em um horario especifico, com o Parcial, você consegue facilmente.
Bom, para criarmos o hora a hora, é bem simples, vamos usar alguns conceitos do WA() então é importante que tenha dominio com este modulo
from authWA import Parcial
# Para mensagens simples
p = Parcial('','','')
# Para mensagens com DB
p = Parcial(
'usuario.db',
'minhasenha',
'10.0.0.1' # Exemplo de Servidor
)
lista_de_contatos = []
Normalmente você quer usar o Parcial quando se trata de muitos contatos! Pensando nisso, vamos utilizar um lista para os contatos Lembrano que ira enviar somente dias da Semana ou seja de Segunda a Sexta, para fim de semanas e horarios exatos, iremos falar depois!
Lambda:
Dentro desta lista, vamos passar funções, mas para que ela não seja chamada, iremos usar uma função do Python chamada lambda:
Clique aqui para mais informações sobre o lambda
from authWA import Parcial
p = Parcial('','','')
lista_de_contatos = [
# Agora iremos criar a lambda!
lambda: function()
]
Para criarmos as parciais do dias da semana iremos usar uma tuple
tuple = (
lambda:function2()
lambda:function()s,
)
No lugar desta function() iremos usar o nosso conhecimento do módulo WA(), iremos chamar a função de mensagem deste modulo dentro da lambda
Mas não precisamos importar o modulo WA() pois ele ja esta embutido no Parcial(), ele esta definido como whats, sendo assim podemos chama-lo usando a variavel onde colocamos o Parcial().
from authWA import Parcial
p = Parcial('','','')
# Lista que criamos acima
lista_de_contatos = []
# Criando a tupla dos dias de semana
dds = (
lambda: p.whats.enviar_mensagem(
nome = "Contato 1",
mensagem = "Codando com AuthWA!"
),
lambda: p.whats.enviar_mensagem(
nome = "Contato 2",
mensagem = "Codando com AuthWA!"
),
lambda: p.whats.enviar_mensagem(
nome = "Contato 3",
mensagem = "Codando com AuthWA!"
),
)
# Usamos o APPEND para adicionarmos a tuple(dds) na lista(lista_de_contatos)
lista_de_contatos.append(dds)
Certo, mas só fizemos a lista, ele ainda não vai executar de forma automática !
Para isso iremos entender outras coisinhas antes:
Como definir horario de Inicio e horario de Fim
Para isso dentro do proprio Parcial() passamos estes parametros
Lembrando que o valor padrão dele é o horario comercial, ou seja das 08hrs as 18hrs
hora_inicio = 8
hora_final = 18
from authWA import Parcial
p = Parcial('','','', hora_inicio = 8, hora_final = 18)
Caso você iniciou a Parcial depois do horario de inicio, automaticamente ele vai iniciar 1 hora depois(Em ponto), por exemplo se você iniciar o codigo as 11:25 ele vai iniciar a parcial 12:00.
Caso tenha sido ao contrario, inciado antes ou iniciado depois da hora final, ele só ira iniciar no horario definido para inicio.
Exemplos:
- Inicar o codigo as 06 com o inicio previsto as 8, quando der 08:00 do mesmo dia ele ira executar!
- Iniciar o código as 19 com o fim as 18, ele só ira executar no inicio do outro dia!
Tendo entendido isso, agora iremos iniciar o nosso loop, para isso temos uma função especifica, o main_loop(), onde vamos passar como parametro a nossa lista_de_contatos:
from authWA import Parcial
p = Parcial('','','')
lista_de_contatos = []
dds = (
lambda: p.whats.enviar_mensagem(
nome = "Contato 1",
mensagem = "Codando com AuthWA!"
),
lambda: p.whats.enviar_mensagem(
nome = "Contato 2",
mensagem = "Codando com AuthWA!"
),
lambda: p.whats.enviar_mensagem(
nome = "Contato 3",
mensagem = "Codando com AuthWA!"
),
)
lista_de_contatos.append(dds)
# Lembrando que temos que passar obrigatoriamente uma lista !
p.main_loop(lista_de_contatos)
Output//Saida Podemos ver abaixo,, que ele nos retorna o horario atual e quando a parcial sera iniciada!
Lembrando que esse processo é automatico, então não se preocupe com isso!
Bom para fazermos o fim de semana precisamos enteder os dias de semana, não pule pra cá, sem antes entender o Dias da Semana
Para o sistema entender que precisa ser executado aos fins de semana, adicionarmos funções que serão realizadas, para isso iremos usar um lista! Veja o exemplo abaixo.
from authWA import Parcial
p = Parcial('','','')
lista_de_contatos = []
# Tupla dos Dias de Semana
dds = (
p.whats.enviar_msg(
nome='Contato 1',
mensagem = 'Coda comigo'
)
)
# Lista do Fim de Semana
fds = [
p.whats.enviar_msg(
nome='Contato do fim de semana',
mensagem = 'Estamos atendendo venha conferir nossas promoções'
)
]
lista_de_contatos.append(dds)
lista_de_contatos.append(fds)
p.main_loop(lista_de_contatos)
Uma lista dentro de outra lista?
Sim o tem de ser exatamente assim !
O sistema entende tuplas como dias de semana e listas como fim de semana, mas lembre-se que ambas precisam estar dentro de uma lista master, que nesse caso seria nossa lista_de_contatos
Caso seus contatos do fim de semana sejam os mesmo que dos Dias de semana, podemos fazer da seguinte maneira:
Pra economizarmos código, podemos converter nossa tupla em lista! E desta forma, podemos ter os mesmos contatos do dias de semana
from authWA import Parcial
p = Parcial('','','')
lista_de_contatos = []
dds = (
p.whats.enviar_msg(
nome='Contato 1',
mensagem = 'Coda comigo'
),
)
# Desta forma teremos os mesmos contatos no fim de semana
fds = list(dds)
lista_de_contatos.append(fds)
p.main_loop(lista_de_contatos)
Bom se ja usamos tuplas e listas agora o que vamos usar para os horaários especificos, pois bem se você pensou em dict ou dicionários, você acertou na mosca!
Como esses parametros não dependem de ser enviados hora a hora, temos de passar a função com o lambda dentro de um dict, sua estrutura sempre seguirá assim:
dict = {horario:funtion()}
veja o exemplo, abaixo:
from authWA import Parcial
p = Parcial('','','')
lista_de_contatos = []
agenda = {
'10:00':lambda: p.whats.enviar_msg(
'Contato 1',
'Não esqueça de tal coisa'
),
'15:30':lambda: p.whats.enviar_msg(
'Contato 2',
'Vá ao dentista'
),
'22:00':lambda: p.whats.enviar_msg(
'Contato 3',
'Horá de dormir!!!!!!!'
)
'22:00':lambda: p.whats.enviar_msg(
'Contato 3',
'Sua agenda de amanha!',
p.whats.criar_imagem_SQL(
'SELECT * FROM AGENDA WHERE DAY = TODAY() + 1'
)
)
}
lista_de_contatos.append(agenda)
Então sim você consegue ter sua agenda pessoal te lembrando das coisas por mensagem rsrs.
Pronto agora você ja sabe como usar o AuthWA espero ter ajudado. 🥰💖
Caso tenha algum bug oui problema não hesitaremos em consertar, por mais que nosso log de erros seja efetivo, peço que abram sim um ISSUE no githubs, talvez a duvida de vocês ou o problema, tamém seja o de outros, agradeço a compreensão!
Link para abertura de ISSUE
Guilherme Breve - Analista
Atualmente trabalho como analista de Projetos, e como desenvolvedor full stack, tenho uma empresa de desenvolvimento de sistema para gestões comerciais e demais areas!
Minha intenção com o AuthWA é ajudar as pessoas, sem lucros financeiros.
Mas caso eu tenha te ajudado de alguma forma e creia que isso deva ser recompensado deixarei abaixo algumas forams de contribuir. 🥰
Muito obrigado por ter lido esta documentação e por usar o AuthWA, caso queiram fazer um fork e melhorar, estamos sempre dispostos a melhorias e progressões. 💖💖
FAQs
Automações WhatsApp
We found that authwa demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Malicious Go packages are impersonating popular libraries to install hidden loader malware on Linux and macOS, targeting developers with obfuscated payloads.
Security News
Bybit's $1.46B hack by North Korea's Lazarus Group pushes 2025 crypto losses to $1.6B in just two months, already surpassing all of 2024's $1.49B total.
Security News
OpenSSF has published OSPS Baseline, an initiative designed to establish a minimum set of security-related best practices for open source software projects.