Logs de auditoria

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Conversa Labs

Última atualização em 7 de set de 2026

Visão geral

Os logs de auditoria registram as ações relevantes feitas na conta: alterações de configuração, gestão de agentes e equipes, mudanças de permissões e outras ações administrativas. Eles respondem à pergunta “quem fez o quê e quando”, fundamental para segurança, conformidade e investigação de incidentes.

A lista tem busca por pessoa, filtros por tipo de evento e por período, e ordenação. É assim que você reduz milhares de eventos ao punhado que interessa antes de investigar.

Pré-requisitos

Perfil de Administrador para acessar os logs.
Logs de auditoria é um recurso premium/opcional e pode não estar habilitado na sua conta. Se a área não aparecer, fale com o responsável pela conta ou com o suporte.

Passo a passo

Nas Configurações, abra Auditoria no menu lateral (logs de auditoria).
Visualize a lista cronológica de eventos: ator (quem), ação (o quê), alvo e data/hora.
Use os filtros disponíveis para reduzir o escopo (por período, por tipo de ação, etc.).
Use a busca no cabeçalho para encontrar as ações de uma pessoa pelo nome ou e-mail. Ela dispara a partir de 3 caracteres.
Escolha um tipo de evento na lista agrupada (Acesso, Agentes e times, Configuração, Conversas) ou mantenha Todos os eventos.
Defina o período no seletor de datas e a ordenação (mais recentes ou mais antigos primeiro).
Use Limpar filtros para voltar à lista completa.
Leia a linha do evento: ela já traz a descrição completa da ação, o horário e o endereço IP de origem. A linha é o registro inteiro — não há tela de detalhe por trás dela.
Para análises externas, consulte o mesmo histórico pela API em GET /api/v1/accounts/{account_id}/audit_logs, que aceita exatamente os filtros da tela (q, types, since, until, sort e page).

Configurações & opções

Visualização cronológica: eventos do mais recente ao mais antigo.
Filtros: ajudam a localizar uma ação específica em meio a muitos registros.
Busca por pessoa: o campo de busca procura por nome de agente ou e-mail. Ela começa a partir de 3 caracteres e espera uma pequena pausa na digitação antes de consultar, para não disparar a cada tecla.

Filtro por tipo de evento, organizado em quatro grupos:

Grupo	Tipos disponíveis
Acesso	Entrada / saída
Agentes e times	Agentes · Times · Membros do time · Colaboradores da caixa de entrada
Configuração	Configurações da conta · Caixas de entrada · Webhooks · Regras de automação · Macros
Conversas	Exclusões de conversas

Filtro por período: o seletor de datas padrão da plataforma. O intervalo escolhido é aplicado do início do primeiro dia ao fim do último.
Ordenação: Mais recentes primeiro (padrão) ou Mais antigos primeiro.
Contador: o cabeçalho mostra o total de eventos que atendem aos filtros atuais.
Limpar filtros: o botão aparece assim que houver busca, tipo de evento, período ou ordenação ativos.
Estado na URL: busca, tipo, período, ordenação e página ficam no endereço da página. Dá para recarregar, usar voltar/avançar do navegador e compartilhar o link já filtrado com outro administrador.
Paginação: 25 eventos por página.
Colunas: a atividade descrita em texto (quem fez o quê), o horário e o endereço IP de origem.
Exportação: a tela não exporta CSV. Para levar os eventos para fora, use a API citada no passo 9.
Retenção: o histórico fica disponível conforme a política do seu plano. A plataforma não expurga esses registros sozinha e a tela não tem campo de retenção — quem tem prazo configurável é a trilha nativa descrita a seguir.
Trilha nativa (Governança & LGPD): além dos logs premium, a conta pode habilitar a trilha de auditoria nativa, consultada na aba Auditoria de Configurações → Governança & LGPD — logins, mudanças de configuração, aplicação de modelos de função/roteamento, mudanças de agentes e caixas, exclusões de contatos e solicitações de titulares, com retenção configurável pelo administrador. Essa trilha tem filtros próprios (Ação, De e Até) e não oferece busca por texto.

Casos de uso

Investigar quando e por quem uma configuração foi alterada.
Confirmar mudanças de permissão de um agente após uma reclamação.
Atender a requisitos de conformidade e segurança da empresa.
Reconstituir o dia de um agente: buscar pelo e-mail dele e ordenar do mais antigo para o mais recente.
Isolar alterações de configuração em um intervalo suspeito: filtrar por Configuração e pelo período do incidente.
Verificar apagamentos: filtrar por Conversas → Exclusões de conversas.

Dicas, limites e boas práticas

Combine auditoria com papéis bem definidos: menos acesso amplo, menos surpresas no log.
Revise os logs periodicamente, não apenas após incidentes.
Os logs são somente leitura — eles registram a história e não devem ser editados.
A busca cobre quem executou a ação (nome ou e-mail), não o texto da descrição do evento. Para responder “o que mudou”, combine tipo de evento + período.
Filtre antes de compartilhar: um link já filtrado poupa a outra pessoa de repetir a investigação inteira.
Um tipo de evento ou uma ordenação desconhecidos no endereço são simplesmente ignorados, e o período só é aplicado quando início e fim estão preenchidos.

Solução de problemas

Não vejo a área de auditoria: o recurso premium não está habilitado para a conta.
Não encontro uma ação específica: ajuste os filtros (período/tipo) e confirme que a ação é do tipo registrado em auditoria.
A busca não retorna nada: ela precisa de pelo menos 3 caracteres e procura por nome ou e-mail do usuário — um trecho da descrição da ação não encontra o registro.
A lista diz “Não existem itens correspondentes a esta consulta”: há filtros ativos que não casaram com nenhum evento. Use Limpar filtros para recomeçar.
Colei um link e vieram menos filtros do que eu esperava: valores fora dos suportados são descartados na leitura do endereço.
Quero exportar para uma planilha: a tela não tem botão de exportação. Use a API do passo 9 e converta o resultado.
Preciso de mais histórico: a retenção depende do plano — fale com o responsável pela conta.