Skip to main content
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.

​
Abas

Os envios de automação aparecem nas duas abas, Transacional e Automações. Trocar de aba limpa os filtros.

​
Filtros

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.
Filtrar por comunicação ou por tag é possível pela API, com os parâmetros communication_slug e tag. Veja Consultar Logs.

​
Status

Entregue e Lida contam como envio com sucesso, assim como Enviada, nos números do Dashboard. 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). A entrega, a abertura e o clique preenchem o rastreamento. Veja E-mail.
  • 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. Uma falha informada pela Meta muda o envio para Falhou, com o código e a mensagem do erro. Veja WhatsApp.
  • 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 e no Log de Envios das campanhas. 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

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.
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.
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, os três ficam em delivered_at, read_at e clicked_at.

​
Web push

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.

​
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.
Um envio aceita várias tags (tag: ["onboarding", "junho-2024"]). Veja Enviar Mensagens.

​
Veja também

Consultar Logs

Os mesmos registros pela API, com filtro por tag e por comunicação

Dashboard

Volume, status e taxa de sucesso dos envios em gráficos