Evento de webhook · Tracking

tracking_preferences_updated

Se envía cuando un destinatario cambia su elección de tracking de aperturas o clics en la página de preferencias de tracking. Sigue recibiendo tus emails: esto no es una baja.

i

Se envía como un POST firmado a tu URL de webhook. Consulta Configuración y eventos para ver cómo verificar la firma.

Payload

// Turned open tracking off (API / SMTP email)
{
  "event": "tracking_preferences_updated",
  "timestamp": "2026-10-24T07:20:12.031Z",
  "data": {
    "recipientEmail": "jane.doe@example.com",
    "trackOpens": false,
    "trackClicks": true,
    "source": "page",
    "updatedAt": "2026-10-24T07:20:12.031Z",
    "trackId": "a41f9c0e7b2d58e6"
  }
}
!

Solo cuando algo cambió Guardar la misma elección otra vez no envía el webhook. Los cambios que haces tú con Set Preferences tampoco se envían, así que la sincronización con tu CRM nunca entra en bucle. Un rechazo se aplica a tus envíos al instante: los emails enviados con "unsubscribe": true salen sin el píxel ni los enlaces rastreados para ese destinatario.

i

API de Preferencias de tracking Consulta un destinatario o 100 a la vez, mira el historial completo de un destinatario y consulta cada cambio con un cursor.

Preferencias de tracking →

Referencia de campos

  • event

    Valor fijo: "tracking_preferences_updated"

  • timestamp

    Cuándo se procesó el cambio (ISO 8601, UTC).

  • data.recipientEmail

    El destinatario que cambió su preferencia.

  • data.trackOpens

    true: el destinatario permite el tracking de aperturas. false: lo rechazó.

  • data.trackClicks

    true: el destinatario permite el tracking de clics. false: lo rechazó.

  • data.source

    Valor fijo por ahora: "page" (el destinatario usó la página de preferencias de tracking).

  • data.updatedAt

    Cuándo se guardó la preferencia (ISO 8601, UTC). El mismo valor que updated_at en la API.

  • data.campaignId

    La campaña del email desde el que llegó el destinatario. Solo para emails de campaña.

  • data.trackId

    Clave de tracking del email, para emails enviados por la API o SMTP. Solo cuando el tracking estaba activo en ese envío.