Skip to main content

​
Visão Geral

A página de Configurações permite gerenciar informações pessoais, conexões WhatsApp e acessar áreas administrativas.
A página foi simplificada e focada nas funcionalidades essenciais, com acesso direto às configurações mais importantes.

​
Seções Disponíveis

A página é organizada em cards distintos:

Conexão Evolution API

Status e gerenciamento da conexão WhatsApp

Informações do Perfil

Dados da conta e alteração de senha

Bloqueio Inteligente

Gerenciamento de contatos bloqueados

Área Super Admin

Acesso às configurações avançadas

​
Conexão Evolution API

​
Card de Status

O primeiro card mostra o status atual da conexão WhatsApp:

​
Informações Exibidas

  • Instância: Nome da instância conectada
  • Status: Badge colorido indicando o estado
    • 🟢 Conectado - WhatsApp ativo e pronto
    • 🔴 Desconectado - Necessita reconexão
    • 🟡 Conectando - Em processo de conexão
  • Número: Telefone conectado (quando disponível)

​
Ações Disponíveis

  • Quando Desconectado
  • Quando Conectado
  • Gerar QR Code - Inicia processo de conexão
  • Atualizar Status - Verifica estado atual
Ao clicar em “Gerar QR Code”:
  1. Modal abre com código QR
  2. Instruções para escanear
  3. Código expira em 60 segundos
  4. Opção de gerar novo código

​
Estados de Carregamento

  • Gerando QR: Spinner com mensagem
  • Desconectando: Botão desabilitado
  • Atualizando: Ícone de refresh animado

​
Informações do Perfil

​
Dados Exibidos

  • Email: Email de login da conta
  • ID da Empresa: Identificador único
  • Descrição sobre atualização de dados

​
Alteração de Credenciais

O botão “Alterar Email ou Senha” abre um modal para atualização segura dos dados de acesso.
Permite alterar:
  • Email de Login - Com confirmação
  • Senha - Com validação de força
  • Requer senha atual para confirmar

​
Bloqueio Inteligente

​
Sobre a Funcionalidade

Sistema que filtra automaticamente contatos bloqueados de todas as campanhas.
Esta funcionalidade pode estar desabilitada para algumas empresas. Verifique com o administrador.

​
Estados do Card

  • Habilitado
  • Desabilitado
  • Descrição completa da funcionalidade
  • Botão vermelho “Gerenciar Contatos Bloqueados”
  • Nota sobre filtragem automática
Ao clicar no botão (quando habilitado):
  • Lista de contatos bloqueados
  • Opção de adicionar novos
  • Importação em massa
  • Remoção individual

​
Área Super Admin

​
Acesso Administrativo

Card especial para acessar configurações avançadas da empresa.
Redireciona para /empresa/{companyId}/super-admin com autenticação adicional.

​
Funcionalidades do Super Admin

No painel administrativo é possível:
  • Configurar bancos de dados
  • Gerenciar Evolution APIs
  • Configurar N8N
  • Administrar usuários
  • Ver logs e auditoria

​
Requisitos

  • Senha de administrador da empresa
  • Permissões especiais
  • Acesso restrito por IP (opcional)

​
Interface e Responsividade

​
Layout

  • Cards com sombra e bordas arredondadas
  • Espaçamento consistente entre seções
  • Ícones ilustrativos em cada título

​
Dark Mode

Todos os elementos se adaptam automaticamente ao tema escuro do sistema.
Adaptações incluem:
  • Fundos escuros para cards
  • Textos com contraste apropriado
  • Botões com cores ajustadas
  • Transições suaves

​
Mobile

Em dispositivos móveis:
  • Cards empilhados verticalmente
  • Botões ocupam largura total
  • Modais em tela cheia
  • Touch-friendly

​
Mensagens e Feedback

​
Toast Notifications

Ações geram notificações:
  • ✅ “QR Code gerado”
  • ✅ “Desconectado com sucesso”
  • ❌ “Erro ao gerar QR Code”
  • ❌ “Erro ao desconectar”
  • ❌ “Erro ao acessar área administrativa”

​
Estados de Loading

  • Botões mostram estado de carregamento
  • Desabilitados durante processamento
  • Spinners animados onde apropriado

​
Integração com API

​
Endpoints Utilizados

// Status da instância Evolution
GET /api/evolution/instance/status

// Gerar QR Code
GET /api/evolution/instance/qrcode

// Desconectar instância
DELETE /api/evolution/instance/logout

// Gerenciar contatos bloqueados
GET/POST/DELETE /api/companies/{companyId}/blocked-contacts

​
Fluxo de Navegação

​
Dicas de Uso

WhatsApp Estável

Mantenha o WhatsApp do celular sempre conectado à internet

Senha Forte

Use senhas complexas e únicas para maior segurança

Lista Limpa

Revise periodicamente os contatos bloqueados

Backup Regular

Use o painel admin para fazer backups dos dados

​
Solução de Problemas

​
QR Code não aparece

  1. Verifique conexão com internet
  2. Confirme que Evolution API está configurada
  3. Tente atualizar a página
  4. Contate o administrador

​
Bloqueio desabilitado

  1. Funcionalidade depende do plano
  2. Administrador pode habilitar
  3. Verifique com suporte

​
Erro ao acessar admin

  1. Confirme ID da empresa
  2. Limpe cookies e cache
  3. Tente logout e login
  4. Verifique permissões

​
Limitações

  • Apenas uma instância WhatsApp por empresa
  • Bloqueio inteligente pode estar desabilitado
  • Super Admin requer senha adicional
  • Algumas configurações só via administrador geral
⌘I