Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Logs e exportações

Encontre qualquer e-mail ou requisição à API, veja o que aconteceu com ele e baixe seus dados em CSV.

Três ferramentas ajudam a responder “o que aconteceu com isto?”: a lista de e-mails, o log de requisições da API e a exportação em CSV.

E-mails

No painel, E-mails lista todo e-mail que a sua equipe enviou. Busque por destinatário, assunto ou ID do e-mail, e filtre por status, chave de API, marca (domínio de envio), origem (transacional ou transmissão) e período.

Abra um e-mail para ver:

  • os eventos dele em ordem: enviado, entregue, atrasado, bounce, aberto, clicado e assim por diante, com o motivo de um atraso ou de um bounce,
  • o conteúdo como foi enviado (prévia, HTML ou texto simples) e os cabeçalhos,
  • no caso de um e-mail que ainda não saiu, por que ele espera (limite do plano, aquecimento, uma verificação de segurança e assim por diante),
  • a nota do Deliverability Insights.

Pela API, GET /emails lista os e-mails (do mais novo ao mais antigo, com paginação por cursor) e GET /emails/{id} devolve um e-mail com o último evento. Os dois exigem uma chave de API de acesso total. Para receber os eventos na hora em que acontecem, use webhooks.

Os corpos e o histórico dos e-mails ficam guardados por 30 dias em todos os planos, e depois são removidos.

Log de requisições da API

Logs, no painel, lista toda requisição feita com as suas chaves de API ou pelo MCP, dos últimos 30 dias. Cada linha mostra o status, o método, o caminho, a chave ou o aplicativo conectado que a fez e a hora.

  • Busque por caminho, chave ou ID da requisição. Filtre por origem (chave de API ou MCP), por chave de API, por classe de status (2xx, 4xx, 5xx) e por período.
  • Abra uma linha para ver os corpos da requisição e da resposta. Eles ajudam a descobrir por que uma chamada retornou 422 ou 403.
  • Os corpos só são guardados quando são JSON e têm menos de 64 KB. O conteúdo do e-mail (html, text) é trocado pelo tamanho, segredos como tokens e senhas aparecem como [redacted], e os cabeçalhos nunca são guardados.
  • Só proprietários, administradores e desenvolvedores veem os corpos.

Exportar para CSV

As páginas que listam os seus dados têm um botão Exportar CSV. O arquivo leva os filtros que você aplicou, então corresponde ao que está na tela. Uma exportação tem no máximo 50.000 linhas, das mais novas para as mais antigas. Ela usa o seu login no painel, então não existe endpoint de API para isso.

O que você pode exportar depende da sua função na equipe:

Exportação Onde Funções
Contatos, descadastros, destinatários de transmissões Páginas de Contatos e a página de uma transmissão Proprietário, administrador, marketing
Domínios, chaves de API, log de requisições da API As próprias páginas Proprietário, administrador, desenvolvedor
E-mails, lista de supressão, registro de auditoria E-mails, Contatos → Supressões, Configurações Proprietário, administrador

A exportação do log de requisições tem as colunas request_id, created_at, method, path, status, duration_ms e caller. A exportação de contatos inclui uma coluna unsubscribed e uma coluna unsubscribed_domains (* significa a equipe inteira).

Apagar os dados de uma pessoa

Para remover um destinatário do seu histórico, exclua o contato com erase: true, como descrito em Contatos. Isso também remove o endereço do histórico de e-mails, dos payloads de eventos e dos logs de requisições da API.

Esta página foi útil?