Dashboard
Visão geral do sistema de disparos
➕ Nova Campanha
📋 Campanhas Existentes
Carregando campanhas...
🤖 Dados Dinâmicos do Agente IA
⚙️ Configurações da Empresa
Gerencie configurações globais (políticas, tom de voz, informações da empresa)
📝 Sessões de Contexto
Gerencie blocos de contexto pré-definidos para o agente IA
📋 Templates de Prompt
Gerencie templates completos de prompt para campanhas
📤 Upload de Planilhas
📁 Arraste arquivos aqui ou clique para selecionar
Formatos suportados: .xls, .xlsx, .csv, .txt
Processando...
👥 Gerenciar Clientes
Verificando WhatsApp em andamento...
Preparando verificação...
Carregando clientes...
📊 Status do Sistema
Verificando conexão...
Verificando configuração...
⚙️ Gerenciar Configurações
Uazapi (WhatsApp API) - Instâncias
Carregando instâncias...
N8N Webhook
Ações
Nova Instância Uazapi
❓ Ajuda e Documentação
Visão Geral do Sistema
O Gerenciador de Campanhas é um sistema completo para gerenciar e disparar campanhas de marketing via WhatsApp para a Instacar Automóveis.
Como Funciona
- Cadastro: Crie campanhas na interface web com todas as configurações necessárias
- Processamento: O sistema N8N processa as campanhas automaticamente ou manualmente
- Envio: Mensagens são geradas por IA e enviadas via WhatsApp usando a API configurada
- Monitoramento: Acompanhe envios, erros e estatísticas em tempo real
Componentes Principais
- Interface Web: Onde você está agora - gerencia campanhas, clientes e configurações
- N8N: Motor de orquestração que processa as campanhas e envia mensagens
- Supabase: Banco de dados que armazena campanhas, clientes e histórico
- Uazapi/Z-API/Evolution: APIs de WhatsApp que fazem o envio real das mensagens
- OpenAI GPT-4: Gera mensagens personalizadas para cada cliente
Fluxo Completo
Interface Web → Salva Campanha no Supabase
↓
Disparo Manual ou Agendamento Cron
↓
N8N Workflow busca dados da campanha
↓
Processa clientes elegíveis
↓
Gera mensagem personalizada (IA)
↓
Envia via WhatsApp (Uazapi)
↓
Registra no histórico (Supabase)
Guia de Campos do Formulário
Esta seção explica cada campo do formulário de criação de campanha. Para ver ajuda específica de um campo, passe o mouse ou clique no ícone ? ao lado do label.
Campos Básicos
- Nome da Campanha: Identificador único e descritivo
- Descrição: Notas internas (não enviadas aos clientes)
- Período do Ano: Época/ocasião da campanha
- Status: Ativa, Pausada, Concluída ou Cancelada
Datas e Períodos
- Data Início/Fim: Período de execução da campanha
- Horário Início/Fim: Janela diária de processamento (padrão: 9h-18h)
Controle de Envios
- Limite de Envios/Dia: Máximo de mensagens por dia (recomendado: 50 warm-up, 200 produção)
- Intervalo Mínimo (dias): Tempo entre envios para mesmo cliente (padrão: 30 dias)
- Intervalo Entre Envios: Tempo entre cada mensagem (padrão: 130-150s aleatorizado)
- Prioridade: Ordem quando cliente é elegível para múltiplas campanhas (1-10)
Configurações de IA
-
Prompt Personalizado: Instruções para a IA
gerar mensagens. Use variáveis como
{{nome_cliente}},{{data_hoje}}, etc. - Template de Mensagem: Base opcional para as mensagens
- Usar Veículos: Incluir dados de veículos no contexto da IA
- Usar Vendedor: Incluir nome do vendedor nas mensagens
- Usar Configurações Globais: Incluir configurações da empresa (políticas, tom de voz, etc.) no contexto
Se você desmarcar todas as configurações de IA (Usar Veículos, Usar Configurações Globais, Sessões de Contexto) e preencher o Prompt Personalizado, o sistema enviará apenas o prompt com o mínimo de contexto (nome do cliente). Isso economiza tokens e dá controle total sobre o que a IA recebe.
Quando usar: Campanhas simples onde você quer controle total, sem contexto adicional da empresa ou veículos.
Processamento
- Tamanho do Lote: Clientes processados por execução (padrão: 50)
- Processar Finais de Semana: Se deve processar sábados e domingos
- Agendamento Cron: Agendamento automático (veja seção dedicada)
Agendamento Cron - Guia Completo
O agendamento cron permite executar campanhas automaticamente em horários específicos.
Formato Cron
O formato cron é: minuto hora dia mês dia-semana
| Campo | Valores | Descrição |
|---|---|---|
| Minuto | 0-59 | Minuto da hora |
| Hora | 0-23 | Hora do dia (formato 24h) |
| Dia do mês | 1-31 | Dia do mês |
| Mês | 1-12 | Mês do ano |
| Dia da semana | 0-7 | 0 e 7 = Domingo, 1 = Segunda, ..., 6 = Sábado |
Caracteres Especiais
-
*- Qualquer valor (ex:* * * * *= a cada minuto) -
,- Lista de valores (ex:1,3,5= 1, 3 ou 5) -
-- Intervalo (ex:1-5= de 1 a 5) -
/- Incremento (ex:*/2= a cada 2)
Exemplos Práticos
0 9 * * 1-5
9h da manhã, apenas dias úteis (segunda a sexta)
0 9 1 1 *
1º de janeiro às 9h
0 */2 * * *
A cada 2 horas (0h, 2h, 4h, 6h, 8h...)
30 14 * * 0
Domingos às 14:30
0 9,14 * * 1-5
9h e 14h, apenas dias úteis
0 0 1 * *
Todo dia 1 de cada mês à meia-noite
Dicas
- Deixe o campo vazio se não quiser agendamento automático (disparo apenas manual)
- Use horários comerciais (9h-18h) para evitar bloqueios
- Evite processar em finais de semana (a menos que necessário)
- Teste primeiro com uma campanha de teste antes de usar em produção
Funcionalidades Principais
Gerenciar Campanhas
- Criar Campanha: Clique em "Criar Nova Campanha" e preencha o formulário
- Editar Campanha: Clique no botão "✏️ Editar" na campanha desejada
- Disparar Manualmente: Clique em "🚀 Disparar" para executar a campanha imediatamente
- Pausar/Reativar: Altere o status da campanha para pausar ou reativar
Upload de Planilhas
- Arraste arquivos XLSX, CSV ou TXT na área de upload
- Ou cole a URL de um Google Sheets
- O sistema detecta automaticamente as colunas e normaliza telefones
- Clientes com mesmo telefone são agrupados automaticamente
Gerenciar Clientes
- Buscar: Use a barra de busca para encontrar clientes por nome ou telefone
- Filtrar: Filtre por status do WhatsApp (Válido, Inválido, Não Verificado)
- Ver Detalhes: Clique em um cliente para ver informações completas
- Editar: Clique em "✏️ Editar" no modal de detalhes
- Adicionar Veículo: Adicione veículos aos clientes no modal de detalhes
- Enviar Mensagem Individual: Use o botão "📤 Enviar" para enviar mensagem direta
Configurar Instâncias WhatsApp
- Vá em "⚙️ Gerenciar Configurações"
- Clique em "➕ Adicionar Instância"
- Preencha os dados da sua API (Uazapi, Z-API, Evolution, etc.)
- Selecione a instância ao criar/editar uma campanha
Troubleshooting
Problemas Comuns
Campanha não está enviando mensagens
- Verifique se o status está "Ativa"
- Confirme se a data de início já passou (se configurada)
- Verifique se há clientes elegíveis na base
- Confirme se a instância WhatsApp está ativa e configurada
- Verifique os logs do N8N para erros
Erro de conexão com Supabase
- Verifique se as variáveis de ambiente estão configuradas
- Confirme se está usando a Anon Key (não Service Key)
- Verifique se as políticas RLS estão configuradas corretamente
Mensagens não estão sendo geradas pela IA
- Verifique se o prompt da IA está preenchido
- Confirme se a API key do OpenAI está configurada no N8N
- Verifique os logs do N8N para erros da API OpenAI
WhatsApp bloqueando mensagens
- Reduza o limite diário (use 50 durante warm-up)
- Aumente o intervalo entre envios
- Evite enviar em finais de semana
- Respeite a janela de horário comercial (9h-18h)
- Verifique se os números de telefone são válidos
Como Verificar Status
- Status do Sistema: Veja os indicadores no rodapé da página
- Status da Campanha: Veja os badges na lista de campanhas
- Histórico de Envios: Abra os detalhes do cliente e vá na aba "Histórico"
- Logs do N8N: Acesse o N8N para ver logs detalhados de execução
Contatos de Suporte
Se o problema persistir:
-
Verifique a documentação completa em
docs/campanhas/GUIA-COMPLETO-CAMPANHAS.md - Consulte os logs do N8N para erros específicos
- Verifique o status das APIs (Supabase, Uazapi, OpenAI) nos respectivos painéis