> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs

> Logs em tempo real para acompanhar a entrega de emails e depurar problemas com o provedor de email: eventos das mensagens, dados dos webhooks e a trilha de auditoria do workspace, com filtros.

## Visão geral

Os logs mostram a atividade de email e os eventos de webhook em tempo real, para ajudar você a depurar problemas de entrega e acompanhar o desempenho das campanhas. A seção também reúne as entregas dos seus próprios webhooks e a **trilha de auditoria** do workspace (quem fez o quê, e de onde), cada uma na sua aba: **Mensagens**, **Webhooks de entrada**, **Webhooks de saída** e **Log de auditoria**.

## Tipos de log

### Aba Mensagens

Todos os emails que o workspace enviou, dos mais recentes para os mais antigos, nas **últimas 24 horas** por padrão. Escolha outro período (última hora, 7 dias, 30 dias ou todo o período) no filtro **Período**.

- **Contagens por status**: Todos, Entregue, Aberto, Clicado, Retornado, Falhou e Reclamações. Clique em uma delas para listar só essas mensagens. As contagens aparecem em períodos de até 7 dias. Para 30 dias ou todo o período, adicione um filtro por endereço de email, ID de mensagem, newsletter, automação, notificação transacional ou template. Um workspace que envia só por SMTP não mostra a contagem Entregue, porque o SMTP não informa entrega.
- **Buscar**: por endereço de email, ID de mensagem ou ID externo, com correspondência exata. Digitar um "@" muda a busca para o endereço de email, a menos que você mesmo tenha escolhido o campo. Um endereço de email só é buscado quando está completo.
- **Origem**: o que enviou a mensagem. As verificações seguem esta ordem e a primeira que se aplica vale; o dashboard usa as mesmas origens.
  - **Newsletters**: a mensagem pertence a um broadcast, incluindo os envios de teste dele.
  - **Automacoes**: ela foi enviada por uma automação. Um email de automação que também indica uma notificação transacional (alguns antigos indicam, depois da atualização para a 28.0) conta como da automação.
  - **Transacional**: ela foi enviada por uma notificação transacional.
  - **Outro**: nenhuma das três, como um teste de template ou um email de confirmação dupla.
- **Percurso**: cada linha mostra até onde a mensagem chegou: enviada, entregue, aberta, clicada.
- **Erro**: quando um envio foi recusado, a resposta do próprio provedor: o código SMTP e o texto dele, como `452: 4.3.1 Daily sending quota exceeded`. Passe o mouse por cima para ler a resposta inteira.
- **Colunas**: mostre ou esconda o ID da mensagem, o ID externo, os metadados, o template, a lista e a data de criação no seletor de colunas.

