Tracking Preferences: Membaca

Daftar perubahan

Setiap perubahan preferensi di akun Anda, terlama lebih dulu, dengan cursor. Jaga CRM Anda tetap sinkron tanpa melewatkan satu pun.

POSThttps://g.sendcorex.com/v1/privacycommand: list_changes
i

Membutuhkan scope privacy:read pada API key Anda.

i

Simpan next_cursor dan kirim di panggilan berikutnya. Nilai ini selalu kembali, bahkan saat tidak ada perubahan.

i

Perubahan muncul sekitar 5 detik setelah terjadi, dan feed menyimpan 90 hari terakhir.

Argumen

  • cursorstringopsional

    next_cursor dari panggilan sebelumnya. Tanpanya, Anda mulai dari awal rentang 90 hari.

    mis. "ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20"

  • limitnumberopsional

    Perubahan per panggilan, dari 1 hingga 1000. Default-nya 100.

    mis. 100

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/privacy',
  {
    commands: [
      {
        command: "list_changes",
        args: {
          cursor: "ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20",
          limit: 100
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

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

Respons

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "list_changes",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 6,
      "data": {
        "changes": [
          {
            "email": "jane.doe@example.com",
            "track_opens": false,
            "track_clicks": true,
            "source": "page",
            "updated_at": "2026-10-24T07:20:12.031Z"
          },
          {
            "email": "marc.dupont@example.fr",
            "track_opens": false,
            "track_clicks": false,
            "source": "api",
            "updated_at": "2026-10-24T07:41:55.508Z"
          }
        ],
        "next_cursor": "ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20",
        "has_more": false
      }
    }
  ]
}

Field respons

  • changes

    Perubahan dari panggilan ini, terlama lebih dulu. Masing-masing adalah status lengkap penerima setelah perubahan.

  • next_cursor

    Kirim sebagai cursor di panggilan berikutnya.

  • has_more

    true jika masih ada perubahan yang menunggu: panggil lagi segera.

  • changes[].email

    Alamat penerima, dalam huruf kecil.

  • changes[].track_opens

    true penerima mengizinkan pelacakan open, false menolaknya, null belum pernah memilih.

  • changes[].track_clicks

    true penerima mengizinkan pelacakan klik, false menolaknya, null belum pernah memilih.

  • changes[].source

    Siapa yang melakukan perubahan: page (penerima, di halaman preferensi tracking), api (Anda, dengan Set Preferences), atau dashboard.

  • changes[].updated_at

    Kapan perubahan dilakukan. ISO 8601, UTC.

Sinkronkan dengan CRM Anda

Simpan cursor di tempat yang bertahan setelah restart. Pada setiap siklus, baca sampai has_more bernilai false dan tulis setiap perubahan ke kontak di CRM Anda (Salesforce, HubSpot…).

Node.js

let cursor = await loadCursor(); // null the first time

async function sync() {
  let more = true;
  while (more) {
    const [r] = await call({ command: 'list_changes', args: cursor ? { cursor, limit: 500 } : { limit: 500 } });
    for (const c of r.data.changes) {
      if (c.source === 'api') continue; // you made this change yourself
      await crm.updateContact(c.email, { trackOpens: c.track_opens, trackClicks: c.track_clicks, consentAt: c.updated_at });
    }
    cursor = r.data.next_cursor;
    await saveCursor(cursor);
    more = r.data.has_more;
  }
}

setInterval(sync, 60_000);
i

Lebih suka push? Webhook tracking_preferences_updated mengirim setiap perubahan yang dibuat di halaman saat terjadi. Gunakan perintah ini sebagai jaring pengaman.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401INVALID_API_KEY

    API key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.

  • 429RATE_LIMITED

    Lebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.

  • CMDMISSING_SCOPE

    API key tidak memiliki scope perintah ini (`privacy:read` untuk membaca, `privacy:write` untuk mengubah).

  • CMDINVALID_ARGS

    Ada argumen yang tidak valid: `email` tidak ada atau salah format, lebih dari 100 `emails`, `track_opens` yang bukan `true`/`false`, limit di luar rentang…

  • CMDINVALID_CURSOR

    Cursor tidak valid atau berasal dari akun lain. Mulai lagi tanpa cursor.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.