E-Mails empfangen: Senden und Vertrauen

Tracking abrufen

Gibt Öffnungen und Klicks der E-Mails zurück, die dieses Postfach gesendet hat. Nur lesend.

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

Im Ergebnis erscheinen nur Nachrichten, die mit Tracking gesendet wurden.

i

Öffnungen durch Bots und Proxys werden nicht gezählt.

!

Öffnungen sind eine Schätzung: Manche E-Mail-Apps laden Bilder automatisch oder blockieren sie.

i

Der Status jeder Nachricht wird 180 Tage lang gespeichert.

Argumente

  • idsstring[]erforderlich

    1 bis 200 message_uid gesendeter Nachrichten. Sie kommen aus Sent, aus der Antwort von send_email / reply oder aus list_messages.

Schnellstart

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

Antwort

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

Antwortfelder

  • tracking.<message_uid>

    Ein Eintrag pro Nachricht, die mit Tracking gesendet wurde. Nachrichten ohne Tracking werden nicht aufgeführt.

  • track_opens / track_clicks

    Was beim Senden der E-Mail erfasst wurde.

  • opens / clicks

    Summen über alle Empfänger.

  • first_open_at / last_open_at / last_click_at

    Erste und letzte Aktivität (UTC) oder null.

  • unsubscribe / unsubscribes

    Ob die E-Mail einen Abmeldelink hatte und wie viele Empfänger sich darüber abgemeldet haben.

  • recipients

    Pro Empfänger: email, opens, clicks, last_at, unsubscribed und urls (jeder geklickte Link, neueste zuerst, mit url, at des letzten Klicks und clicks; [], wenn die Person nicht geklickt hat).

Tracking

Wie Öffnungen und Klicks gemessen werden.

Öffnungen

Jede E-Mail enthält ein unsichtbares Pixel. Lädt die App des Empfängers es, wird eine Öffnung gezählt. Manche Apps laden Bilder selbstständig oder blockieren sie, daher ist die Zahl eine Schätzung.

Klicks

Jeder Link läuft über eine Weiterleitung, die den Klick zählt und den Empfänger direkt zur ursprünglichen Adresse bringt.

Datenschutz

Empfänger, die das Tracking auf der Einstellungsseite abgelehnt haben, werden nie erfasst. Um das Tracking für eine E-Mail auszuschalten, senden Sie track_opens: false und track_clicks: false.

Fehler

Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.

  • 401TOKEN_EXPIRED

    Der Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.

  • 401INVALID_TOKEN

    Der Token ist fehlerhaft, unbekannt oder widerrufen.

  • 429RATE_LIMITED

    Mehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.

  • CMDINVALID_ARGS

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDINTERNAL

    Serverfehler. Die Details werden nur ins Server-Log geschrieben.