Tracking · SMTP

Rastreie seus emails SMTP

Adicione alguns headers aos emails que você já envia. Você ganha aberturas, cliques, descadastro com um clique e todo destinatário salvo como contato — sem precisar criar nada antes.

Mesmo servidor, mesmo login

Os headers

Todos opcionais. Adicione à mensagem como qualquer outro header — use só os que precisar.

X-Sendcorex-Trackheader

O nome sob o qual esses emails são agrupados no Analytics.

  • Criado no primeiro email — nada para configurar antes.
  • Mesmo nome, mesmo track: maiúsculas e espaços extras não importam ("Welcome Email" = "welcome email").
  • Até 100 caracteres. Use um por tipo de email, como "Welcome" ou "Invoice".
X-Sendcorex-Track: Weekly Newsletter
X-Sendcorex-Track-Opensheader · sim/não

Conta quem abriu o email.

  • Adiciona um pixel invisível à parte HTML.
  • Aberturas automáticas (privacidade do Apple Mail, scanners de segurança) são contadas à parte — nunca inflam sua taxa de abertura.
  • Sem um track, a abertura ainda é salva no contato, só não fica agrupada no Analytics.
X-Sendcorex-Track-Opens: true
X-Sendcorex-Track-Clicksheader · sim/não

Conta quem clicou em cada link.

  • Os links do corpo passam pela Sendcorex e redirecionam na hora para a sua página.
  • Você vê os links mais clicados e quais contatos clicaram neles.
X-Sendcorex-Track-Clicks: true
X-Sendcorex-Unsubscribeheader · sim/não

Use o link de descadastro da Sendcorex.

  • Coloque [unsubscribe] no corpo (ou [unsubscribe_url], [unsub_url], [opt_out_url]). Cada destinatário recebe um link pessoal.
  • Também define List-Unsubscribe e one-click para o Gmail e o Yahoo, substituindo qualquer List-Unsubscribe que você tenha definido.
  • Quem se descadastra para de receber emails de toda a sua conta: campanhas, API e SMTP.
  • true sem o placeholder é rejeitado com 554 e nada é enviado.
X-Sendcorex-Unsubscribe: true
X-Sendcorex-Contact-Listheader

A lista de contatos onde os destinatários são salvos.

  • Criada se ainda não existir. Sem ela, os destinatários vão para "API Contacts".
  • Os destinatários só são salvos quando você usa um destes headers. Um email simples não salva nada.
  • Quem já está nos seus contatos é atualizado, nunca duplicado.
X-Sendcorex-Contact-List: Newsletter

Exemplo

Uma newsletter com tudo ativado. Só a parte da mensagem muda — mantenha seu código de conexão como está.

await transporter.sendMail({
  from: '"The Weekly" <news@yourdomain.com>',
  to: 'subscriber@example.com',
  subject: 'Issue #42',
  html: '<p>This week in tech...</p><a href="[unsubscribe]">Unsubscribe</a>',
  headers: {
    'X-Sendcorex-Track': 'Weekly Newsletter',
    'X-Sendcorex-Track-Opens': 'true',
    'X-Sendcorex-Track-Clicks': 'true',
    'X-Sendcorex-Unsubscribe': 'true',
    'X-Sendcorex-Contact-List': 'Newsletter',
  },
});

Onde você vê os resultados

Nada para configurar. O primeiro email com um track já aparece no seu dashboard.

Analytics

Quantos abriram e clicaram

Cada track é uma linha na tabela Sends, ao lado das suas campanhas. Abra para ver o relatório completo: atividade por hora, melhor horário de envio, provedores, dispositivos, países e links mais clicados.

Abrir Analytics

Contatos

Todo destinatário, salvo

Os destinatários são salvos na lista de contatos que você escolher (ou "API Contacts"). Cada contato guarda seu histórico: recebeu, abriu, clicou, deu bounce, se descadastrou.

Abrir Contatos

Pessoas

Quem abriu, quem clicou

No Analytics, abra seu track e clique em "Who opened", "Who clicked" ou "Unsubscribed". Seus contatos abrem já filtrados — exporte, adicione tags ou coloque-os em uma lista.

Ver quem abriu

Respostas do servidor

O que o servidor responde depois do DATA quando o tracking está ativo.

RespostaQuando
250 OK id=…Aceito. Um ID por destinatário, separados por vírgula — os mesmos IDs que você vê nos logs e nos webhooks.
554 5.6.0X-Sendcorex-Unsubscribe é true, mas o corpo não tem [unsubscribe]. Nada é enviado — adicione e envie de novo.
451 4.3.0O descadastro está fora do ar temporariamente. É temporário: sua biblioteca SMTP tenta de novo sozinha.

Bom saber

Invisíveis para os destinatários

Todo header X-Sendcorex-* é removido antes de o email sair.

Qualquer grafia funciona

Os nomes dos headers não diferenciam maiúsculas de minúsculas. Headers sim/não aceitam true, 1, yes ou on (e false, 0, no, off).

Acentos nos nomes

Nomes de track e de lista podem vir codificados em RFC 2047 (=?UTF-8?B?…?=). A maioria das bibliotecas faz isso por você.

500 tracks por conta

Passado o limite, o email ainda sai, só que sem track.

Legado

A antiga tag [[Name]]

Não consegue adicionar headers no seu app? A tag no body ainda funciona — é a única opção que não exige mudança no código.

Em qualquer lugar do body
<p>Welcome aboard!</p>
<p>[[CRM Welcome List]]</p>

O que ela faz

A tag é removida do email. "CRM Welcome List" vira o track e a lista de contatos, com aberturas e cliques ativados e descadastro desativado.

Usando os dois

Se você também enviar os novos headers, eles prevalecem: a tag só preenche o que você deixou de fora.

Descontinuada

Contas que ainda usam a tag recebem um email, no máximo uma vez por semana, pedindo a troca. Ela continua funcionando até lá.

Códigos de referência antigos

Um código como [[7CK-JDL-Y1L]] agora é lido como um track com esse nome. Os endpoints antigos de rastreamento foram removidos — tudo fica no Analytics.