Evento de webhook · Tracking

email_opened

Se envía cuando un destinatario abre un email con el tracking de aperturas activo. Incluye el dispositivo, la IP, el país y si la apertura vino de un proxy.

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

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

Las aperturas por proxy también se envían. Las aperturas por proxy también envían este evento, marcadas con isProxy: true. Filtra por ese campo si solo quieres aperturas que seguro vinieron de una persona.

Referencia de campos

  • event

    Valor fijo: "email_opened".

  • emailId

    ID del email que se abrió. También se repite en data.emailId.

  • timestamp

    Cuándo ocurrió la apertura (ISO 8601, UTC).

  • data.recipientEmail

    Quién lo abrió.

  • data.track

    Solo para emails de API / SMTP enviados con un track: la clave del track.

  • data.campaignId

    Solo para emails de campaña: el ID de la campaña.

  • data.userAgent

    User agent de la solicitud que cargó la imagen.

  • data.ip

    Dirección IP de esa solicitud.

  • data.location

    Código de país de esa IP, como "MY" o "US".

  • data.isProxy

    True cuando la apertura vino de un proxy o escáner del buzón (proxy de imágenes de Gmail, privacidad de Apple Mail), no directamente del destinatario.

  • data.isFirstOpen

    True la primera vez que este destinatario abre este email. Puede ser null cuando no se puede saber.