Log de auditoria — quem fez o quê

O Audit Log (rota /configuracoes/auditoria) é o histórico imutável de tudo que aconteceu na sua conta Syncro: cada login, cada lead criado, cada usuário editado, cada exclusão. É a fonte de verdade pra responder perguntas como "Quem moveu esse lead pra Perdido na semana passada?" ou "Por que essa configuração mudou?".

Auditoria é fundamental pra equipes maiores (compliance, segurança, accountability) e pra recuperar dados em casos onde alguém fez algo sem querer.

Pré-requisitos

• Permissão de admin do tenant. Managers e viewers não veem o Audit Log.

• O log começa a registrar a partir do momento que a feature foi ativada — registros anteriores podem não estar disponíveis.

Acessar o log

1. Configurações → Auditoria no menu lateral.

2. Você vê o título Log de Auditoria com a descrição "Todas as ações realizadas no workspace.".

3. Tabela com registros aparece, ordenados do mais recente pro mais antigo.

O que cada linha mostra

Clicando numa linha, você vê o detalhe: dados antigos (antes da mudança) e novos (depois).

Ações registradas

Entidades rastreadas

O Audit Log monitora ações em:

• Lead — criação, edição, exclusão, mudança de etapa

• Usuário — criação, edição (incluindo papel), exclusão

• Departamento — CRUD

• Conversa — atribuição, encerramento, marcação importante

• Agente IA — configurações, ativação, desativação

• Automação — criação, edição, ativação

• Tag — gerenciamento

• Campo personalizado — criação, edição, exclusão

• Funil e Etapas — mudanças estruturais

• Integração — conectar/desconectar ( Google, Meta, QR Code)

• Configurações sensíveis — alterações em billing, planos, perfis

Filtros disponíveis

No topo da página, há filtros pra encurtar a lista:

• Usuário: dropdown com todos os usuários do tenant. Selecione pra ver só ações de um.

• Entidade: tipo de entidade (lead, usuário, departamento, etc).

• Ação: tipo de ação (criado, atualizado, excluído, login).

• Data De / Até: intervalo de tempo.

Combine os filtros pra investigações específicas:

• "O que o usuário João fez na semana passada?" → filtro: usuário=João, datas=últimos 7 dias.

• "Quem excluiu leads esse mês?" → filtro: ação=excluído, entidade=lead, datas=mês corrente.

• "Tentativas de login falhas no último dia" → filtro: ação=login_failed, datas=últimas 24h.

Detalhes de uma ação (drill-down)

Clique num registro pra abrir o detalhe. Você vê:

• Usuário que executou (nome, email, papel)

• IP de origem e user agent (browser/dispositivo)

• Entidade afetada com link pra ela (se ainda existir)

• Dados antigos (old_data) — o que era antes da mudança

• Dados novos (new_data) — o que ficou depois

Pra updates, o Syncro mostra diff dos campos alterados — só os que mudaram.

Exemplos práticos de uso

"Lead sumiu" — alguém excluiu sem querer?

1. Filtre por ação=excluído + entidade=lead.

2. Veja se há registro do lead específico.

3. Identifique quem excluiu e quando.

4. Se foi acidente, contate suporte com o ID do registro pra tentar recuperação (se backup ainda viável).

"Configuração mudou — quem mexeu?"

1. Filtre por entidade=automation (ou tag, departamento, etc).

2. Procure registros de atualizado.

3. Veja o diff pra confirmar exatamente o que mudou.

4. Identifique o usuário responsável.

"Login estranho de IP desconhecido?"

1. Filtre por ação=login + filtro de data.

2. Veja IP de origem de cada login.

3. Se aparecer IP estranho (país diferente, ISP suspeito), considere:

• Forçar redefinição de senha do usuário afetado.

• Habilitar 2FA na conta (se disponível).

• Investigar se houve vazamento de credenciais.

"Funcionário tá editando o que não devia"

1. Filtre por usuário=fulano.

2. Veja todas as ações dele.

3. Se houver edições suspeitas, contraste com as permissões do papel dele.

4. Se necessário, rebaixe o papel ou converse com o funcionário.

Auditoria é imutável

Registros do Audit Log não podem ser editados ou excluídos — nem por admins. Isso é proposital pra garantir integridade.

• Se um admin tenta apagar registro, o sistema bloqueia.

• Audit Log é append-only no banco.

• A única forma de "remover" é por exclusão definitiva da conta inteira (LGPD).

Período de retenção

Os logs ficam guardados indefinidamente enquanto a conta estiver ativa. Após cancelamento da assinatura, ficam preservados conforme política de retenção (geralmente 12+ meses).

Se você precisa de expurgação específica (motivos de privacidade), contate suporte com a justificativa.

Exportar logs pra análise externa

Hoje a UI não tem botão de exportar audit logs em CSV/Excel. Pra extrair em massa (ex: pra auditoria contábil ou compliance), contate suporte com:

• ID da conta

• Período desejado

• Filtros (se houver)

O que não está no Audit Log

Algumas coisas não são registradas (intencionalmente, pra evitar volume e ruído):

• Mensagens de chat enviadas/recebidas — ficam só na tabela de mensagens (whatsapp_messages, instagram_messages).

• Visualizações (apenas leu sem editar nada).

• Cliques em botões sem efeito persistente.

• Eventos de notificação (chegou notificação no sino).

Pra rastreamento de mensagens, use o histórico de cada conversa no chat.

Auditoria em tenants compliance-heavy

Empresas com requisitos altos de compliance (financeiro, saúde, dados sensíveis) usam o Audit Log pra:

• Auditoria interna mensal — admin revisa o log pra detectar anomalias.

• Investigação de incidentes — quando algo dá errado, audit é o ponto de partida.

• Demonstração de conformidade — provar pra órgão regulador (LGPD, ISO, SOC) que ações são rastreadas.

Limitações conhecidas

• Sem alertas automáticos — o sistema não te notifica de ações suspeitas (ex: "muitas exclusões por um usuário"). Você precisa olhar manualmente.

• Sem comparação visual avançada — diff é mostrado em formato simples (campos antigos / campos novos).

• Sem drill-down de mudança em massa — se um admin atualizou 100 leads em massa via importação, são 100 registros separados (não 1 agregado).

Próximos passos

• Pra controlar quem tem acesso a quais funções, use Gerenciar usuários.

• Pra ver histórico de mensagens (não está no audit), use o chat unificado.

Artigos relacionados

• Gerenciar usuários da equipe

• Transferir titularidade da conta

• Excluir ou desativar a conta