273 lines
5.5 KiB
Markdown
273 lines
5.5 KiB
Markdown
# ⚡ Início Rápido - Sistema de Alertas
|
|
|
|
## 🚨 Problema Atual
|
|
|
|
**Sua venda de 20/10 com vencimento em 24/10 NÃO recebeu alertas porque o sistema automático não estava instalado.**
|
|
|
|
---
|
|
|
|
## ✅ Solução em 3 Passos
|
|
|
|
### PASSO 1: Enviar Alertas Atrasados (AGORA)
|
|
|
|
Para enviar **imediatamente** os alertas da venda de 20/10 e outras parcelas vencidas:
|
|
|
|
```bash
|
|
cd /home/tiago/Downloads/app_estoque_v1.0.0
|
|
node scripts/enviar-alertas-atrasados.js
|
|
```
|
|
|
|
Isso irá:
|
|
1. Listar todas as parcelas vencidas ou vencendo hoje
|
|
2. Perguntar se deseja enviar
|
|
3. Gerar PIX para cada parcela
|
|
4. Enviar via WhatsApp
|
|
5. Mostrar resultado de cada envio
|
|
|
|
**Tempo:** 2-5 minutos
|
|
|
|
---
|
|
|
|
### PASSO 2: Instalar Cron (Para Futuro)
|
|
|
|
Para que os alertas sejam enviados **automaticamente às 09:00 todos os dias**:
|
|
|
|
```bash
|
|
cd /home/tiago/Downloads/app_estoque_v1.0.0
|
|
chmod +x scripts/instalar-cron-alertas.sh
|
|
./scripts/instalar-cron-alertas.sh
|
|
```
|
|
|
|
O instalador irá:
|
|
1. Configurar execução diária às 09:00
|
|
2. Criar diretório de logs
|
|
3. Perguntar se quer testar agora
|
|
4. Mostrar comando para monitorar
|
|
|
|
**Tempo:** 1-2 minutos
|
|
|
|
---
|
|
|
|
### PASSO 3: Verificar Configurações
|
|
|
|
Abra o painel admin → Configurações e verifique:
|
|
|
|
**Evolution API:** ✅
|
|
- URL da API configurada
|
|
- Nome da instância configurado
|
|
- API Key configurada
|
|
|
|
**Mercado Pago:** ✅
|
|
- Access Token configurado
|
|
|
|
**Alertas WhatsApp:** ✅
|
|
- Primeiro alerta: ATIVO (3 dias antes)
|
|
- Segundo alerta: ATIVO (no dia)
|
|
- Alerta pós-vencimento: ATIVO (3 dias após)
|
|
|
|
**Tempo:** 2-3 minutos
|
|
|
|
---
|
|
|
|
## 🎯 Comandos Úteis
|
|
|
|
### Ver alertas que seriam enviados hoje
|
|
|
|
```bash
|
|
node scripts/enviar-alertas-parcelas.js
|
|
```
|
|
|
|
### Ver se o cron está instalado
|
|
|
|
```bash
|
|
crontab -l | grep alertas
|
|
```
|
|
|
|
Deve mostrar:
|
|
```
|
|
0 12 * * * TZ='America/Sao_Paulo' /usr/bin/node /caminho/para/enviar-alertas-parcelas.js...
|
|
```
|
|
|
|
### Monitorar logs em tempo real
|
|
|
|
```bash
|
|
tail -f logs/alertas-cron.log
|
|
```
|
|
|
|
### Testar Evolution API
|
|
|
|
```bash
|
|
curl -X GET "SEU_URL/instance/connectionState/SUA_INSTANCIA" \
|
|
-H "apikey: SUA_API_KEY"
|
|
```
|
|
|
|
---
|
|
|
|
## 📅 Como Vai Funcionar Agora
|
|
|
|
### Exemplo: Nova venda hoje (24/10)
|
|
|
|
**Venda:** 24/10/2025
|
|
**Parcela 1 vence:** 24/11/2025
|
|
|
|
**Timeline automática:**
|
|
|
|
| Data | Horário | Ação |
|
|
|------|---------|------|
|
|
| **21/11** | 09:00 | 🔔 Primeiro alerta: "vence em 3 dias" |
|
|
| **24/11** | 09:00 | 🔔 Segundo alerta + PIX: "vence hoje" + QR Code |
|
|
| **27/11** | 09:00 | 🔔 Alerta pós-venc (se não pago): "venceu há 3 dias" |
|
|
|
|
---
|
|
|
|
## 🔍 Verificar se Está Funcionando
|
|
|
|
### Teste 1: Envio Manual
|
|
|
|
```bash
|
|
# Deve enviar alertas imediatamente
|
|
node scripts/enviar-alertas-parcelas.js
|
|
```
|
|
|
|
**Resultado esperado:**
|
|
- Lista parcelas pendentes
|
|
- Envia alertas apropriados
|
|
- Mostra resumo (X alertas enviados)
|
|
|
|
### Teste 2: Cron Instalado
|
|
|
|
```bash
|
|
crontab -l
|
|
```
|
|
|
|
**Resultado esperado:**
|
|
- Mostra linha com `enviar-alertas-parcelas.js`
|
|
- Horário: `0 12` (= 09:00 Brasília)
|
|
|
|
### Teste 3: Logs Sendo Gerados
|
|
|
|
```bash
|
|
ls -lh logs/alertas-cron.log
|
|
```
|
|
|
|
**Resultado esperado:**
|
|
- Arquivo existe
|
|
- Tamanho aumenta após cada execução
|
|
|
|
---
|
|
|
|
## ⚠️ Troubleshooting Rápido
|
|
|
|
### Erro: "SUPABASE_KEY não configurado"
|
|
|
|
**Solução:**
|
|
```bash
|
|
# Criar arquivo .env na raiz
|
|
cd /home/tiago/Downloads/app_estoque_v1.0.0
|
|
nano .env
|
|
|
|
# Adicionar:
|
|
SUPABASE_URL=https://ydhzylfnpqlxnzfcclla.supabase.co
|
|
SUPABASE_ANON_KEY=sua_chave_aqui
|
|
```
|
|
|
|
### Erro: "Evolution API não responde"
|
|
|
|
**Verificar:**
|
|
1. URL está correta? (com https://)
|
|
2. Instância está ativa?
|
|
3. API Key está correta?
|
|
4. Testar no navegador: `https://sua-url/instance/connectionState/sua-instancia`
|
|
|
|
### Erro: "Nenhuma parcela encontrada"
|
|
|
|
**Verificar no banco:**
|
|
```sql
|
|
SELECT * FROM venda_parcelas
|
|
WHERE status = 'pendente'
|
|
AND data_vencimento >= CURRENT_DATE - INTERVAL '30 days';
|
|
```
|
|
|
|
Se não houver parcelas pendentes, está correto!
|
|
|
|
### Alertas não chegam no WhatsApp
|
|
|
|
**Verificar:**
|
|
1. Cliente tem WhatsApp cadastrado?
|
|
2. Número está correto? (apenas números)
|
|
3. Evolution está conectada?
|
|
4. Teste enviando mensagem manual pelo Chat
|
|
|
|
---
|
|
|
|
## 📞 Para a Venda de 20/10 (Problema Atual)
|
|
|
|
**Execute AGORA:**
|
|
|
|
```bash
|
|
cd /home/tiago/Downloads/app_estoque_v1.0.0
|
|
node scripts/enviar-alertas-atrasados.js
|
|
```
|
|
|
|
Isso irá:
|
|
1. ✅ Encontrar a parcela com vencimento em 24/10
|
|
2. ✅ Gerar PIX
|
|
3. ✅ Enviar WhatsApp com PIX
|
|
4. ✅ Registrar no histórico
|
|
|
|
**Depois:**
|
|
|
|
```bash
|
|
./scripts/instalar-cron-alertas.sh
|
|
```
|
|
|
|
Isso garante que **nunca mais** um alerta será esquecido!
|
|
|
|
---
|
|
|
|
## ✅ Checklist Final
|
|
|
|
Após seguir os 3 passos, verifique:
|
|
|
|
- [ ] Alertas atrasados enviados (script manual executado)
|
|
- [ ] Cron instalado (`crontab -l` mostra a linha)
|
|
- [ ] Evolution API configurada no admin
|
|
- [ ] Mercado Pago configurado no admin
|
|
- [ ] Toggles de alertas ATIVOS no admin
|
|
- [ ] Teste manual funcionou
|
|
- [ ] Logs sendo gerados em `/logs/alertas-cron.log`
|
|
|
|
Se todos estiverem ✅, sistema está 100% operacional!
|
|
|
|
---
|
|
|
|
## 📚 Documentação Completa
|
|
|
|
Para detalhes técnicos completos:
|
|
- `SISTEMA-ALERTAS-AUTOMATICOS.md` - Documentação técnica completa
|
|
- `scripts/enviar-alertas-parcelas.js` - Script principal (comentado)
|
|
- `scripts/instalar-cron-alertas.sh` - Instalador do cron
|
|
|
|
---
|
|
|
|
## 💡 Dica Final
|
|
|
|
**Monitore os primeiros dias:**
|
|
|
|
```bash
|
|
# Ver se cron executou às 09:00
|
|
tail -f logs/alertas-cron.log
|
|
```
|
|
|
|
**Amanhã (25/10) às 09:01**, verifique se:
|
|
- Log foi gerado
|
|
- Alertas foram enviados (se houver parcelas)
|
|
- Tudo funcionou
|
|
|
|
Se sim, sistema está perfeito! 🎉
|
|
|
|
---
|
|
|
|
**Desenvolvido para: Liberi Kids - Moda Infantil** 👗👕
|
|
**Problema resolvido em: 24/10/2025** ✅
|