Jatovendas

[traderjatoba-ux]

Criar uma API profissional chamada JatoVendas API para automação de WhatsApp, CRM, disparos autorizados, agendamentos e gestão por licença.

OBJETIVO:
Desenvolver uma API backend pronta para hospedagem em VPS ou cloud, com integração WhatsApp via Evolution API, painel administrativo, controle de usuários, campanhas e relatórios.

STACK SUGERIDA:

• Node.js
• Express ou NestJS
• PostgreSQL
• Prisma ORM
• Redis para filas
• BullMQ para agendamentos
• JWT para autenticação
• Docker e Docker Compose
• Nginx para proxy reverso
• Evolution API para conexão com WhatsApp

---

1. MÓDULOS PRINCIPAIS

Criar os módulos:

• Autenticação
• Usuários
• Licenças
• Conexão WhatsApp
• Campanhas
• Disparos em grupos
• Agendamentos
• CRM de contatos
• Webhooks
• Relatórios
• Logs
• Painel ADM

---

2. AUTENTICAÇÃO

Criar sistema com:

• Login
• Cadastro
• Recuperação de senha
• JWT
• Refresh token
• Perfis de acesso:
  • ADM
  • Cliente
  • Operador

---

3. LICENÇAS

Criar sistema obrigatório de licença.

O ADM poderá:

• Gerar licença
• Ativar licença
• Bloquear licença
• Renovar licença
• Excluir licença
• Definir validade
• Definir plano

Planos:

• Básico
• Profissional
• Premium

Formato da licença:
JATOVENDAS-2026-XXXX

Licença deve controlar:

• Acesso ao sistema
• Quantidade de campanhas
• Quantidade de grupos
• Quantidade de mensagens por dia
• Data de expiração

---

4. INTEGRAÇÃO WHATSAPP

Criar integração com Evolution API.

Endpoints necessários:

• Criar instância
• Gerar QR Code
• Verificar status da conexão
• Desconectar WhatsApp
• Sincronizar contatos autorizados
• Sincronizar grupos autorizados
• Enviar mensagem de texto
• Enviar imagem
• Enviar PDF
• Enviar vídeo
• Receber mensagens via webhook

Criar botão no frontend:
“Conectar WhatsApp”

---

5. CAMPANHAS

Criar CRUD completo de campanhas:

Campos:

• Nome
• Mensagem
• Mídia opcional
• Link opcional
• Data
• Horário
• Status
• Grupos selecionados
• Criado por
• Licença vinculada

Status:

• Rascunho
• Agendada
• Enviando
• Pausada
• Finalizada
• Cancelada
• Erro

---

6. DISPAROS EM GRUPOS

Criar módulo para disparos em grupos autorizados.

Funções:

• Listar grupos
• Buscar grupos
• Selecionar manualmente
• Botão selecionar todos os grupos
• Remover seleção
• Contador de grupos selecionados
• Respeitar limite da licença

Antes de enviar, exigir confirmação:
“Confirmo que possuo autorização para enviar mensagens aos grupos selecionados e utilizarei o JatoVendas com responsabilidade.”

Sem confirmação, bloquear envio.

---

7. SEGURANÇA E USO RESPONSÁVEL

O sistema não deve incentivar spam, automação abusiva ou envio sem autorização.

Criar:

• Limite diário por licença
• Limite por hora
• Intervalo configurável entre mensagens
• Pausas automáticas
• Bloqueio em caso de erro repetido
• Logs de envio
• Auditoria por usuário
• Confirmação obrigatória de autorização
• Bloqueio automático de licença vencida

Mensagem padrão:
“Disparos em excesso podem gerar restrições no WhatsApp. Use o JatoVendas com responsabilidade.”

---

8. AGENDAMENTOS

Criar sistema de agendamento com BullMQ/Redis.

Funções:

• Agendar campanha
• Pausar campanha
• Retomar campanha
• Cancelar campanha
• Repetir campanha
• Ver fila de envios
• Ver status em tempo real

---

9. WEBHOOKS

Criar endpoints para receber eventos da Evolution API:

• Nova mensagem recebida
• Status da conexão
• Mensagem enviada
• Mensagem com erro
• QR Code atualizado
• Grupo atualizado

Salvar eventos no banco de dados.

---

10. CRM

Criar CRM simples com:

• Contatos
• Grupos
• Conversas
• Tags
• Observações
• Status do lead
• Histórico de mensagens

Status do lead:

• Novo
• Interessado
• Em atendimento
• Fechamento
• Cliente
• Perdido

---

11. RELATÓRIOS

Criar relatórios:

• Campanhas enviadas
• Total de mensagens
• Falhas
• Taxa de sucesso
• Usuários ativos
• Licenças vencidas
• Uso por cliente
• Histórico por grupo

Exportar:

• PDF
• Excel

---

12. PAINEL ADM

Criar endpoints para painel ADM:

• Ver usuários
• Ver licenças
• Gerar licença
• Bloquear usuário
• Bloquear licença
• Ver campanhas
• Ver logs
• Definir limites por plano
• Ver consumo por cliente

---

13. BANCO DE DADOS

Criar tabelas:

• users
• licenses
• plans
• whatsapp_instances
• contacts
• groups
• campaigns
• campaign_groups
• scheduled_jobs
• messages
• webhooks
• logs
• reports

---

14. DOCKER E HOSPEDAGEM

Criar:

• Dockerfile
• docker-compose.yml
• .env.example
• README.md com passo a passo de instalação
• Script de seed para criar ADM inicial
• Configuração para VPS Ubuntu
• Configuração com Nginx
• Configuração SSL com Certbot

---

15. VARIÁVEIS .ENV

Criar arquivo .env.example com:

DATABASE_URL=
REDIS_URL=
JWT_SECRET=
PORT=
EVOLUTION_API_URL=
EVOLUTION_API_KEY=
ADMIN_EMAIL=
ADMIN_PASSWORD=
APP_URL=
WEBHOOK_SECRET=

---

16. DOCUMENTAÇÃO

Criar documentação completa com:

• Como instalar
• Como configurar banco
• Como rodar Docker
• Como conectar WhatsApp
• Como criar licença
• Como criar campanha
• Como agendar disparo
• Como configurar webhook
• Como hospedar em VPS

---

OBJETIVO FINAL

Entregar uma API backend profissional chamada JatoVendas API, pronta para hospedagem, escalável, segura, com integração WhatsApp via Evolution API, controle por licença, CRM, campanhas, agendamentos, relatórios e uso responsável.