![Aba Mensagens da página Logs](https://www.notifuse.com/docs/assets/screenshots/logs_messages.png)

![As contagens por status acima das mensagens e os ícones de percurso de cada linha](https://www.notifuse.com/docs/assets/screenshots/logs_status_journey.png)

Clique em uma mensagem para abri-la em um painel lateral. Vá para a mensagem anterior ou para a seguinte com **K** e **J**.

- **Eventos**: quando ela foi enviada, entregue, aberta, clicada, quando retornou ou foi marcada como spam.
- **Mensagem**: os IDs, o template e a versão, o remetente, o assunto, o idioma, o rastreamento, a lista, os anexos, e a newsletter, a automação ou a notificação transacional que a enviou.
- **Conteúdo enviado**: o email renderizado de novo a partir do template e dos dados da mensagem, no idioma do contato, em HTML, texto ou MJML. O Notifuse não guarda o HTML enviado. Ele renderiza o template na versão que a mensagem usou, então as edições feitas depois no template não aparecem.
- **Dados**: os dados do template e os metadados com que a mensagem foi enviada.
- **Abrir contato** abre o perfil do contato.

Quando um contato é apagado, as mensagens dele continuam no log como **Contato apagado**, sem os dados dele.

![Uma mensagem aberta em um painel lateral da página Logs, com os eventos e os detalhes dela](https://www.notifuse.com/docs/assets/screenshots/logs_message_detail.png)

### Aba Webhooks de entrada

Os eventos que o Notifuse guardou dos seus provedores de email e do Supabase, dos mais recentes para os mais antigos, nas últimas 24 horas por padrão.

- **Filtros**: busque por email do destinatário ou ID de mensagem; filtre por período, por **Origem** (Amazon SES, Postmark, Mailgun, SparkPost, Mailjet, SendGrid, SMTP, Supabase) e por **Tipo** (entrega, retorno, reclamação, cancelamento de inscrição, resposta, resposta automática, email de autenticação, usuário criado). Os filtros ficam guardados no link da página.
- **Mensagem vinculada**: um evento de entrega, retorno, reclamação ou cancelamento de inscrição leva à mensagem a que se refere. Uma resposta traz o ID de mensagem da própria resposta, então não leva a lugar nenhum.
- **Payloads brutos**: clique em um evento para ver os detalhes do retorno ou da reclamação e os dados exatamente como o provedor os enviou. Quando um provedor agrupa os eventos em lotes (SendGrid, SparkPost, Mailjet), cada evento do lote ganha uma entrada própria.
- **Emails enviados pelo Notifuse**: um evento de entrega, retorno, reclamação ou cancelamento de inscrição só é listado e tratado quando diz respeito a um email que o Notifuse enviou, para o endereço a que ele foi enviado. Uma resposta, só quando responde a um email que o Notifuse enviou. Os eventos sobre outros emails, como os de outro aplicativo na mesma conta do provedor ou o email de teste de uma integração, são ignorados.

![Aba Webhooks de entrada da página Logs, com eventos de entrega do Amazon SES](https://www.notifuse.com/docs/assets/screenshots/logs_webhooks.png)

### Aba Webhooks de saída

Todas as entregas das suas [assinaturas de webhook](https://www.notifuse.com/pt/docs/features/webhooks.md), das mais recentes para as mais antigas:

- **Filtros**: por assinatura e por status (Pendente, Entregando, Entregue, Falhou), guardados no link da página
- **Tentando novamente**: uma entrega que falhou e ainda tem tentativas mostra **Tentando novamente**, e o painel lateral dela informa o horário da próxima tentativa. O filtro **Falhou** também lista essas entregas
- **Detalhe da entrega**: clique em uma entrega para ver o código e o corpo da resposta do seu endpoint, e o payload que o Notifuse enviou. **Abrir assinatura** leva a essa assinatura em Configurações → Webhooks

### Aba Log de auditoria

Cada registro se lê como uma frase, como "Convidou **[ann@example.com](mailto:ann@example.com)**", e pode ser filtrado por período, autor, recurso, ação ou resultado, com os filtros guardados no link da página.

- **Quem fez o quê**: toda ação de controle (um membro convidado, uma permissão alterada, uma chave API criada, uma integração editada, um template salvo, um broadcast agendado), com o autor, o endereço IP, o resultado e um antes e depois do que mudou
- **Somente acréscimo**: um gatilho do banco de dados recusa qualquer reescrita; a limpeza da retenção é a única exclusão
- **Exportável**: baixe o filtro atual em CSV ou NDJSON, ou puxe os dados pela API para um SIEM

O registro é um recurso da [chave de licença](https://www.notifuse.com/pt/docs/self-hosting/licence.md) Enterprise; a aba, a exportação e a configuração de retenção funcionam em qualquer estado da licença. Veja [Logs de auditoria](https://www.notifuse.com/pt/docs/features/audit-logs.md) para a referência completa.

## Atualização dos eventos

Os eventos de email são atualizados em tempo real conforme os webhooks dos provedores chegam:

- **Entregue**: o email foi entregue ao destinatário
- **Aberto**: o destinatário abriu o email
- **Clicado**: o destinatário clicou em um link do email
- **Retornado**: a entrega do email falhou
- **Reclamado**: o destinatário marcou o email como spam

## Opções de filtro

Além da busca, do período, da origem e das contagens, **+ Filtro** na aba Mensagens acrescenta:

- **Status**: entregue, aberto, clicado, retornado, falhou, reclamado ou inscrição cancelada, ou o oposto (não entregue, não aberto…)
- **Canal**: o canal pelo qual a mensagem passou
- **Lista**, **Newsletter** e **Automacao**: escolhidas pelo nome
- **Template** e **Notificação transacional**: pelo ID. A tela de detalhe de uma notificação abre o log com esse filtro (`transactional_notification_id` em `messages.list`)
- **Link clicado**: dentro de uma newsletter, mostra só as mensagens em que esse link exato foi clicado. As estatísticas por link de um broadcast abrem o log com esse filtro (**Ver quem clicou**). Pela API, passe `clicked_url` com `broadcast_id` para `messages.list`

Todos os filtros ficam guardados no link da página, então você pode compartilhar ou salvar nos favoritos uma visão filtrada. Pela API, `messages.list` filtra pela origem com `origin` (`broadcast`, `automation`, `transactional` ou `other`), e `messages.count` retorna as mesmas contagens para os filtros de `messages.list`.

Essa chamada exige `created_after` ou um filtro por ID de mensagem, endereço de email, newsletter, automação, notificação transacional ou template. A dimensão `origin` do schema de análise `message_history` traz os mesmos quatro valores.

## Permissões

A página mostra só as abas que você pode ler, e a entrada Logs do menu aparece quando você pode ler pelo menos uma delas. Cada aba exige a sua própria permissão de leitura:

- **Mensagens** exige a leitura de **Histórico de Mensagens**. As estatísticas de entrega dos broadcasts (contagens de entregas, aberturas, cliques, retornos e cliques por link) também ficam aqui, então um membro que pode criar e enviar um broadcast não consegue ver o desempenho dele sem esta permissão. O log traz os endereços dos destinatários e os dados com que cada mensagem foi renderizada, então trate-o como dado de contato.
- **Webhooks de entrada** exige a leitura de **Eventos de Webhook**. São os próprios payloads dos provedores, incluindo os endereços dos destinatários e os diagnósticos do provedor.
- **Webhooks de saída** exige a leitura de **Assinaturas de Webhook**.
- **Log de auditoria** exige a leitura de **Logs de auditoria**, que um proprietário concede de forma deliberada. Ela nunca faz parte do acesso total, porque o acesso total não deve incluir ler o endereço de email, o endereço IP e as ações recusadas de cada colega. Os proprietários sempre veem a aba, e um usuário root pode estendê-la à instalação inteira.

O verbo de escrita de Histórico de Mensagens, Eventos de Webhook e Logs de auditoria não controla nada hoje: quem grava essas linhas é o pipeline de envio, as rotas de callback dos provedores e o registro de auditoria da própria plataforma, e nada que você possa chamar faz isso.

Já a escrita de Assinaturas de Webhook controla algo: ela permite que um membro ou uma chave API crie, edite, ative ou desative, exclua e teste as assinaturas (Configurações → Webhooks no console). Veja [Admins e chaves API](https://www.notifuse.com/pt/docs/features/admins-api-keys.md).

## Depurar problemas de email

Use os logs para investigar problemas com o provedor de email:

- **Falhas de entrega**: identifique os emails retornados e os motivos, e leia na coluna Erro por que um envio foi recusado
- **Problemas do provedor**: encontre padrões nas falhas de webhook
- **Acompanhamento de desempenho**: acompanhe as taxas de abertura e de clique
- **Depuração em tempo real**: veja os problemas de envio no momento em que acontecem
