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-TrackheaderO 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ãoConta 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ãoConta 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ãoUse 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-ListheaderA 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 AnalyticsContatos
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 ContatosPessoas
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 abriuRespostas do servidor
O que o servidor responde depois do DATA quando o tracking está ativo.
| Resposta | Quando |
|---|---|
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.0 | X-Sendcorex-Unsubscribe é true, mas o corpo não tem [unsubscribe]. Nada é enviado — adicione e envie de novo. |
451 4.3.0 | O 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.
<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.