🤖 Bot WhatsApp Completo v4.0

Sistema completo de atendimento automatizado para WhatsApp com dashboard web, autenticação, agendamento de mensagens e integração com Google Calendar.

⚠️ Aviso Importante

Este projeto é apenas para fins educacionais.

Utiliza bibliotecas não-oficiais que violam os Termos de Serviço do WhatsApp e pode resultar em banimento da conta. NÃO use em números comerciais importantes.

Para uso profissional, utilize a WhatsApp Business API oficial.

🎯 Funcionalidades

🤖 Bot WhatsApp

✅ Atendimento automatizado 24/7
✅ Menu interativo com opções personalizáveis
✅ Histórico completo de conversas
✅ Respostas contextuais
✅ Simulação de "digitando..."
✅ Salvamento automático no banco de dados

📊 Dashboard Web

✅ Interface moderna e responsiva
✅ Estatísticas em tempo real
✅ Gerenciamento de contatos
✅ Histórico completo de mensagens
✅ Busca avançada
✅ Gráficos de atividade
✅ Atualização automática (30s)

🔐 Sistema de Autenticação

✅ Login seguro com JWT
✅ Tokens com expiração configurável (24h)
✅ 3 níveis de acesso:
- Admin: Acesso total
- Atendente: Criar e gerenciar agendamentos
- Visualizador: Apenas visualizar dados
✅ Bloqueio após 5 tentativas falhas (15 min)
✅ Alteração de senha
✅ Gestão de usuários

📅 Agendamento de Mensagens

✅ Mensagens Únicas: Agende para data/hora específica
✅ Mensagens Recorrentes:
- Diária: Todos os dias
- Semanal: Dias da semana específicos
- Mensal: Dia do mês específico
✅ Processamento automático a cada minuto
✅ Retry automático em caso de falha (até 3x)
✅ Variáveis dinâmicas: {nome}, {data}, {hora}
✅ Cancelamento de agendamentos
✅ Estatísticas detalhadas

📆 Integração Google Calendar

✅ Autenticação OAuth 2.0
✅ Criar eventos automaticamente
✅ Sincronizar agendamentos do bot
✅ Suporte a eventos recorrentes
✅ Visualizar próximos eventos
✅ Lembretes configuráveis
✅ Link direto para eventos

🗄️ Banco de Dados MongoDB

✅ Armazenamento de mensagens
✅ Cadastro de contatos
✅ Estatísticas diárias
✅ Configurações personalizáveis
✅ Índices otimizados
✅ Busca avançada

🔌 API REST

✅ 30+ endpoints documentados
✅ Autenticação JWT em todas rotas
✅ Tratamento de erros robusto
✅ Responses padronizados
✅ CORS configurado

📋 Pré-requisitos

Node.js 16.0.0 ou superior
MongoDB instalado e rodando
NPM 7.0.0 ou superior
Google Chrome (para WhatsApp)
Número de WhatsApp para teste
(Opcional) Conta Google para Calendar

🚀 Instalação

1. Clone ou Crie o Projeto

mkdir bot-whatsapp-completo
cd bot-whatsapp-completo
mkdir public

2. Instale o MongoDB

Windows:

choco install mongodb

Linux (Ubuntu/Debian):

sudo apt-get update
sudo apt-get install -y mongodb
sudo systemctl start mongodb
sudo systemctl enable mongodb

macOS:

brew tap mongodb/brew
brew install mongodb-community
brew services start mongodb-community

3. Crie os Arquivos

Copie todos os arquivos fornecidos nos artefatos para as respectivas pastas (consulte GUIA COMPLETO - Todos os Arquivos).

4. Instale as Dependências

npm install

5. Configure as Variáveis de Ambiente

cp .env.example .env
nano .env

IMPORTANTE: Altere o JWT_SECRET para um valor único e seguro:

JWT_SECRET=seu-secret-super-seguro-aqui-xyz789

6. Inicie o Sistema

Opção 1: Tudo Junto (Recomendado)

npm run start:all

Opção 2: Separado

# Terminal 1 - Bot
npm start

# Terminal 2 - Dashboard
npm run dashboard

7. Conecte o WhatsApp

Aguarde o QR Code aparecer no terminal
Abra o WhatsApp no celular
Vá em: Menu (⋮) > Aparelhos conectados > Conectar aparelho
Escaneie o QR Code
✅ Bot conectado!

8. Acesse o Dashboard

