Gerenciador de Campanhas - Instacar Automóveis

➕ Nova Campanha

📋 Campanhas Existentes

Visualização:

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

Ou cole URL do Google Sheets

👥 Gerenciar Clientes

Itens por página:

Carregando clientes...

📊 Status do Sistema

⏳ Supabase

Verificando conexão...

⏳ Uazapi (WhatsApp)

Verificando configuraçã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

💡 Modo "Apenas Prompt Personalizado":

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

Carregando dados do cliente...

Data/Hora	Status	Tipo	Campanha	Mensagem
Carregando histórico...

Nome da Campanha (obrigatório)

Descrição Campo opcional para notas internas

Período do Ano (obrigatório)

Status (obrigatório)

Data Início

Data Fim

Limite de Envios/Dia

Intervalo Mínimo (dias)

Atraso Inteligente Entre Mensagens

Selecionar intervalo pré-definido:

Muito curto: 1-5s Curto: 5-20s Médio: 20-50s Longo: 50-120s Muito longo: 120-300s Padrão (recomendado): 130-150s aleatorizado Personalizado: Digite valor abaixo

Valor personalizado (segundos):

Valor base com variação aleatória de ±10s por disparo (para não parecer automação). Selecione uma opção acima ou digite um valor personalizado. Valor padrão (130) usa aleatorização 130-150s.

Prioridade (1-10) Maior prioridade processada primeiro quando cliente elegível para múltiplas campanhas

Instância API WhatsApp (obrigatório) Selecione qual instância de API WhatsApp usar para esta campanha. Configure instâncias em "⚙️ Gerenciar Configurações".

📊 Estimativas de Tempo

Configure o limite diário e intervalo para ver estimativas

Prompt Personalizado para IA * Obrigatório apenas se nenhum template de prompt for selecionado.

Template de Mensagem (opcional)

🤖 Configurações do Agente IA

Incluir informações de veículos no contexto da IA Se marcado, a IA terá acesso aos dados de veículos do cliente. Desmarque para campanhas genéricas (Natal, Ano Novo).

Incluir nome do vendedor no contexto da IA Se marcado, a IA poderá mencionar o vendedor do veículo mais recente. Útil para campanhas de relacionamento.

Usar configurações globais da empresa Se marcado, usa configurações globais como base. Pode ser sobrescrito abaixo.

Template de Prompt (opcional) Selecione um template para usar como base do prompt. O prompt personalizado será ignorado se um template for selecionado.

Sessões de Contexto Habilitadas

Carregando sessões...

Selecione quais sessões de contexto incluir no prompt do agente IA.

Sobrescrever Configurações Globais (opcional)

Carregando configurações...

Deixe vazio para usar a configuração global. Preencha para sobrescrever.

⚙️ Processamento em Lotes e Horário

Tamanho do Lote Número de clientes processados por execução (padrão: 50, mínimo: 10, máximo: 500)

Processar Finais de Semana Processar também sábados e domingos Se desmarcado, processa apenas dias úteis (segunda a sexta)

🧪 Modo Teste e Debug

Modo Teste (substituir telefones dos clientes) Quando ativado, processa clientes normalmente mas envia mensagens para os telefones de teste.

Telefones de Teste (deixe vazio para usar configuração global) Digite um telefone por linha no formato 55XXXXXXXXXXX (código país + DDD + número).

Modo Debug (logs detalhados) Ativa logs detalhados no N8N para debug do fluxo de processamento.

🔔 Notificações Admin

Telefones Admin (deixe vazio para usar configuração global)

Telefones que receberão notificações sobre a campanha (um por linha).

Notificar ao iniciar campanha

Notificar erros críticos

Notificar ao concluir campanha

Notificar ao atingir limite diário

Instância WhatsApp para Notificações (deixe vazio para usar a mesma da campanha)

Escolha uma instância diferente para evitar sobrecarga na instância principal da campanha. Recomendado: usar instância dedicada para notificações admin.

📅 Configuração por Dia da Semana

Usar configuração padrão (horário início/fim e processar finais de semana) Configurar cada dia individualmente

Horário Início ? Horário de início para processamento automático (formato HH:MM). Define quando a campanha começa a executar automaticamente.

Horário Fim ? Horário de fim para processamento (formato HH:MM, opcional). Se definido, limita o processamento e calcula lotes automaticamente para caber no horário disponível.

🍽️ Intervalo de Almoço

