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.
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.
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
eventValor fixo: "tracking_preferences_updated"
timestampQuando a mudança foi processada (ISO 8601, UTC).
data.recipientEmailO destinatário que mudou a preferência.
data.trackOpenstrue: o destinatário permite o tracking de aberturas. false: ele recusou.
data.trackClickstrue: o destinatário permite o tracking de cliques. false: ele recusou.
data.sourceValor fixo por enquanto: "page" (o destinatário usou a página de preferências de tracking).
data.updatedAtQuando a preferência foi salva (ISO 8601, UTC). O mesmo valor de updated_at na API.
data.campaignIdA campanha do email de onde o destinatário veio. Só para emails de campanha.
data.trackIdChave de tracking do email, para emails enviados pela API ou por SMTP. Só quando o tracking estava ativo nesse envio.