Abra o navegador: http://localhost:3000
Faça login com:
- Email: admin@bot.com
- Senha: admin123
⚠️ IMPORTANTE: Altere a senha imediatamente!

📱 Comandos do Bot

Comando	Descrição
`/menu` ou `menu`	Exibe o menu principal
`1`	Horário de atendimento
`2`	Serviços disponíveis
`3`	Falar com atendente
`4`	Sobre nós
`5`	Ver histórico de conversas
`oi`, `olá`, `ola`	Saudação inicial
`obrigado`, `valeu`	Agradecimento

🎨 Usando o Dashboard

Página Principal

Cards de Estatísticas: Mensagens hoje, total de contatos, contatos ativos, mensagens da semana
Atualização Automática: Dados atualizados automaticamente a cada 30 segundos

Aba Contatos

Lista completa de todos os contatos
Busca por nome ou telefone
Total de mensagens por contato
Data do último contato
Status (ativo/inativo/bloqueado)
Clique em um contato para ver histórico completo

Aba Mensagens

Visualização de todas as conversas
Busca por conteúdo de mensagens
Interface estilo chat
Filtros por data

Aba Agendamentos

Botão "+ Nova Mensagem": Criar novo agendamento
Filtros: Por status (pendente, enviada, falhada, cancelada) e tipo (única, recorrente)
Estatísticas: Pendentes, enviadas e recorrentes ativas
Integração Google Calendar: Conectar, sincronizar e visualizar eventos
Ações: Cancelar agendamentos e sincronizar com Calendar

Aba Estatísticas

Gráfico de mensagens dos últimos 7 dias
Análise de tendências
Métricas de atividade

📅 Agendamento de Mensagens

Mensagem Única

Agende uma mensagem para ser enviada em data e hora específicas.

Exemplo:

Contato: João Silva
Mensagem: Lembrete: Reunião amanhã às 14h!
Data: 25/12/2024 09:00

Mensagem Recorrente

Diária

Enviada todos os dias no horário especificado.

Horário: 08:00
Mensagem: Bom dia! Lembrete diário.

Semanal

Enviada nos dias da semana selecionados.

Dias: Segunda, Quarta, Sexta
Horário: 14:00
Mensagem: Follow-up semanal!

Mensal

Enviada no dia do mês especificado.

Dia: 25
Horário: 16:00
Mensagem: Relatório mensal disponível.

Variáveis Dinâmicas

Use variáveis nas mensagens:

Olá {nome}!

Hoje é {data} e são {hora}.

Lembrete importante para você!

🔗 Integração com Google Calendar

Configuração

Veja o guia completo em: GUIA_GOOGLE_CALENDAR.md

Resumo:

Crie projeto no Google Cloud Console
Ative Google Calendar API
Crie credenciais OAuth 2.0
Baixe google-credentials.json
Coloque na raiz do projeto
Reinicie o sistema
No dashboard: Conectar Google Calendar

Uso

Conectar: Clique em "Conectar Google Calendar" na aba Agendamentos
Sincronizar Individual: Clique no botão "📅 Sync" ao lado do agendamento
Sincronizar Todos: Clique em "🔄 Sincronizar Todos"
Ver Eventos: Lista de próximos 5 eventos aparece automaticamente

🔐 Sistema de Usuários

Níveis de Acesso

Funcionalidade	Admin	Atendente	Visualizador
Ver Dashboard	✅	✅	✅
Ver Contatos/Mensagens	✅	✅	✅
Agendar Mensagens	✅	✅	❌
Cancelar Agendamentos	✅	Próprios	❌
Criar Usuários	✅	❌	❌
Alterar Configurações	✅	❌	❌
Conectar Google Calendar	✅	✅	❌

Criar Novo Usuário

Via Dashboard (Admin):

Menu do usuário > Gerenciar Usuários
- Novo Usuário
Preencha: Nome, Email, Senha, Role
Salvar

Via API:

curl -X POST http://localhost:3000/api/usuarios \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "João Silva",
    "email": "joao@empresa.com",
    "senha": "senha123",
    "role": "atendente"
  }'

🔌 API REST

Autenticação

Todas as rotas (exceto login) requerem token JWT no header:

Authorization: Bearer SEU_TOKEN

Principais Endpoints

Autenticação

POST /api/auth/login - Login
GET /api/auth/verificar - Verificar token

Usuários

