> ## Documentation Index > Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Logs de mensagens > Histórico de cada envio, com filtros, status, conteúdo enviado e rastreamento de abertura e clique A tela **Logs** mostra o histórico de envios da sua conta: cada envio processado gera um registro por canal, com destinatário, status, conteúdo e, quando houver, o motivo da falha. Ela fica em **Comunicações → Logs** e todos os usuários da conta têm acesso. Quando falta ao destinatário o dado que o canal exige (por exemplo, o e-mail no canal E-mail ou o telefone no WhatsApp e no SMS), aquele canal é pulado e nenhum registro é criado nos logs. Se o canal foi pedido explicitamente no campo `channels` da API, a resposta do envio informa o campo que faltou. Os mesmos dados estão disponíveis pela API em [Consultar Logs](https://docs.octasend.com.br/api-reference/consultar-logs.md). ## Abas | Aba | O que mostra | Quando aparece | | - | - | - | | **Transacional** | Todos os envios que não são de campanha: pela API, por automações e por integrações (como a [Nuvem Shop](https://docs.octasend.com.br/integracoes/nuvemshop.md)). | Sempre | | **Campanhas** | Envios de [campanhas](https://docs.octasend.com.br/plataforma/campanhas.md), um registro por destinatário. | Quando Campanhas está liberado no plano da conta | | **Automações** | Envios feitos por um passo de [automação](https://docs.octasend.com.br/plataforma/automacoes.md). | Quando o módulo de Automações está liberado | Os envios de automação aparecem nas duas abas, **Transacional** e **Automações**. Trocar de aba limpa os filtros. ## Filtros | Filtro | Como funciona | | - | - | | **Buscar por e-mail ou telefone** | Encontra registros cujo e-mail ou telefone do destinatário contém o texto digitado, sem diferenciar maiúsculas de minúsculas. | | **Status** | **Todos os status** ou um dos status da tabela abaixo, pelo nome: **Enfileirada**, **Enviando**, **Enviada**, **Entregue**, **Lida**, **Falhou** ou **Ignorada**. | | **Canal** | **Todos os canais**, Email, Push Notification (Mobile), Push Notification (Navegador), WhatsApp, Telegram, Slack, In-app (dentro da aplicação) ou SMS. | | **De** / **Até** | Data de criação do registro, em dias inteiros no fuso horário da conta (**Configurações → Geral → Fuso horário**): da meia-noite do dia **De** até o fim do dia **Até**. Sem fuso configurado, vale o horário de São Paulo. | Os filtros se combinam. Ao lado deles ficam o total de registros encontrados e, quando há algum filtro aplicado, o botão **Limpar filtros**. A lista mostra os mais recentes primeiro, 50 por página, com os botões **Anterior** e **Próxima** quando há mais de uma página. As colunas são **Destinatário** (e-mail, telefone ou token de push), **Canal**, **Idioma**, **Status** e **Criado em**. A coluna **Criado em** usa o mesmo fuso da conta dos filtros de data. > [!NOTE] > > Filtrar por comunicação ou por tag é possível pela API, com os parâmetros `communication_slug` e `tag`. Veja [Consultar Logs](https://docs.octasend.com.br/api-reference/consultar-logs.md). ## Status | Status na tela | Código | O que significa | | - | - | - | | **Enfileirada** | `queued` | O envio foi registrado e ainda não saiu. É o caso do WhatsApp pela Evolution (QR code) com a fila ativa: a mensagem fica **Enfileirada** até a fila enviá-la. | | **Enviando** | `processing` | O envio está em processamento. | | **Enviada** | `sent` | O provedor do canal aceitou a mensagem. | | **Entregue** | `delivered` | O WhatsApp confirmou a entrega no aparelho do destinatário. Só em envios de WhatsApp pela Evolution (QR code). | | **Lida** | `read` | O WhatsApp confirmou a leitura. Só em envios de WhatsApp pela Evolution (QR code). Registros antigos de envios pela Meta Cloud API também podem ter este status ou o **Entregue**. | | **Falhou** | `failed` | O envio não se completou. O motivo aparece no detalhe, por exemplo "Limite diário de mensagens atingido", quando a conta já usou o **Limite diário de mensagens** do dia (veja [Configurações](https://docs.octasend.com.br/plataforma/configuracoes.md)). | | **Ignorada** | `skipped` | Nada foi enviado por uma regra de negócio. Exemplos de motivo: "Contato descadastrado" (campanhas, automações de marketing e envios pela API com `respect_opt_out: true` não enviam para o canal de que o contato se descadastrou; veja [Contatos](https://docs.octasend.com.br/plataforma/contatos.md)); "Contato removido" (o contato foi removido enquanto a campanha enviava); a comunicação sem versão publicada em nenhum dos idiomas que o sistema tenta (o idioma do envio, o **Idioma padrão** e o **Idioma de fallback** da conta e, por último, o inglês); o número não registrado no WhatsApp; "Canal in-app desabilitado". Se a comunicação tem uma única versão publicada, ela é usada mesmo quando o idioma não bate. | **Entregue** e **Lida** contam como envio com sucesso, assim como **Enviada**, nos números do [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md). O status pode mudar depois do envio, quando o provedor informa o resultado da entrega: * **E-mail pelo SendGrid** — com o webhook de eventos configurado, uma rejeição (bounce, descarte ou adiamento) muda o envio para **Falhou**, com o motivo. Denúncia de spam, descadastro e descadastro de grupo **não** mudam o status, porque a mensagem foi entregue: eles marcam o contato como descadastrado do e-mail (veja [Contatos](https://docs.octasend.com.br/plataforma/contatos.md)). A entrega, a abertura e o clique preenchem o rastreamento. Veja [E-mail](https://docs.octasend.com.br/guias/email.md). * **WhatsApp pela Evolution (QR code)** — as confirmações do WhatsApp mudam o status do envio para **Entregue** e depois **Lida**, sem configuração extra. Com a fila ativa, o envio passa de **Enfileirada** para **Enviada** quando a fila o envia, ou para **Falhou** ou **Ignorada** quando não consegue. Mensagens enviadas antes dessa atualização continuam como **Enviada**. * **WhatsApp pela Meta Cloud API** — as confirmações de entrega e de leitura não mudam o status: o envio continua **Enviada** e a entrega e a leitura ficam registradas com a data e a hora. Essas confirmações alimentam o gráfico **Status dos envios de WhatsApp** do [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md). Uma falha informada pela Meta muda o envio para **Falhou**, com o código e a mensagem do erro. Veja [WhatsApp](https://docs.octasend.com.br/guias/whatsapp.md). * **SMS** — quando o provedor de SMS informa que a mensagem não foi entregue, o envio muda para **Falhou**. O status nunca retrocede: uma confirmação que chegue atrasada não desfaz uma leitura. **Falhou** e **Ignorada** são definitivos: uma confirmação de entrega ou abertura que chegue depois não os desfaz. ## Detalhe do envio Clique numa linha para abrir o painel lateral **Detalhe do envio**. O endereço da página passa a identificar o registro aberto, então você pode copiar o link e mandar para alguém da equipe. As datas e os horários do detalhe aparecem no fuso horário da conta, como na lista. ### Fluxo Um diagrama mostra as etapas do envio, com data e hora quando o evento já aconteceu: 1. **Requisição recebida** — nome da comunicação ou, num envio de campanha, nome da campanha. Se a comunicação foi excluída, aparece **Comunicação removida**. 2. **Roteado via** o canal — com o destinatário. 3. **Envio ao provedor** — com o status, com os mesmos nomes da tabela acima: Enfileirada, Enviando, Enviada, Entregue, Lida, Falhou ou Ignorada. 4. **Detalhes do erro** — só quando o envio falhou. 5. No e-mail, **Email entregue**, **Email aberto** e **Link clicado**; no web push, **Push recebido** e **Link clicado** — só se o envio não falhou nem foi ignorado. Cada etapa mostra **Confirmado**/**Clicado** ou **Aguardando**. ### Resumo * A comunicação (nome e identificador) e o status. Num envio de campanha, aparecem o nome da campanha e a indicação **Campanha**. * **Canal**, **Idioma**, **Data** (criação do registro) e **Enviado em**. * **Tag** — as tags informadas no envio. * **E-mail**, **Telefone** ou **Push token** do destinatário. * **ID do provedor** — o identificador da mensagem no provedor do canal, útil para investigar um envio com o próprio provedor. * **Rastreamento** — para e-mail e web push (veja abaixo). * **Erro** — a mensagem de erro, quando o envio falhou. ### Variáveis utilizadas Cada variável enviada com o seu valor, no formato `{{variavel}}` → valor. ### Conteúdo enviado * **WhatsApp** — mostra o conteúdo gravado no momento do envio, já com as variáveis preenchidas e com a variação de texto que foi usada. Numa sequência com várias mensagens, cada uma aparece separada ("Mensagem 1 de 3"), com a indicação quando ela não foi enviada, e com o tipo de conteúdo (Imagem, Vídeo, Áudio, Documento, Botões, Lista, Carrossel e outros). Em envios antigos, feitos antes desse registro existir, o texto é montado a partir do template atual e um aviso indica que pode diferir do que foi entregue. * **Demais canais** — mostra **Assunto**, **Título**, **Corpo (HTML)** (com prévia renderizada) e **Corpo (texto)** ou **Mensagem**, montados a partir do template usado no envio com as variáveis gravadas. Se o template foi editado depois do envio, a prévia mostra o conteúdo publicado atual da versão (um rascunho não aparece aqui). Se o template foi removido, aparece **Template não disponível**. O mesmo aviso aparece nos envios de campanha por e-mail, Telegram e Slack, porque a mensagem da campanha não usa template. ### Campos protegidos Se a sua conta tiver campos protegidos (configuração feita pela OctaSend), eles aparecem como **Criptografado** no resumo, nas variáveis, no conteúdo enviado e no diagrama **Fluxo** do detalhe. O destinatário protegido também aparece como **Criptografado** na lista de Logs, nos **Últimos envios** do [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md) e no **Log de Envios** das [campanhas](https://docs.octasend.com.br/plataforma/campanhas.md). Podem ser protegidos o e-mail, o telefone e o token de push do destinatário, o assunto, o título, o corpo em HTML e em texto, as variáveis, o ID do provedor e a mensagem de erro. Se a configuração de campos protegidos não carregar, essas telas não têm como saber o que está protegido: por segurança, mascaram todos os destinatários e o conteúdo das mensagens e mostram o aviso "Não foi possível confirmar quais dados estão protegidos". Recarregue a página para tentar de novo. ## Rastreamento de abertura e clique O campo **Rastreamento** do detalhe mostra os eventos de entrega, abertura e clique do e-mail e do web push. Cada um aparece com data e hora quando é registrado, ou como **aguardando** enquanto não acontece. ### E-mail | Evento | Quando é registrado | | - | - | | **Entregue** | O SendGrid confirmou a entrega, com o webhook de eventos configurado. Quando o provedor não informa a entrega (SMTP, Amazon SES, SendPulse ou SendGrid sem o webhook), é preenchido na primeira abertura ou no primeiro clique, porque quem abriu recebeu. | | **Aberto** | O destinatário abriu o e-mail e as imagens foram carregadas. Fica a data da primeira abertura: abrir de novo não muda a data. | | **Clicado** | O destinatário clicou num link do e-mail. Um clique também registra a abertura e a entrega, se ainda não tinham sido registradas. Fica a data do último clique. | O rastreamento é automático, sem configuração: em todo e-mail com corpo HTML, a OctaSend inclui uma imagem invisível de rastreamento e faz os links `http` e `https` passarem por um redirecionamento rastreado antes de chegar ao destino. Links `mailto:`, `tel:`, `sms:`, âncoras (`#`) e o link de descadastro ficam como estão e não contam clique. E-mails só com texto não têm esse rastreamento. Para não inflar os números, o sistema ignora: * acessos de scanners de segurança e robôs (como os filtros de links de e-mail corporativo); * qualquer acesso nos primeiros 15 segundos depois do envio, que é quando esses scanners costumam agir. Os servidores de imagem dos webmails (como o do Gmail) só buscam a imagem quando a pessoa abre a mensagem, por isso contam como abertura. A abertura no Outlook para Windows também conta. > [!WARNING] > > **Aberto** e **Clicado** são indicativos, não garantia. Quem abre o e-mail com as imagens bloqueadas, ou num programa de e-mail que o filtro trata como robô, não gera a abertura. Um clique registrado, porém, sempre registra a abertura junto. > [!NOTE] > > Com o SendGrid como provedor e o webhook de eventos configurado, a entrega, a abertura e o clique informados pelo SendGrid também preenchem esses campos, cada um no seu: a entrega em **Entregue**, a abertura em **Aberto** e o clique em **Clicado**. Na API de [Consultar Logs](https://docs.octasend.com.br/api-reference/consultar-logs.md), os três ficam em `delivered_at`, `read_at` e `clicked_at`. ### Web push | Evento | Quando é registrado | | - | - | | **Recebido** | O navegador do destinatário recebeu a notificação. | | **Clicado** | O destinatário clicou na notificação. Um clique também registra o recebimento. | Quem informa esses eventos é o service worker publicado no seu site. Sem ele, os campos ficam em **aguardando**. Veja o passo a passo em [Web Push](https://docs.octasend.com.br/guias/web-push.md). ## Tags A tag é um agrupamento livre que você define no momento do envio, pelo parâmetro `tag` da API. Ela aparece no detalhe do envio e serve para filtrar os logs pela API, útil para medir uma ação específica sem criar uma comunicação nova para cada uma. > [!NOTE] > > Um envio aceita várias tags (`tag: ["onboarding", "junho-2024"]`). Veja [Enviar Mensagens](https://docs.octasend.com.br/api-reference/enviar-mensagens.md). ## Veja também > [card] [Consultar Logs](https://docs.octasend.com.br/api-reference/consultar-logs.md) > > Os mesmos registros pela API, com filtro por tag e por comunicação > [card] [Dashboard](https://docs.octasend.com.br/plataforma/dashboard.md) > > Volume, status e taxa de sucesso dos envios em gráficos This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.