marcolamaia / MarcFlow

# MarcFlow
**Automação de WhatsApp com fluxos visuais, campanhas, grupos e respostas rápidas.**
Criado por **Marcos Maia** · @marcolamaia
---
## O que o MarcFlow faz
- **Fluxos de conversa:** construtor visual com mensagens, menus, condições, ações, atrasos e etiquetas. Inclui simulador para testar o rascunho sem enviar nada pelo WhatsApp.
- **Transmissões:** campanhas com variáveis, mídia, agendamento, intervalo entre envios, pausa e lista de quem pediu para sair.
- **Grupos:** categorias, ações em lote, sair e apagar de verdade, criar grupo e conversa do grupo no painel.
- **Respostas rápidas:** sequências de texto, mídia, voz, etiquetas e mais, disparadas da conversa aberta.
- **Conversas:** caixa de entrada em tempo real, notas de voz que tocam no iPhone e aviso de robô pausado durante o atendimento humano.
- **Exportar conversas:** selecione várias conversas (ou todas) e baixe um ZIP com uma pasta por conversa: histórico em TXT, áudios originais e, se quiser, fotos, vídeos e documentos. O sistema junta o que já tem salvo e pede ao celular o histórico antigo; o WhatsApp não garante entregar tudo, e o que faltar vai listado no relatório do ZIP.
- **API REST e webhooks:** documentação interativa em `/docs`.
## Instalação
### Requisitos
- Node.js 20+ (22 recomendado)
- MySQL
- ffmpeg (para notas de voz)
- PM2 para rodar em produção: `npm install -g pm2`
### Configuração
 [code] 
### Desenvolvimento
 [code] 
### Produção com PM2
O script `start.sh` confere a configuração, instala dependências, sincroniza o banco, compila e inicia (ou recarrega) o PM2:
 [code] 
Ou manualmente:
 [code] 
Comandos úteis: `pm2 status`, `pm2 logs marcflow`, `pm2 restart marcflow`.
### Docker
 [code] 
## Documentação
- API completa: docs/API_DOCUMENTATION.md
- Referência rápida: docs/API-QUICK-REFERENCE.md
- Variáveis de ambiente: docs/ENVIRONMENT_VARIABLES.md
- Swagger UI interativo: `/docs` com o app rodando
## Licença
MIT. Veja LICENSE.
---
 Feito por Marcos Maia