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!
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
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. 💖💖
