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.

trackstring

O 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_opensboolean

Conta 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_clicksboolean

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.
"track_clicks": true
unsubscribeboolean

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 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_liststring

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 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 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

Resposta

A resposta normal do envio, mais o que o tracking fez.

200 OK
{
  "success": true,
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "recipients": 1,
  "track": "Weekly Newsletter",
  "track_id": "6ad757c8aaf59feb",
  "contact_list": "Newsletter"
}
track

O nome do track usado, sem os espaços das pontas. Ausente quando o email não tem track.

track_id

ID estável do track: o mesmo nome sempre gera o mesmo ID.

contact_list

A lista em que os destinatários foram salvos. Ausente quando nada é salvo.

warnings

O que ajustamos sem falhar o envio: [[Name]] legado encontrado, limite de tracks atingido.

CódigoHTTPQuando
MISSING_UNSUBSCRIBE_PLACEHOLDER400unsubscribe é true, mas o corpo não tem [unsubscribe]. Nada é enviado.
UNSUBSCRIBE_UNAVAILABLE503O 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.

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 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.