## 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

1. Nas Configurações, abra **Auditoria** no menu lateral (logs de auditoria).
2. Visualize a lista cronológica de eventos: ator (quem), ação (o quê), alvo e data/hora.
3. Use os **filtros** disponíveis para reduzir o escopo (por período, por tipo de ação, etc.).
4. 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**.
5. Escolha um **tipo de evento** na lista agrupada (Acesso, Agentes e times, Configuração, Conversas)
   ou mantenha **Todos os eventos**.
6. Defina o **período** no seletor de datas e a **ordenação** (mais recentes ou mais antigos primeiro).
7. Use **Limpar filtros** para voltar à lista completa.
8. 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.
9. 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.

## Veja também

- [Governança & LGPD](/hc/ajuda/articles/administration-governanca-lgpd-pt-br)
- [Papéis personalizados e governança (RBAC)](/hc/ajuda/articles/administration-custom-roles-governanca-rbac-pt-br)
- [Conta, agentes e equipes](/hc/ajuda/articles/administration-conta-agentes-equipes-pt-br)
- [Integrações](/hc/ajuda/articles/administration-integracoes-pt-br)
- [Visão geral de Administração](/hc/ajuda/articles/administration-overview-pt-br)