🚀 Astra Campaign - Sistema Completo de Campanhas WhatsApp

Sistema profissional para campanhas de WhatsApp em massa com inteligência artificial integrada

🎯 Recursos • 🛠️ Instalação • 📚 Documentação • 🤝 Contribuição

📋 Sobre o Projeto

O Astra Campaign é uma plataforma completa e open-source para gerenciamento e execução de campanhas de WhatsApp em massa. Desenvolvido com tecnologias modernas, oferece recursos avançados como inteligência artificial para geração de mensagens personalizadas, multi-sessão com failover automático e interface intuitiva para gerenciamento de contatos e campanhas.

🔥 Open Source: Este projeto é totalmente gratuito e sem ligação alguma com o WhatsApp oficial. Utiliza a API WAHA para integração.

✨ Principais Diferenciais

🤖 IA Integrada: OpenAI e Groq para mensagens personalizadas
🔄 Multi-Sessão com Failover: Distribuição inteligente de envios
📊 Analytics Completo: Relatórios detalhados com exportação CSV
🎨 Interface Moderna: React com Tailwind CSS responsivo
🐳 Deploy Simplificado: Docker Swarm com Traefik

🎯 Recursos Principais

👥 Gerenciamento de Contatos

✅ CRUD completo de contatos
✅ Importação em massa via CSV
✅ Sistema de categorização com tags
✅ Validação de números telefônicos (formato E.164)
✅ Busca avançada e filtros inteligentes
✅ Paginação otimizada

📱 Conexões WhatsApp

✅ Múltiplas sessões simultâneas
✅ QR Code automático com expiração
✅ Status em tempo real das conexões
✅ Gerenciamento simplificado de sessões
✅ Reconnect automático em falhas

🎯 Campanhas Inteligentes

✅ Tipos de Mensagem: Texto, Imagem, Vídeo, Áudio, Documentos
✅ Sequências Complexas: Múltiplas mensagens em ordem
✅ IA Generativa: OpenAI e Groq para personalização
✅ Variáveis Dinâmicas: {{nome}}, {{telefone}}, {{email}}, {{categoria}}, {{observacoes}}
✅ Multi-Sessão: Distribuição automática entre conexões
✅ Agendamento: Execução imediata ou programada
✅ Controles: Pausar, retomar, cancelar campanhas
✅ Rate Limiting: Delays configuráveis para evitar bloqueios

📊 Relatórios e Analytics

✅ Dashboard em tempo real
✅ Estatísticas detalhadas (enviadas, falharam, pendentes)
✅ Distribuição por sessão WhatsApp
✅ Análise de erros categorizada
✅ Exportação completa em CSV
✅ Timeline de execução

👤 Sistema de Usuários

✅ Autenticação JWT segura
✅ Controle de acesso por roles
✅ Gerenciamento de usuários admin
✅ Hash bcrypt para senhas

⚙️ Configurações do Sistema

✅ Integração WAHA configurável
✅ Personalização visual (logo, favicon, títulos)
✅ Chaves de API para IA (OpenAI/Groq)
✅ Configuração via interface web

🛠️ Tecnologias Utilizadas

🎨 Frontend

React 18 - Framework JavaScript moderno
TypeScript - Tipagem estática para JavaScript
Vite - Build tool ultra-rápida
Tailwind CSS - Framework CSS utilitário
React Hook Form + Zod - Validação de formulários
React Hot Toast - Notificações elegantes
React Router Dom - Roteamento SPA

⚡ Backend

Node.js 20 - Runtime JavaScript
Express - Framework web minimalista
TypeScript - Tipagem estática
Prisma ORM - Object-Relational Mapping
bcryptjs - Hash de senhas
jsonwebtoken - Autenticação JWT
express-validator - Validação de dados
libphonenumber-js - Normalização de telefones

🗄️ Banco de Dados

PostgreSQL 16 - Banco de dados relacional
Prisma - ORM com type-safety

🐳 Infraestrutura

