Lembretes

Sistema de envio automático de lembretes do Google Calendar para o WhatsApp.

Funcionalidades

• Envio diário e semanal de compromissos e tarefas do Google Calendar para o WhatsApp
• Autenticação via OAuth2 Google
• Integração com WhatsApp via WPPConnect (repositório oficial)
• Rotas de teste para envio manual

Instalação

npm install

Sobre o WPPConnect

Este projeto utiliza o WPPConnect para integração com o WhatsApp Web.

• Permite enviar mensagens, arquivos, imagens e interagir com grupos e contatos.
• O login é feito via QR Code, que será exibido na rota /qr ao iniciar o servidor.
• O WPPConnect depende do navegador Chrome instalado na máquina para funcionar corretamente.
• Para mais detalhes, consulte a documentação oficial: https://github.com/wppconnect-team/wppconnect

Configuração

1. Criando credenciais no Google Cloud

1. Acesse Google Cloud Console
2. Crie um novo projeto ou selecione um existente
3. Vá em APIs & Services > OAuth consent screen e configure o consentimento (pode ser "External" para uso pessoal)
4. Vá em APIs & Services > Credentials
5. Clique em Create Credentials > OAuth client ID
   • Tipo de aplicação: "Web application"
   • Adicione o URI de redirecionamento: http://localhost:3000/oauth2callback
   • Salve e copie o Client ID e o Client Secret
6. Ative a API do Google Calendar: APIs & Services > Library > Google Calendar API > Enable

2. Crie o arquivo .env na raiz do projeto:

GOOGLE_CLIENT_ID=seu_client_id
GOOGLE_CLIENT_SECRET=seu_client_secret
GOOGLE_REDIRECT=http://localhost:3000/oauth2callback

3. Segurança

• Não suba o arquivo .env ou tokens.json para o GitHub (já estão no .gitignore).

Uso

• Inicie o servidor:

  npm start

• Acesse http://localhost:3000 para autenticar com o Google.
• Use as rotas /testar-wpp e /testar-semana para testar o envio manual.

Rodar automaticamente ao ligar o PC (Windows)

Você pode configurar para que a aplicação rode todos os dias automaticamente ao iniciar o computador:

Usando o Agendador de Tarefas do Windows

1. Abra o Agendador de Tarefas (Task Scheduler).
2. Crie uma nova tarefa.
3. Configure para iniciar "Ao iniciar o computador" ou "Ao fazer login".
4. Na ação, coloque para executar o Node.js com o caminho do seu projeto:

• Programa/script: C:\Program Files\nodejs\node.exe
• Argumentos: C:\projetos\Lembretes\index.js

5. Salve e teste.

Usando PM2 (mantém rodando em background)

1. Instale o PM2 globalmente:

npm install -g pm2

2. Inicie o app com PM2:

pm2 start index.js --name lembretes
pm2 save
pm2 startup

Assim, o PM2 inicia o app automaticamente ao ligar o PC.

Gitflow

Este projeto segue o fluxo Gitflow:

• Branch principal: main
• Branch de desenvolvimento: develop
• Use os comandos do Gitflow para features, releases e hotfixes

Opções de deploy gratuito

• Cloud AWS, Google, Azure no free tier.
• Railway
• Render

Observações

• Os tokens de autenticação são salvos em tokens.json (não versionado)
• Para consumir a API do Google Calendar, o usuário deve autenticar via navegador na primeira execução (rota /).
• Após autenticar, o token será salvo e usado automaticamente para os envios.

Licença

MIT