Auditoria e eventos internos

Auditoria responde “quem alterou o quê e quando”. Eventos internos representam acontecimentos de negócio e alimentam automações. São fontes diferentes e devem ser investigadas em conjunto.

Auditoria

O sistema registra criação, alteração e exclusão dos modelos observados, com empresa, ator interno ou cliente do portal, tipo e ID do registro, valores anteriores/novos, IP, user agent e horário.

Execuções de teste de flows, seus nodes e mensagens simuladas não geram auditoria operacional. Conversas WhatsApp também registram atividades de atribuição, equipe, contexto e bloqueio.

Consultar

1. Abra Auditoria com um perfil autorizado.
2. Filtre por texto, ID, ator, IP ou período.
3. Compare valores anterior e novo.
4. Cruze horário e ID com a tela operacional, evento interno ou execução de flow.

Um ator vazio pode indicar processo assíncrono ou ação técnica, não necessariamente falha. A ausência de registro também pode significar que o modelo não é auditado ou que a retenção expirou.

Eventos internos

O listener StoreInternalEvent persiste os eventos na fila events, monta seu contexto, retoma esperas correlacionadas e inicia os triggers publicados e ativos da mesma empresa.

Catálogo atual:

• customer.created;
• project.created;
• project.recurrence_due;
• project_update.published;
• project.status_changed;
• issue.reported;
• operational_event.scheduled;
• portal.comment.created;
• whatsapp.message.received.

Consultar

1. Abra Eventos internos.
2. Filtre por nome, tipo/ID do agregado ou período.
3. Confira occurred_at e processed_at.
4. Abra o flow e procure a execução pelo evento/horário.

Evento inexistente aponta para a ação de origem ou fila events. Evento sem processamento aponta para worker/listener. Evento processado sem execução aponta para assinatura, versão, ativação, empresa ou bloqueio de conversa.

Retenção e exclusão

workflows:prune remove auditoria com mais de 15 dias e eventos transitórios processados com mais de 15 dias. project.status_changed é preservado porque compõe a timeline do projeto.

A interface permite exclusão unitária ou em lote para usuários autorizados. Trate isso como ação administrativa: exporte a evidência necessária e confirme requisitos legais antes. Excluir um evento não desfaz a ação nem a execução já criada.

Segurança

• Restrinja o acesso por perfil.
• Não copie valores sensíveis para chamados públicos.
• Use IDs e horários para correlação.
• Não edite tabelas de auditoria/eventos para “corrigir” uma automação.
• Não trate eventos internos como fila de tarefas do usuário.

Veja Automações e flows, Jobs e fila e Diagnóstico.