Docker & Docker Swarm - Containerização e orquestração
Traefik v2 - Proxy reverso e SSL automático
Nginx - Servidor web para frontend
Docker Hub - Imagens oficiais pré-construídas

🔌 Integrações

WAHA API - Interface WhatsApp Web
OpenAI API - GPT para geração de conteúdo
Groq API - IA ultra-rápida

🚀 Instalação

📋 Pré-requisitos

Docker 20.10+
Docker Compose/Swarm
Traefik configurado (para produção)
Instância WAHA rodando

🐳 Instalação via Docker (Recomendado)

Clone o repositório

git clone https://github.com/AstraOnlineWeb/astracampaign.git
cd astracampaign

Baixe as imagens oficiais

# Imagens pré-construídas no Docker Hub
docker pull astraonline/astracampaignbackend:latest
docker pull astraonline/astracampaignfrontend:latest

Configure as variáveis de ambiente

# Edite o docker-stack.yml com suas configurações
nano docker-stack.yml

Deploy no Docker Swarm

# Para produção
docker stack deploy -c docker-stack.yml astra-campaign

# Para desenvolvimento local
docker-compose up -d

🛠️ Desenvolvimento Local

Backend

cd backend
npm install
npm run migrate:prod  # Rodar migrações e seed
npm run dev          # Servidor de desenvolvimento

Frontend

cd frontend
npm install
npm run dev          # Servidor de desenvolvimento (porta 3000)

⚙️ Configuração Inicial

Acesse o sistema: http://localhost:3000
Login padrão: admin@astra.com.br / Admin123!
Configure WAHA: Vá em Configurações e adicione host/API key
Crie uma sessão WhatsApp: Na página de Conexões
Importe contatos: Via CSV ou manualmente
Crie sua primeira campanha: Na página de Campanhas

📚 Documentação

🔗 Endpoints da API

Autenticação

POST /api/auth/login - Login do usuário
POST /api/auth/logout - Logout do usuário

Contatos

GET /api/contatos - Listar contatos (com paginação/busca)
POST /api/contatos - Criar contato
PUT /api/contatos/:id - Atualizar contato
DELETE /api/contatos/:id - Excluir contato
POST /api/contatos/import - Importar CSV

Campanhas

GET /api/campaigns - Listar campanhas
POST /api/campaigns - Criar campanha
PATCH /api/campaigns/:id/toggle - Pausar/Retomar
DELETE /api/campaigns/:id - Excluir campanha
GET /api/campaigns/:id/report - Relatório detalhado

Sessões WhatsApp

GET /api/waha/sessions - Listar sessões
POST /api/waha/sessions - Criar sessão
DELETE /api/waha/sessions/:name - Remover sessão
POST /api/waha/sessions/:name/restart - Reiniciar

📊 Modelo de Dados

// Contato
interface Contact {
  id: string;
  nome: string;
  telefone: string; // E.164 format
  email?: string;
  tags: string[];
  observacoes?: string;
}

// Campanha
interface Campaign {
  id: string;
  nome: string;
  targetTags: string[];
  sessionNames: string[];
  messageType: 'text' | 'image' | 'video' | 'audio' | 'document' | 'sequence';
  messageContent: MessageContent;
  randomDelay: number;
  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'PAUSED' | 'FAILED';
}

🔧 Configuração Avançada

🔐 Variáveis de Ambiente

# Backend (.env)
DATABASE_URL=postgresql://user:pass@host:5432/db
JWT_SECRET=sua-chave-secreta-muito-segura
JWT_EXPIRES_IN=24h
DEFAULT_WAHA_HOST=http://waha:3000
DEFAULT_WAHA_API_KEY=sua-api-key

🐳 Docker Swarm Labels

# Traefik Labels para Produção
labels:
  - traefik.enable=true
  - traefik.http.routers.app.rule=Host(`seu-dominio.com`)
  - traefik.http.routers.app.tls.certresolver=letsencrypt

📝 Formato CSV para Importação