POST /api/usuarios - Criar usuário (admin)
GET /api/usuarios - Listar usuários (admin)
POST /api/usuarios/senha - Alterar senha

Dashboard

GET /api/dashboard - Estatísticas gerais
GET /api/contatos - Listar contatos
GET /api/contatos/:chatId - Detalhes do contato
GET /api/historico/:chatId - Histórico de conversa
GET /api/mensagens - Mensagens por período
GET /api/estatisticas - Estatísticas por período

Agendamentos

POST /api/agendamentos - Agendar mensagem única
POST /api/agendamentos/recorrente - Agendar recorrente
GET /api/agendamentos - Listar agendamentos
DELETE /api/agendamentos/:id - Cancelar agendamento
GET /api/agendamentos/stats - Estatísticas

Google Calendar

GET /api/google-calendar/status - Status conexão
GET /api/google-calendar/auth-url - URL autorização
DELETE /api/google-calendar/disconnect - Desconectar
POST /api/google-calendar/eventos - Criar evento
GET /api/google-calendar/eventos - Listar eventos
POST /api/google-calendar/sincronizar/:id - Sincronizar

🗄️ Estrutura do Banco de Dados

Coleções

mensagens

{
  chatId: String,
  nomeContato: String,
  mensagem: String,
  resposta: String,
  tipo: String, // 'recebida' ou 'enviada'
  timestamp: Date
}

contatos

{
  chatId: String,
  nome: String,
  telefone: String,
  primeiroContato: Date,
  ultimoContato: Date,
  totalMensagens: Number,
  status: String, // 'ativo', 'inativo', 'bloqueado'
  tags: [String],
  notas: String
}

usuarios

{
  nome: String,
  email: String,
  senha: String, // hash bcrypt
  role: String, // 'admin', 'atendente', 'visualizador'
  ativo: Boolean,
  ultimoLogin: Date,
  tentativasLogin: Number,
  bloqueadoAte: Date
}

mensagensagendadas

{
  chatId: String,
  nomeContato: String,
  mensagem: String,
  dataAgendamento: Date,
  status: String, // 'pendente', 'enviada', 'falhou', 'cancelada'
  tipo: String, // 'unica', 'recorrente'
  recorrencia: {
    frequencia: String,
    diasSemana: [Number],
    diaMes: Number,
    horario: String
  },
  googleCalendarEventId: String
}

🛠️ Personalização

Modificar Respostas do Bot

Edite bot-v2.js:

const respostas = {
  '/menu': `🤖 *Seu Menu Personalizado*\n\n...`,
  '1': `Sua resposta personalizada`,
  // Adicione mais opções
  '6': `Nova opção aqui`
};

Adicionar Novos Comandos

async function processarMensagem(mensagem, chatId) {
  const texto = mensagem.toLowerCase().trim();
  
  // Seu novo comando
  if (texto.includes('palavra-chave')) {
    return 'Sua resposta personalizada';
  }
  
  // ... resto do código
}

Customizar Dashboard

Edite public/index.html para:

Alterar cores e estilos
Adicionar novos cards
Modificar layout
Incluir novas funcionalidades

🐛 Solução de Problemas

MongoDB não conecta

# Verificar status
sudo systemctl status mongodb

# Iniciar
sudo systemctl start mongodb

QR Code não aparece

Edite bot-v2.js:

headless: false // Altere de true para false

Porta 3000 em uso

No .env:

PORT=3001

Token inválido/expirado

Faça logout e login novamente
Verifique se JWT_SECRET está correto no .env

Mensagens não são enviadas

Confirme que bot está conectado
Veja logs no console
Verifique conexão com internet

Agendamentos não executam

Verifique se MongoDB está rodando
Confirme que data/hora são futuras
Veja status no dashboard

Google Calendar não conecta

Verifique google-credentials.json na raiz
Confirme redirect URI no Google Cloud Console
Adicione seu email como usuário de teste

📚 Documentação Adicional

QUICK_START.md - Guia de início rápido
GUIA_AUTH_SCHEDULER.md - Autenticação e agendamento
GUIA_GOOGLE_CALENDAR.md - Integração Google Calendar

🔒 Segurança

Boas Práticas

✅ Altere a senha admin após primeiro login
✅ Mude JWT_SECRET no .env (produção)
✅ Não commite credenciais no git
✅ Use HTTPS em produção
✅ Configure firewall adequadamente
✅ Faça backup regular do MongoDB
✅ Monitore logs de acesso
✅ Revise permissões de usuários

