Tracking · Email API
Rastreie seus emails da API
Adicione alguns campos ao envio que você já faz. Você ganha aberturas, cliques, descadastro com um clique e todo destinatário salvo como contato — sem precisar criar nada antes.
POST mail.sendcorex.com/v3.0/send
Os campos
Todos opcionais. Adicione junto de to, from, subject e body — use só os que precisar.
trackstringO nome sob o qual esses emails são agrupados no Analytics.
- Criado no primeiro envio — 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".
"track": "Weekly Newsletter"
track_opensbooleanConta quem abriu o email.
- Adiciona um pixel invisível ao HTML.
- Aberturas automáticas (privacidade do Apple Mail, scanners de segurança) são contadas à parte — nunca inflam sua taxa de abertura.
- Sem track, a abertura ainda é salva no contato, só não fica agrupada no Analytics.
"track_opens": true
track_clicksbooleanConta 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.
"track_clicks": true
unsubscribebooleanUse 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 adiciona os headers List-Unsubscribe e one-click exigidos pelo Gmail e pelo Yahoo. Um List-Unsubscribe enviado por você é ignorado.
- Quem se descadastra para de receber emails de toda a sua conta: campanhas, API e SMTP.
- true sem o placeholder retorna MISSING_UNSUBSCRIBE_PLACEHOLDER e nada é enviado.
"unsubscribe": true
contact_liststringA 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 track, track_opens, track_clicks, unsubscribe ou contact_list. Um envio simples não salva nada.
- Quem já está nos seus contatos é atualizado, nunca duplicado.
"contact_list": "Newsletter"
Exemplo
Uma newsletter com tudo ativado.
curl -X POST https://mail.sendcorex.com/v3.0/send \
-H "Authorization: Bearer $SENDCOREX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "subscriber@example.com",
"from": "news@yourdomain.com",
"sender_name": "The Weekly",
"subject": "Issue #42",
"body": "<p>This week in tech...</p><a href=\"[unsubscribe]\">Unsubscribe</a>",
"track": "Weekly Newsletter",
"track_opens": true,
"track_clicks": true,
"unsubscribe": true,
"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 abriuResposta
A resposta normal do envio, mais o que o tracking fez.
{
"success": true,
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"recipients": 1,
"track": "Weekly Newsletter",
"track_id": "6ad757c8aaf59feb",
"contact_list": "Newsletter"
}trackO nome do track usado, sem os espaços das pontas. Ausente quando o email não tem track.
track_idID estável do track: o mesmo nome sempre gera o mesmo ID.
contact_listA lista em que os destinatários foram salvos. Ausente quando nada é salvo.
warningsO que ajustamos sem falhar o envio: [[Name]] legado encontrado, limite de tracks atingido.
| Código | HTTP | Quando |
|---|---|---|
MISSING_UNSUBSCRIBE_PLACEHOLDER | 400 | unsubscribe é true, mas o corpo não tem [unsubscribe]. Nada é enviado. |
UNSUBSCRIBE_UNAVAILABLE | 503 | O descadastro está fora do ar temporariamente. Nada é enviado — tente de novo em instantes. |
Bom saber
Qualquer grafia funciona
sender_name, senderName e SENDER-NAME são o mesmo campo: maiúsculas, _ e - não importam. Campos sim/não aceitam true, 1 ou "true".
500 tracks por conta
Passado o limite, o email ainda sai, só que sem track, e a resposta avisa em warnings.
Vários destinatários
Com até 50 endereços em to, cada um ganha o próprio tracking e o próprio link de descadastro.
Emails agendados
scheduled_at funciona com todos os campos desta página — o tracking começa quando o email sai.
Legado
A antiga tag [[Name]]
Emails que ainda usam a tag continuam funcionando. Novas integrações devem usar os campos acima.
<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 campos, 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.