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.

i

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

  • event

    Valor fixo: "email_opened".

  • emailId

    ID do email que foi aberto. Também repetido em data.emailId.

  • timestamp

    Quando a abertura aconteceu (ISO 8601, UTC).

  • data.recipientEmail

    Quem abriu.

  • data.track

    Só para emails de API / SMTP enviados com um track: a chave do track.

  • data.campaignId

    Só para emails de campanha: o ID da campanha.

  • data.userAgent

    User agent da requisição que carregou a imagem.

  • data.ip

    Endereço IP dessa requisição.

  • data.location

    Código do país desse IP, como "MY" ou "US".

  • data.isProxy

    True 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.isFirstOpen

    True na primeira vez que este destinatário abre este email. Pode ser null quando não dá para saber.