Em Produção

Use variáveis de ambiente seguras
Configure SSL/TLS
Implemente rate limiting
Adicione logging avançado
Configure monitoramento
Use serviço gerenciado de MongoDB
Habilite autenticação MongoDB

📊 Performance

Limites Recomendados

Contatos simultâneos: 100-200
Mensagens/dia: 1000-2000
Agendamentos ativos: 500
Usuários logados: 10-20

Otimizações

Índices MongoDB otimizados
Cache de consultas frequentes
Lazy loading no frontend
Paginação de resultados
Compressão de responses

🤝 Contribuindo

Este é um projeto educacional. Sugestões e melhorias são bem-vindas!

📄 Licença

MIT License - Apenas para fins educacionais

⚖️ Considerações Legais

Para uso profissional:

Utilize a WhatsApp Business API oficial
Contrate um Business Solution Provider (BSP)
Siga todos os Termos de Serviço
Implemente compliance LGPD/GDPR
Obtenha consentimento dos usuários

🆘 Suporte

Logs Úteis

# Logs do Bot e Dashboard
# Veja no console onde executou npm start

# Logs MongoDB
sudo journalctl -u mongodb

# Limpar logs
npm run clean-logs

Resetar Sistema

# Limpar banco de dados
mongo whatsapp-bot --eval "db.dropDatabase()"

# Remover sessão WhatsApp
rm -rf tokens/

# Reinstalar dependências
rm -rf node_modules
npm install

🚀 Roadmap Futuro

Possíveis melhorias:

Desenvolvido para aprendizado e experimentação 🚀

Para dúvidas, consulte a documentação completa ou os guias específicos.

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
public		public
.env.example		.env.example
.gitignore		.gitignore
EXECUTIVE_SUMMARY.md		EXECUTIVE_SUMMARY.md
GUIA_AUTH_SCHEDULER.md		GUIA_AUTH_SCHEDULER.md
GUIA_GOOGLE_CALENDAR.md		GUIA_GOOGLE_CALENDAR.md
LICENSE.txt		LICENSE.txt
QUICK_START.md		QUICK_START.md
README.md		README.md
auth.js		auth.js
bot-v2.js		bot-v2.js
database.js		database.js
google-calendar.js		google-calendar.js
package.json		package.json
scheduler.js		scheduler.js
server.js		server.js
start-all.js		start-all.js

Folders and files

Latest commit

History

Repository files navigation

🤖 Bot WhatsApp Completo v4.0

⚠️ Aviso Importante

🎯 Funcionalidades

🤖 Bot WhatsApp

📊 Dashboard Web

🔐 Sistema de Autenticação

📅 Agendamento de Mensagens

📆 Integração Google Calendar

🗄️ Banco de Dados MongoDB

🔌 API REST

📋 Pré-requisitos

🚀 Instalação

1. Clone ou Crie o Projeto

2. Instale o MongoDB

3. Crie os Arquivos

4. Instale as Dependências

5. Configure as Variáveis de Ambiente

6. Inicie o Sistema

7. Conecte o WhatsApp

8. Acesse o Dashboard

📱 Comandos do Bot

🎨 Usando o Dashboard

Página Principal

Aba Contatos

Aba Mensagens

Aba Agendamentos

Aba Estatísticas

📅 Agendamento de Mensagens

Mensagem Única

Mensagem Recorrente

Diária

Semanal

Mensal

Variáveis Dinâmicas

🔗 Integração com Google Calendar

Configuração

Uso

🔐 Sistema de Usuários

Níveis de Acesso

Criar Novo Usuário

🔌 API REST

Autenticação

Principais Endpoints

Autenticação

Usuários

Dashboard

Agendamentos

Google Calendar

🗄️ Estrutura do Banco de Dados

Coleções

mensagens

contatos

usuarios

mensagensagendadas

🛠️ Personalização

Modificar Respostas do Bot

Adicionar Novos Comandos

Customizar Dashboard

🐛 Solução de Problemas

MongoDB não conecta

QR Code não aparece

Porta 3000 em uso

Token inválido/expirado

Mensagens não são enviadas

Agendamentos não executam

Google Calendar não conecta

📚 Documentação Adicional

🔒 Segurança

Boas Práticas

Em Produção

📊 Performance

Limites Recomendados

Otimizações

🤝 Contribuindo

📄 Licença

⚖️ Considerações Legais

Packages