Recibir correos: Envío y confianza

Obtener seguimiento

Devuelve las aperturas y los clics de los correos enviados por este buzón. Solo lectura.

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

Solo aparecen en el resultado los mensajes enviados con seguimiento.

i

Las aperturas de bots y proxies no cuentan.

!

Las aperturas son una estimación: algunas apps de correo cargan las imágenes solas o las bloquean.

i

El estado de cada mensaje se guarda durante 180 días.

Argumentos

  • idsstring[]obligatorio

    De 1 a 200 message_uid de mensajes enviados. Vienen de Sent, de la respuesta de send_email / reply o de list_messages.

Inicio 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);

Respuesta

{
  "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 de la respuesta

  • tracking.<message_uid>

    Una entrada por mensaje enviado con seguimiento. Un mensaje enviado sin seguimiento no aparece.

  • track_opens / track_clicks

    Lo que se rastreó cuando se envió el correo.

  • opens / clicks

    Totales de todos los destinatarios.

  • first_open_at / last_open_at / last_click_at

    Primera y última actividad (UTC), o null.

  • unsubscribe / unsubscribes

    Si el correo tenía enlace de baja y cuántos destinatarios se dieron de baja con él.

  • recipients

    Por destinatario: email, opens, clicks, last_at, unsubscribed y urls (cada enlace clicado, del más reciente, con url, at del último clic y clicks; [] si la persona no hizo clic).

Seguimiento

Cómo se miden las aperturas y los clics.

Aperturas

Cada correo lleva un píxel invisible. Cuando la app del destinatario lo carga, se cuenta una apertura. Algunas apps cargan las imágenes solas o las bloquean, así que el número es una estimación.

Clics

Cada enlace pasa por una redirección que cuenta el clic y lleva al destinatario directamente a la dirección original.

Privacidad

Los destinatarios que rechazaron el seguimiento en la página de preferencias nunca se rastrean. Para desactivar el seguimiento de un correo, envía track_opens: false y track_clicks: false.

Errores

Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.

  • 401TOKEN_EXPIRED

    El access token expiró. Llama a Refresh Token y repite la solicitud.

  • 401INVALID_TOKEN

    El token está mal formado, es desconocido o fue revocado.

  • 429RATE_LIMITED

    Más de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.