Pausar durante horário de almoço Quando marcado, o sistema pausa automaticamente durante o intervalo de almoço e separa os lotes antes e depois do almoço.

📋 Lista de Clientes (Opcional)

Usar Lista Global 💡 Como usar:
• Selecione uma lista global previamente criada para usar apenas os clientes dessa lista no disparo.
• Deixe vazio para usar todos os clientes elegíveis (padrão).
• Quando uma lista é selecionada, a seleção manual de clientes abaixo é automaticamente desabilitada.
• Para criar uma nova lista, acesse "📋 Listas de Clientes" no menu lateral.

👥 Selecionar Clientes para Campanha

Por padrão, a campanha enviará para todos os clientes elegíveis. Selecione clientes específicos abaixo para limitar o envio apenas a eles.

📋 Mostrar apenas clientes que ainda não receberam mensagens nesta campanha Clientes que já receberam mensagens serão marcados automaticamente com um indicador visual (badge "📨 Já enviado" e fundo azul). O sistema sempre valida no backend antes de enviar, então mesmo que você selecione manualmente um cliente já enviado, ele será pulado automaticamente durante a execução.

0 clientes selecionados

Carregando clientes...

Apenas clientes com WhatsApp validado são exibidos (ativo, não bloqueado, status_whatsapp = 'valid'). Para verificar o WhatsApp de um cliente, use o botão "✅ Verificar WhatsApp" na lista de clientes. Se nenhum cliente for selecionado, a campanha enviará para todos os elegíveis.

📊 Quantidade de Clientes (Opcional)

Quantidade Fixa de Clientes Se preenchido, será usado para cálculos de estimativas. Se vazio, usa quantidade de clientes selecionados ou todos elegíveis do banco.

Estimativa: Configure o tamanho do lote e limite diário para ver estimativa

Dashboard

➕ Nova Campanha

📋 Campanhas Existentes

🤖 Dados Dinâmicos do Agente IA

⚙️ Configurações da Empresa

📝 Sessões de Contexto

📋 Templates de Prompt

📤 Upload de Planilhas

👥 Gerenciar Clientes

Verificando WhatsApp em andamento...

📊 Status do Sistema

➕ Nova Campanha

📋 Campanhas Existentes

🤖 Dados Dinâmicos do Agente IA

⚙️ Configurações da Empresa

📝 Sessões de Contexto

📋 Templates de Prompt

📤 Upload de Planilhas

👥 Gerenciar Clientes

Verificando WhatsApp em andamento...

📊 Status do Sistema

❓ Ajuda e Documentação

Visão Geral do Sistema

Como Funciona

Componentes Principais

Fluxo Completo

Guia de Campos do Formulário

Campos Básicos

Datas e Períodos

Controle de Envios

Configurações de IA

Processamento

Agendamento Cron - Guia Completo

Formato Cron

Caracteres Especiais

Exemplos Práticos

Dicas

Funcionalidades Principais

Gerenciar Campanhas

Upload de Planilhas

Gerenciar Clientes

Configurar Instâncias WhatsApp

Troubleshooting

Problemas Comuns

Campanha não está enviando mensagens

Erro de conexão com Supabase

Mensagens não estão sendo geradas pela IA

WhatsApp bloqueando mensagens

Como Verificar Status

Contatos de Suporte

Detalhes do Cliente

Estatísticas de Envios

Observações Registradas

Estatísticas do Histórico

Filtros

⚙️ Gerenciar Configurações da Empresa

Nova Configuração

📝 Gerenciar Sessões de Contexto

Nova Sessão

📋 Gerenciar Templates de Prompt

Novo Template

📤 Enviar Mensagem Individual

Informações do Cliente

Configuração do Envio

Nova Campanha

📊 Estimativas de Tempo

🤖 Configurações do Agente IA

⚙️ Processamento em Lotes e Horário

🧪 Modo Teste e Debug

🔔 Notificações Admin

📅 Configuração por Dia da Semana

🍽️ Intervalo de Almoço

📊 Estimativas da Campanha

📋 Lista de Clientes (Opcional)

👥 Selecionar Clientes para Campanha

📊 Quantidade de Clientes (Opcional)

Nova Lista de Clientes

Filtros Dinâmicos

Seleção de Clientes

⚠️ Instância Desconectada

⚠️ Instância Desconectada

⚙️ Gerenciar Configurações

Uazapi (WhatsApp API) - Instâncias

N8N Webhook

Ações

Nova Instância Uazapi