Evento de webhook · Tracking
email_opened
Enviado quando um destinatário abre um email com tracking de abertura ativo. Inclui o dispositivo, o IP, o país e se a abertura veio por um proxy.
Enviado como um POST assinado para a sua URL de webhook. Veja Configuração e eventos para saber como verificar a assinatura.
Payload
// Opened (API / SMTP email)
{
"event": "email_opened",
"emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"timestamp": "2026-10-23T05:12:44.000Z",
"data": {
"emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"recipientEmail": "john.doe@example.com",
"track": "a41f9c0e7b2d58e6",
"userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
"ip": "203.112.45.78",
"location": "MY",
"isProxy": false,
"isFirstOpen": true
}
}Aberturas por proxy também são enviadas. Aberturas por proxy também enviam este evento, marcadas com isProxy: true. Filtre por esse campo se quiser só as aberturas que com certeza vieram de uma pessoa.
Referência dos campos
eventValor fixo: "email_opened".
emailIdID do email que foi aberto. Também repetido em data.emailId.
timestampQuando a abertura aconteceu (ISO 8601, UTC).
data.recipientEmailQuem abriu.
data.trackSó para emails de API / SMTP enviados com um track: a chave do track.
data.campaignIdSó para emails de campanha: o ID da campanha.
data.userAgentUser agent da requisição que carregou a imagem.
data.ipEndereço IP dessa requisição.
data.locationCódigo do país desse IP, como "MY" ou "US".
data.isProxyTrue quando a abertura veio de um proxy ou scanner da caixa de email (proxy de imagens do Gmail, privacidade do Apple Mail), e não direto do destinatário.
data.isFirstOpenTrue na primeira vez que este destinatário abre este email. Pode ser null quando não dá para saber.