🔔 Lembretes — avise quem importa, na hora certa

Sistema de lembretes automáticos que entrega por WhatsApp, Direct do Instagram e e-mail. Você agenda uma vez; o servidor cuida do resto — repetição, anexos, variáveis na mensagem, tentativas quando falha e um alerta automático de chuva que avisa sozinho quando a previsão muda.

Feito em PHP 8.3 + MySQL, sem framework e sem dependência externa (o cliente SMTP é próprio e as imagens são geradas com GD).

Login	Painel

Alerta de chuva	Cartão que vai junto no aviso

Mais telas

Lembretes	Contatos

Envios	Conexões

No celular

• Três canais: WhatsApp (Evolution API), Direct do Instagram (Graph API) e e-mail (SMTP próprio, com modelo HTML responsivo).
• Repetição: uma vez, de hora em hora, diária, semanal, quinzenal, mensal, anual ou a cada N dias, com data para parar.
• Aviso antecipado: "faltam 2 horas para…" antes do horário marcado.
• 31 variáveis na mensagem — {primeiro_nome}, {saudacao}, {data_extenso}, {clima}, {temperatura} e companhia — com prévia antes de salvar.
• Anexos de até 16 MB: imagem, vídeo, áudio e documento, com o tratamento certo em cada canal.
• Vários números de WhatsApp: cada lembrete escolhe por qual número sai.
• Condições de clima: "só envie se a chance de chuva passar de 60%", "se a temperatura passar de 33°"…
• Alerta automático de chuva (abaixo).
• Painel de conexões com diagnóstico ao vivo dos três canais, renovação automática do token do Instagram e histórico de envios com reenvio.

Um cron confere a previsão a cada 15 minutos (fonte: Open-Meteo, sem chave) e avisa sozinho quando a chuva está chegando:

• dispara a partir da chance que você escolher, olhando as próximas N horas;
• calcula a janela ("vai chover das 13h até 17h") e a intensidade (fraca, moderada, forte, tempestade);
• um aviso por chuva — com intervalo mínimo entre avisos e janela de silêncio noturno (tempestade pode furar);
• reavisa se piorar (chance sobe 25 pontos ou vira tempestade);
• avisa de novo quando a chuva passa;
• cada contato recebe a previsão da cidade dele (campo cidade na ficha; sem isso, vale a cidade padrão);
• manda junto um cartão da previsão em imagem, gerado com GD — no WhatsApp como legenda, no Direct em seguida ao texto, no e-mail anexado.

cp config.example.php config.php     # preencha banco, endereço, Evolution API e SMTP
php install.php                      # cria as tabelas e o administrador

O install.php é idempotente (pode rodar de novo a cada atualização) e, na primeira vez, cria o administrador com senha sorteada, mostrada uma única vez no terminal. Para escolher o login e a senha: ADMIN_USUARIO=chefe ADMIN_SENHA=... php install.php.

Imagem pronta no GitHub Packages (Apache + PHP 8.3 com PDO MySQL e GD já configurados):

docker run -d --name lembretes -p 8080:80 \
  -v "$PWD/config.php:/var/www/html/config.php" \
  -v lembretes-uploads:/var/www/html/uploads \
  ghcr.io/alequizao/lembretes-alequizao:latest

docker exec lembretes php install.php        # cria as tabelas e o administrador
docker exec lembretes php cron.php           # ponha no cron do host, de minuto em minuto
docker exec lembretes php alertachuva.php    # e este a cada 15 minutos

O config.php entra por volume — a imagem nunca carrega senha dentro.

Crons sugeridos:

* * * * *  php /caminho/lembretes/cron.php           >> /var/log/lembretes.log 2>&1
*/15 * * * * php /caminho/lembretes/alertachuva.php  >> /var/log/lembretes-chuva.log 2>&1
15 4,16 * * * php /caminho/lembretes/renovar_ig.php  >> /var/log/lembretes-ig-token.log 2>&1

Requisitos: PHP 8.1+ (PDO, cURL, GD, mbstring), MySQL 5.7+ e, para o WhatsApp, uma instância da Evolution API.

⚠️ Em servidores com PHP-FPM não use php_flag no .htaccess (derruba com HTTP 500) — a pasta uploads/ se protege com <FilesMatch> + Options -ExecCGI.

Histórico de versões em CHANGELOG.md.

Sistema desenvolvido sob medida por Alequizao.

• E-mail: alequizao.dev@gmail.com
• GitHub: @alequizao

Quer um sistema como este para o seu negócio? Entre em contato.

© Alequizão · Todos os direitos reservados. O código está público para consulta e portfólio; uso comercial, cópia ou redistribuição somente com autorização.