- ✅ **Importação de Leads** - Sincronize leads do Perfex CRM como contatos
- ✅ **Sincronização Bidirecional** - Mantenha dados atualizados entre sistemas
- ✅ **Mapeamento de Campos** - Configure campos customizados
- ✅ **Node Dedicado** - Use Perfex diretamente nos fluxos interativos
### 🎛️ **Controle de Provedores por Tenant**
- ✅ **Provedores Configuráveis** - Cada tenant escolhe entre WAHA, Evolution API ou QuePasa
- ✅ **Flexibilidade Total** - Habilite apenas os provedores necessários
- ✅ **Interface Simplificada** - Seleção visual de provedores
### 🔐 **Sistema de Webhooks Seguro**
- ✅ **+19 Componentes** - Novos componentes React para fluxos
- ✅ **+10 Services** - Nova arquitetura de serviços
- ✅ **+9 Rotas API** - Endpoints para campanhas interativas
- ✅ **+5 Modelos Prisma** - Novos models no banco de dados
- ✅ **Documentação Completa** - Guias, API e testes
📖 **[Ver Changelog Completo](https://github.com/AstraOnlineWeb/astracampaign/blob/main/RELEASE_v0.0.3.txt)** | **[Guia de Campanhas Interativas](https://github.com/AstraOnlineWeb/astracampaign/blob/main/CAMPANHA_INTERATIVA_README.md)**
---
## 📋 Sobre o Projeto
O **Astra Campaign** é uma **plataforma SaaS multi-tenant** completa e open-source para gerenciamento e execução de campanhas de WhatsApp em massa e interativas. Desenvolvido com arquitetura moderna, oferece recursos enterprise como isolamento total de dados por empresa, sistema de quotas, backup/restore automatizado, inteligência artificial para personalização de mensagens, **flow builder visual para conversas interativas**, suporte a múltiplos provedores WhatsApp (WAHA, Evolution API e QuePasa), além de integrações com Chatwoot e Perfex CRM.
> 🔥 **Open Source & SaaS Ready**: Projeto totalmente gratuito com arquitetura multi-tenant pronta para comercialização. Sem ligação alguma com o WhatsApp oficial.
### ✨ Principais Diferenciais
- 🎨 **Flow Builder Visual**: Crie conversas interativas com editor Drag & Drop (ReactFlow)
- 🤖 **Campanhas Interativas**: Fluxos bidirecionais com IA, condições e integrações
- 🏢 **Multi-Tenant (SaaS)**: Isolamento completo de dados por empresa
- 🔌 **Múltiplos Provedores**: WAHA API, Evolution API e QuePasa (configurável por tenant)
- 🤖 **IA Integrada**: OpenAI e Groq para mensagens personalizadas e processamento de respostas
- 💬 **Integração Chatwoot**: Importação de contatos e criação de tickets
- 💼 **Integração Perfex CRM**: Sincronização de leads e dados bidirecionais
- 🎲 **Randomização Inteligente**: Textos, imagens, vídeos e arquivos aleatórios
- 🔄 **Multi-Sessão com Failover**: Distribuição inteligente de envios
- 🔐 **Webhooks Seguros**: HMAC-SHA256 para validação de webhooks
- 💾 **Backup & Restore**: Sistema automatizado de backup e restauração
- 📊 **Analytics Completo**: Relatórios detalhados com exportação CSV
- 👥 **Sistema de Roles**: SUPERADMIN, ADMIN e USER
- ⚖️ **Sistema de Quotas**: Controle de limites por tenant
- 🎨 **White Label**: Personalização completa da marca
- 🐳 **Deploy Simplificado**: Docker Swarm com Traefik
---
## 🎯 Recursos Principais
- ✅ **Editor Visual Drag & Drop**: Construa fluxos complexos com interface intuitiva
- ✅ **12+ Tipos de Nodes**: Trigger, Text, Image, Video, Audio, Document, Condition, Delay, AI, HTTP REST, Integrations, Stop
- ✅ **Nodes de Condição**: Crie ramificações baseadas em respostas dos contatos
- ✅ **Processamento com IA**: OpenAI e Groq integrados para respostas inteligentes
- ✅ **HTTP REST Node**: Faça requisições a APIs externas durante o fluxo
- ✅ **Integração Chatwoot**: Crie tickets automaticamente no Chatwoot
- ✅ **Integração Perfex**: Atualize leads no CRM durante conversas
- ✅ **Sistema de Sessões**: Rastreamento completo do estado de cada contato
- ✅ **Webhooks Bidirecionais**: Receba e responda mensagens automaticamente
- ✅ **Preview de Fluxo**: Visualize o fluxo completo antes de publicar
- ✅ **Simulação**: Teste fluxos antes de ativar para contatos reais
### 💼 **Integração Perfex CRM** (NOVO v0.0.4)
- ✅ **Importação de Leads**: Busque leads do Perfex e converta em contatos
- ✅ **Sincronização Automática**: Mantenha dados atualizados entre sistemas
- ✅ **Configuração por Tenant**: Cada empresa usa seu próprio Perfex
- ✅ **Node de Integração**: Use Perfex dentro de fluxos interativos
- ✅ **Mapeamento de Campos**: Configure quais campos sincronizar
### 🏢 **Arquitetura Multi-Tenant (SaaS)**
- ✅ Isolamento completo de dados por empresa (tenant)
- ✅ Sistema de quotas personalizáveis (usuários, contatos, campanhas, conexões)
- ✅ Gerenciamento centralizado via Super Admin
- ✅ White Label: Logo, favicon, cores e títulos personalizáveis
- ✅ Planos e limites configuráveis por tenant
- ✅ Associação many-to-many usuário-tenant
- ✅ Mensagens amigáveis para upgrade de plano
### 💾 **Backup & Restore**
- ✅ Backup automático agendado (cron configurável)
- ✅ Backup manual sob demanda
- ✅ Restauração completa do banco de dados
- ✅ Histórico de backups com metadados
- ✅ Armazenamento seguro em volumes Docker
- ✅ Gerenciamento via interface web
### 👥 **Gerenciamento de Contatos**
- ✅ CRUD completo de contatos
- ✅ Importação em massa via CSV
- ✅ **Importação do Chatwoot**: Sincronização de contatos do Chatwoot
- ✅ **Importação do Perfex CRM**: Sincronização de leads do Perfex (NOVO v0.0.4)
- ✅ 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
- ✅ Isolamento por tenant
- ✅ Edição em massa de contatos
### 📱 **Conexões WhatsApp (Múltiplos Provedores)**
- ✅ **WAHA API**: Suporte completo com QR Code
- ✅ **Evolution API**: Integração nativa com Evolution
- ✅ **QuePasa**: Integração com API QuePasa
- ✅ **Configuração por Tenant**: Escolha quais provedores habilitar (NOVO v0.0.4)
- ✅ Múltiplas sessões simultâneas por tenant
- ✅ QR Code automático com expiração
- ✅ Status em tempo real das conexões
- ✅ Gerenciamento simplificado de sessões
- ✅ Reconnect automático em falhas
- ✅ Seleção de provedor ao criar sessão
- ✅ Webhooks para campanhas interativas (NOVO v0.0.4)
### 🎯 **Campanhas Inteligentes**
- ✅ **Textos Aleatórios**: Pool de mensagens para variar conteúdo
- ✅ **Imagens Aleatórias**: Múltiplas imagens no pool
- ✅ **Vídeos Aleatórios**: Seleção aleatória de vídeos
- ✅ **Arquivos Aleatórios**: Documentos variados por envio
- ✅ **Legendas Variadas**: Textos diferentes para cada mídia
- ✅ **Humanização**: Evita detecção de envios automatizados
### 📊 **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
- ✅ Métricas por tenant
### 👤 **Sistema de Usuários e Roles**
- ✅ Configurações globais (Super Admin)
- ✅ Configurações por tenant
- ✅ Integração WAHA configurável
- ✅ Integração Evolution API configurável
- ✅ Personalização visual (logo, favicon, cores, títulos)
- ✅ Chaves de API para IA (OpenAI/Groq) por tenant
- ✅ Gerenciamento de quotas por tenant
- ✅ Sistema de alertas e notificações
### 🔔 **Sistema de Alertas e Monitoramento**
- ✅ Alertas de quota (85% e 100% de uso)
- ✅ Monitoramento de saúde do sistema
- ✅ Notificações de falhas de conexão
- ✅ Dashboard de alertas ativos
- ✅ Auto-resolução de alertas antigos
---
## 🛠️ Tecnologias Utilizadas
- **WAHA API** - WhatsApp Web API
- **Evolution API** - API alternativa para WhatsApp
- **QuePasa** - API WhatsApp multi-dispositivo
- **Chatwoot** - Importação de contatos e criação de tickets
- **Perfex CRM** - Sincronização de leads e gestão de CRM (NOVO v0.0.4)
- **OpenAI API** - GPT para geração de conteúdo e processamento de respostas
- **Groq API** - IA ultra-rápida para fluxos interativos
- **ReactFlow** - Editor visual de fluxos (NOVO v0.0.4)
---
## 🚀 Instalação
1. **Acesse o sistema**: `http://localhost` ou seu domínio
2. **Login padrão SUPERADMIN**: `superadmin@astraonline.com.br` / `Admin123`
3. **Login padrão ADMIN**: `admin@astraonline.com.br` / `Admin123`
4. **Configure provedores**: Vá em Configurações e adicione WAHA/Evolution/QuePasa
5. **Configure Chatwoot** (opcional): Adicione URL e token do Chatwoot em Configurações
6. **Crie empresas**: Como SUPERADMIN, crie novos tenants
7. **Crie uma sessão WhatsApp**: Na página de Conexões (escolha o provedor)
8. **Importe contatos**: Via CSV, Chatwoot ou manualmente
9. **Crie sua primeira campanha**: Na página de Campanhas
---
## 📚 Documentação
```
nome,telefone,email,categoria,observacoes
João Silva,+5511999999999,joao@email.com,Cliente VIP,Cliente preferencial
Maria Santos,+5511888888888,maria@email.com,Prospect,Interessada em produto X
```
Para importar contatos do Chatwoot:
1. **Configure o Chatwoot** nas configurações do tenant:
- URL do Chatwoot: `https://seu-chatwoot.com`
- Token de API: Obtenha em Perfil → Tokens de Acesso
2. **Importe os contatos**:
- Acesse a página de Contatos
- Clique em "Importar do Chatwoot"
- Selecione a categoria desejada
- Os contatos serão sincronizados automaticamente
3. **Dados importados**:
- Nome do contato
- Número de telefone
- Email
- Categoria (configurável)
### 🔌 **Configuração do QuePasa**
Para usar o QuePasa como provedor WhatsApp:
1. **Configure o QuePasa** nas configurações:
- Host: `https://seu-quepasa.com` ou `http://ip:31000`
- Token: Token de autenticação do QuePasa
2. **Crie uma sessão**:
- Na página de Conexões WhatsApp
- Selecione "QuePasa" como provedor
- O token será gerado automaticamente
- Escaneie o QR Code com o WhatsApp
3. **Recursos suportados**:
- Envio de mensagens de texto
- Envio de imagens com legenda
- Envio de vídeos com legenda
- Envio de documentos
- Status da conexão em tempo real
### 🎲 **Randomização de Conteúdo**
```
# Status dos serviços
docker service ls
# Logs em tempo real
docker service logs -f work_backend
docker service logs -f work_frontend
# Restart de serviços
docker service update --force work_backend
# Verificar health
curl http://localhost:3001/api/health
```
1. **Fork** o repositório
2. **Crie** uma branch para sua feature (`git checkout -b feature/nova-feature`)
3. **Commit** suas mudanças (`git commit -m 'Adiciona nova feature'`)
4. **Push** para a branch (`git push origin feature/nova-feature`)
5. **Abra** um Pull Request
### 📝 **Reportar Bugs**
- Use o sistema de [Issues](https://github.com/AstraOnlineWeb/astracampaign/issues)
- Descreva o problema detalhadamente
- Inclua logs relevantes
- Especifique ambiente (OS, Docker version, etc.)
### 💡 **Sugerir Features**
- Abra uma [Issue](https://github.com/AstraOnlineWeb/astracampaign/issues) 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](https://github.com/AstraOnlineWeb/astracampaign/blob/main/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 (recomendado: 5-10 segundos)
- ✅ Use randomização para humanizar os envios
- ✅ Não envie spam
- ✅ Obtenha consentimento dos destinatários
- ✅ Mantenha o sistema atualizado
- ✅ Faça backups regulares
---
## 🙏 Agradecimentos
- **[WAHA](https://waha.devlike.pro/)** - API WhatsApp Web
- **[Evolution API](https://evolution-api.com/)** - API alternativa para WhatsApp
- **[QuePasa](https://github.com/nocodeleaks/quepasa)** - API WhatsApp multi-dispositivo
- **[Chatwoot](https://www.chatwoot.com/)** - Plataforma de atendimento ao cliente
- **[Prisma](https://prisma.io/)** - ORM TypeScript
- **[Tailwind CSS](https://tailwindcss.com/)** - Framework CSS
- **[React](https://reactjs.org/)** - Biblioteca JavaScript
- **Comunidade Open Source** - Por tornar projetos como este possíveis
---
## 📞 Suporte
**Precisa de ajuda para melhorar, customizar ou implementar o projeto?**
📱 **WhatsApp**: [+55 61 9 9687-8959](https://wa.me/5561996878959)
💼 Temos uma equipe especializada para:
- ✅ Customizações e melhorias
- ✅ Implementação e deploy completo
- ✅ Configuração de arquitetura SaaS
- ✅ Integração com outras APIs
- ✅ Desenvolvimento de features específicas
- ✅ Suporte técnico dedicado
- ✅ Consultoria em automação WhatsApp
- ✅ Treinamento e documentação
### 📚 **Recursos Úteis**