Recibir correos: Envío y confianza
Obtener seguimiento
Devuelve las aperturas y los clics de los correos enviados por este buzón. Solo lectura.
https://g.sendcorex.com/v1command: get_trackingSolo aparecen en el resultado los mensajes enviados con seguimiento.
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.
El estado de cada mensaje se guarda durante 180 días.
Argumentos
idsstring[]obligatorioDe 1 a 200
message_uidde mensajes enviados. Vienen de Sent, de la respuesta desend_email/replyo delist_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_clicksLo que se rastreó cuando se envió el correo.
opens / clicksTotales de todos los destinatarios.
first_open_at / last_open_at / last_click_atPrimera y última actividad (UTC), o
null.unsubscribe / unsubscribesSi el correo tenía enlace de baja y cuántos destinatarios se dieron de baja con él.
recipientsPor destinatario:
email,opens,clicks,last_at,unsubscribedyurls(cada enlace clicado, del más reciente, conurl,atdel último clic yclicks;[]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.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.