Recevoir des e-mails : Envoi et confiance

Obtenir le suivi

Renvoie les ouvertures et les clics des e-mails envoyés par cette boîte. Lecture seule.

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

Seuls les messages envoyés avec suivi apparaissent dans le résultat.

i

Les ouvertures des bots et des proxys ne sont pas comptées.

!

Les ouvertures sont une estimation : certaines applications chargent les images automatiquement ou les bloquent.

i

Le statut de chaque message est conservé pendant 180 jours.

Arguments

  • idsstring[]obligatoire

    1 à 200 message_uid de messages envoyés. Ils viennent de Sent, de la réponse de send_email / reply ou de list_messages.

Démarrage rapide

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

Réponse

{
  "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
                  }
                ]
              }
            ]
          }
        }
      }
    }
  ]
}

Champs de la réponse

  • tracking.<message_uid>

    Une entrée par message envoyé avec suivi. Un message envoyé sans suivi n’apparaît pas.

  • track_opens / track_clicks

    Ce qui était suivi au moment de l’envoi de l’e-mail.

  • opens / clicks

    Totaux pour l’ensemble des destinataires.

  • first_open_at / last_open_at / last_click_at

    Première et dernière activité (UTC), ou null.

  • unsubscribe / unsubscribes

    Si l’e-mail avait un lien de désinscription, et combien de destinataires se sont désinscrits par ce lien.

  • recipients

    Par destinataire : email, opens, clicks, last_at, unsubscribed et urls (chaque lien cliqué, du plus récent, avec url, at du dernier clic et clicks ; [] si la personne n’a pas cliqué).

Suivi

Comment les ouvertures et les clics sont mesurés.

Ouvertures

Chaque e-mail contient un pixel invisible. Quand l’application du destinataire le charge, une ouverture est comptée. Certaines applications chargent les images d’elles-mêmes ou les bloquent : le nombre est donc une estimation.

Clics

Chaque lien passe par une redirection qui compte le clic et emmène le destinataire directement vers l’adresse d’origine.

Confidentialité

Les destinataires qui ont refusé le suivi sur la page de préférences ne sont jamais suivis. Pour désactiver le suivi d’un e-mail, envoyez track_opens: false et track_clicks: false.

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.