Evento de webhook · Tracking

tracking_preferences_updated

Enviado quando um destinatário muda a escolha de tracking de aberturas ou cliques na página de preferências de tracking. Ele continua recebendo seus emails: isto não é um descadastro.

i

Enviado como um POST assinado para a sua URL de webhook. Veja Configuração e eventos para saber como verificar a assinatura.

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"
  }
}
!

Só quando algo mudou Salvar a mesma escolha de novo não envia o webhook. As mudanças que você mesmo faz com Set Preferences também não são enviadas, então a sincronização com o seu CRM nunca entra em loop. Uma recusa é aplicada aos seus envios na hora: emails enviados com "unsubscribe": true saem sem o pixel e sem os links rastreados para esse destinatário.

i

API de Preferências de tracking Consulte um destinatário ou 100 de uma vez, veja o histórico completo de um destinatário e acompanhe cada mudança com um cursor.

Preferências de tracking →

Referência dos campos

  • event

    Valor fixo: "tracking_preferences_updated"

  • timestamp

    Quando a mudança foi processada (ISO 8601, UTC).

  • data.recipientEmail

    O destinatário que mudou a preferência.

  • data.trackOpens

    true: o destinatário permite o tracking de aberturas. false: ele recusou.

  • data.trackClicks

    true: o destinatário permite o tracking de cliques. false: ele recusou.

  • data.source

    Valor fixo por enquanto: "page" (o destinatário usou a página de preferências de tracking).

  • data.updatedAt

    Quando a preferência foi salva (ISO 8601, UTC). O mesmo valor de updated_at na API.

  • data.campaignId

    A campanha do email de onde o destinatário veio. Só para emails de campanha.

  • data.trackId

    Chave de tracking do email, para emails enviados pela API ou por SMTP. Só quando o tracking estava ativo nesse envio.