Automações

​

Visão Geral

​

Interface Principal

​

Cards de Automação

​

Automações Disponíveis

​

E-mails (Campanhas de E-mail)

​

Como criar uma campanha de e-mail

1. Acesse a página Automações
2. Clique no card E-Mails
3. Preencha os dados:
   • Nome da campanha
   • Configuração de e-mail (SMTP/RESEND ativos)
   • Assunto e Corpo (suporte a texto e HTML)
   • Anexos (upload ou galeria)
4. Defina os destinatários:
   • Manual (lista de e-mails, um por linha)
   • Banco de dados (selecionar base com template de e-mail e aplicar filtros)
5. Opcional: Agendar (data e hora; mínimo 5 minutos de antecedência)
6. Clique em Iniciar Campanha (ou Agendar Campanha)

​

Regras e validações

• Nome, configuração, assunto e corpo são obrigatórios
• Em origem “Banco de dados”: é necessário selecionar uma base ativa e, se houver prévia, selecionar contatos
• Agendamento exige data e hora válidas, com antecedência mínima de 5 minutos
• Anexos por upload limitados a 25MB cada

​

Enviar e-mail de teste

• Use o botão “Enviar Teste” no passo de conteúdo (requer configuração selecionada)

​

N8N (Workflows)

​

Sobre o N8N

​

Requisitos

1. Configuração pelo Administrador - O admin deve configurar a URL e credenciais do N8N
2. Workflows Criados - Os workflows devem ser criados no N8N
3. Webhooks Configurados - Cada workflow deve ter os webhooks apropriados

​

Modal de Workflows

​

Estados Possíveis

​

Lista de Workflows

​

Informações

• Nome - Título do workflow
• ID - Identificador único
• Status - Ativo ou inativo

​

Visual

• Ícone - Raio colorido baseado no status
• Cores:
  • Verde quando ativo
  • Cinza quando inativo
• Toggle - Botão deslizante para ativar/desativar

​

Ações

• Ativar/Desativar - Toggle switch animado
• Atualizar - Botão de refresh no cabeçalho do modal

​

Comportamento

​

Carregamento

1. Verifica se N8N está configurado
2. Busca lista de workflows da empresa
3. Para cada workflow, busca status atualizado
4. Exibe com indicadores visuais apropriados
5. Mostra cron em linguagem natural quando disponível

​

Ativação/Desativação

• Click no Toggle - Alterna estado do workflow
• Feedback Visual - Toggle animado e mudança de cores
• Atualização - Lista recarrega automaticamente
• Desabilitado - Durante processamento da requisição

​

Acionar Workflow (Webhook)

• Disponível quando o workflow tem webhook e está ativo
• Dispara a execução pelo botão “Acionar”
• Exibe confirmação com aviso de processamento em segundo plano

​

Automações por Segmentação

​

Tipos de Agendamento

• Diário: horário fixo
• Semanal: um ou mais dias da semana + horário
• Mensal: dia do mês + horário
• CRON: expressão personalizada (minuto hora dia mês diaSemana)

​

Intervalo de Envio

• Intervalo aleatório entre os valores mínimo e máximo definidos
• Configurável no formulário da automação (campos “Intervalo mínimo (s)” e “Intervalo máximo (s)”)
• Padrão inicial: 6–12 segundos

​

Outras Configurações

• Deduplicação: Nunca, Apenas uma vez, Esperar X dias
• Limite por execução: máximo de envios por rodada
• Prévia de contatos baseada em filtros ou query SQL

​

Estados e Feedback

​

Carregando

• Spinner animado centralizado
• Aparece ao buscar dados do servidor

​

Erro de Configuração

• Mensagem clara sobre necessidade de configuração
• Orientação para contatar administrador
• Visual destacado em amarelo

​

Vazio

• Ilustração e mensagem amigável
• Instruções sobre próximos passos
• Link implícito para documentação

​

Responsividade

​

Dark Mode

• Cards com fundos adaptados
• Textos com contraste apropriado
• Borders e shadows ajustados
• Transições suaves entre temas

​

Integração com API

​

Endpoints Utilizados

// Verificar configuração N8N
GET /api/admin/n8n-config

// Listar workflows da empresa
GET /api/admin/n8n-workflows/{companyId}

// Status de um workflow
GET /api/n8n/workflows/{workflowId}

// Ativar workflow
POST /api/n8n/workflows/{workflowId}/activate

// Desativar workflow  
POST /api/n8n/workflows/{workflowId}/deactivate

​

Futuras Integrações

​

IA - Assistente Virtual

​

E-Mails

​

Conexão WhatsApp (Evolution API)

• Acesse Configurações > seção “Conexões Evolution API”
• Em cada cartão de instância você pode:
  • “Gerar QR Code” para conectar
  • Ver o status: Conectado, Desconectado ou Conectando
  • “Desconectar” quando necessário
  • Atualizar o status com o botão de refresh

​

Dicas de Uso

​

Solução de Problemas

​

N8N não aparece configurado

1. Verifique com o administrador se foi configurado
2. Confirme se sua empresa tem permissão
3. Teste a conexão nas configurações admin

​

Workflows não aparecem

1. Verifique se foram criados no N8N
2. Confirme se estão associados à sua empresa
3. Use o botão refresh para atualizar

​

Toggle não funciona

1. Verifique conexão com internet
2. Confirme permissões no N8N
3. Tente atualizar a página

​

Limitações Conhecidas