Receber e-mails: Envio e confiança

Obter rastreamento

Retorna as aberturas e os cliques dos e-mails enviados por esta caixa. Só leitura.

POSThttps://g.sendcorex.com/v1command: get_tracking
i

Só aparecem no resultado as mensagens enviadas com rastreamento.

i

Aberturas de bots e proxies não contam.

!

As aberturas são uma estimativa: alguns apps de e-mail carregam as imagens sozinhos ou as bloqueiam.

i

O status de cada mensagem fica guardado por 180 dias.

Argumentos

  • idsstring[]obrigatório

    1 a 200 message_uid de mensagens enviadas. Vêm do Sent, da resposta de send_email / reply ou de list_messages.

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "get_tracking",
        args: {
          ids: [
            "Vj0xQUJDMTIz",
            "Vj0xQUJDMTI0"
          ]
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Resposta

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "get_tracking",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "tracking": {
          "Vj0xQUJDMTIz": {
            "track_opens": true,
            "track_clicks": true,
            "opens": 3,
            "clicks": 1,
            "first_open_at": "2026-11-21T07:10:00Z",
            "last_open_at": "2026-11-21T09:42:00Z",
            "last_click_at": "2026-11-21T09:43:00Z",
            "unsubscribe": true,
            "unsubscribes": 0,
            "recipients": [
              {
                "email": "ana@empresa.com",
                "opens": 3,
                "clicks": 1,
                "last_at": "2026-11-21T09:43:00Z",
                "unsubscribed": false,
                "urls": [
                  {
                    "url": "https://acme.com/pricing",
                    "at": "2026-11-21T09:43:00Z",
                    "clicks": 1
                  }
                ]
              }
            ]
          }
        }
      }
    }
  ]
}

Campos da resposta

  • tracking.<message_uid>

    Uma entrada por mensagem enviada com rastreamento. Mensagem enviada sem rastreamento não aparece.

  • track_opens / track_clicks

    O que foi rastreado quando o e-mail foi enviado.

  • opens / clicks

    Totais somando todos os destinatários.

  • first_open_at / last_open_at / last_click_at

    Primeira e última atividade (UTC), ou null.

  • unsubscribe / unsubscribes

    Se o e-mail tinha link de descadastro e quantos destinatários se descadastraram por ele.

  • recipients

    Por destinatário: email, opens, clicks, last_at, unsubscribed e urls (cada link clicado, do mais recente, com url, at do último clique e clicks; [] quando a pessoa não clicou).

Rastreamento

Como as aberturas e os cliques são medidos.

Aberturas

Cada e-mail leva um pixel invisível. Quando o app do destinatário carrega esse pixel, conta uma abertura. Alguns apps carregam as imagens sozinhos ou as bloqueiam, então o número é uma estimativa.

Cliques

Cada link passa por um redirecionamento que conta o clique e leva o destinatário direto para o endereço original.

Privacidade

Destinatários que recusaram o rastreamento na página de preferências nunca são rastreados. Para desligar o rastreamento de um e-mail, envie track_opens: false e track_clicks: false.

Erros

Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.

  • 401TOKEN_EXPIRED

    O access token expirou. Chame Refresh Token e repita a requisição.

  • 401INVALID_TOKEN

    O token está malformado, é desconhecido ou foi revogado.

  • 429RATE_LIMITED

    Mais de 15 requisições/s ou 15 em andamento para o mesmo IP + caixa de correio. Espere o número de segundos indicado em Retry-After.

  • CMDINVALID_ARGS

    Um argumento obrigatório está ausente ou é inválido.

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.