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.
https://g.sendcorex.com/v1/privacycommand: list_changesMembutuhkan scope privacy:read pada API key Anda.
Simpan next_cursor dan kirim di panggilan berikutnya. Nilai ini selalu kembali, bahkan saat tidak ada perubahan.
Perubahan muncul sekitar 5 detik setelah terjadi, dan feed menyimpan 90 hari terakhir.
Argumen
cursorstringopsionalnext_cursordari panggilan sebelumnya. Tanpanya, Anda mulai dari awal rentang 90 hari.mis.
"ZjowMDAwMDAwMDgzOjE3NjEyOTA0MTIwMzE6amFuZS5kb2VAZXhhbXBsZS5jb20"limitnumberopsionalPerubahan 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
changesPerubahan dari panggilan ini, terlama lebih dulu. Masing-masing adalah status lengkap penerima setelah perubahan.
next_cursorKirim sebagai
cursordi panggilan berikutnya.has_moretruejika masih ada perubahan yang menunggu: panggil lagi segera.changes[].emailAlamat penerima, dalam huruf kecil.
changes[].track_openstruepenerima mengizinkan pelacakan open,falsemenolaknya,nullbelum pernah memilih.changes[].track_clickstruepenerima mengizinkan pelacakan klik,falsemenolaknya,nullbelum pernah memilih.changes[].sourceSiapa yang melakukan perubahan:
page(penerima, di halaman preferensi tracking),api(Anda, dengan Set Preferences), ataudashboard.changes[].updated_atKapan 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);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.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki scope perintah ini (`privacy:read` untuk membaca, `privacy:write` untuk mengubah).
- CMD
INVALID_ARGSAda argumen yang tidak valid: `email` tidak ada atau salah format, lebih dari 100 `emails`, `track_opens` yang bukan `true`/`false`, limit di luar rentang…
- CMD
INVALID_CURSORCursor tidak valid atau berasal dari akun lain. Mulai lagi tanpa cursor.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.