nome,telefone,email,tags,observacoes
João Silva,+5511999999999,joao@email.com,cliente;vip,Cliente preferencial
Maria Santos,+5511888888888,maria@email.com,prospect,Interessada em produto X

🚀 Deploy em Produção

🔧 Build das Imagens

# Usar imagens oficiais do Docker Hub
docker pull astraonline/astracampaignbackend:latest
docker pull astraonline/astracampaignfrontend:latest

# Ou fazer build personalizado (opcional)
cd backend
docker build -t astraonline/astracampaignbackend:latest .

cd ../frontend
docker build -t astraonline/astracampaignfrontend:latest .

📊 Monitoramento

# Status dos serviços
docker service ls

# Logs em tempo real
docker service logs -f astra-campaign_backend
docker service logs -f astra-campaign_frontend

# Restart de serviços
docker service update --force astra-campaign_backend

🤝 Contribuindo

Contribuições são muito bem-vindas! Este é um projeto open-source mantido pela comunidade.

🛠️ Como Contribuir

Fork o repositório
Crie uma branch para sua feature (git checkout -b feature/nova-feature)
Commit suas mudanças (git commit -m 'Adiciona nova feature')
Push para a branch (git push origin feature/nova-feature)
Abra um Pull Request

📝 Reportar Bugs

Use o sistema de Issues
Descreva o problema detalhadamente
Inclua logs relevantes
Especifique ambiente (OS, Docker version, etc.)

💡 Sugerir Features

Abra uma Issue com o label enhancement
Descreva a funcionalidade desejada
Explique o caso de uso

📄 Licença

Este projeto está licenciado sob a GNU Affero General Public License v3.0 (AGPLv3) - veja o arquivo LICENSE para detalhes.

⚖️ Termos de Uso

✅ Uso comercial permitido
✅ Modificação permitida
✅ Distribuição permitida
✅ Uso privado permitido
✅ Uso em rede/web permitido
⚠️ Copyleft forte: Modificações devem ser disponibilizadas sob a mesma licença
⚠️ Divulgação de código: Serviços web baseados no projeto devem disponibilizar o código fonte
❌ Sem garantias
❌ Sem responsabilidade dos autores

Importante: A licença AGPLv3 requer que qualquer versão modificada do software, incluindo aquelas usadas para fornecer serviços através de uma rede, tenha seu código fonte disponibilizado publicamente.

⚠️ Disclaimer

IMPORTANTE: Este projeto é independente e não possui ligação alguma com o WhatsApp oficial, Meta ou Facebook. Use por sua própria conta e risco, respeitando os termos de serviço do WhatsApp.

🔒 Recomendações de Uso

✅ Respeite os limites do WhatsApp
✅ Use delays apropriados entre mensagens
✅ Não envie spam
✅ Obtenha consentimento dos destinatários
✅ Mantenha o sistema atualizado

🙏 Agradecimentos

WAHA - API WhatsApp Web
Prisma - ORM TypeScript
Tailwind CSS - Framework CSS
React - Biblioteca JavaScript
Comunidade Open Source - Por tornar projetos como este possíveis

📞 Suporte

💬 Comunidade

💬 Grupo WhatsApp - Comunidade aberta para discussões
💬 Discussions - Discussões técnicas no GitHub
🐛 Issues - Bugs e features

🛠️ Suporte Profissional

Precisa de ajuda para melhorar, customizar ou implementar o projeto?

📱 WhatsApp: +55 61 9 9687-8959

💼 Temos uma equipe especializada para:

✅ Customizações e melhorias
✅ Implementação e deploy
✅ Integração com outras APIs
✅ Desenvolvimento de features específicas
✅ Suporte técnico dedicado
✅ Consultoria em automação WhatsApp

📚 Recursos Úteis

⭐ Se este projeto foi útil para você, considere dar uma estrela no GitHub! ⭐

Feito com ❤️ pela comunidade open-source

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
backend		backend
frontend		frontend
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
docker-stack.yml		docker-stack.yml
imagens		imagens

License

gpuentes/disparador

Folders and files

Latest commit

History

Repository files navigation