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.
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
eventValor fijo: "email_opened".
emailIdID del email que se abrió. También se repite en data.emailId.
timestampCuándo ocurrió la apertura (ISO 8601, UTC).
data.recipientEmailQuién lo abrió.
data.trackSolo para emails de API / SMTP enviados con un track: la clave del track.
data.campaignIdSolo para emails de campaña: el ID de la campaña.
data.userAgentUser agent de la solicitud que cargó la imagen.
data.ipDirección IP de esa solicitud.
data.locationCódigo de país de esa IP, como "MY" o "US".
data.isProxyTrue 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.isFirstOpenTrue la primera vez que este destinatario abre este email. Puede ser null cuando no se puede saber.