Événement webhook · Suivi
email_opened
Envoyé lorsqu'un destinataire ouvre un e-mail avec le suivi des ouvertures activé. Inclut l'appareil, l'IP, le pays et si l'ouverture est passée par un proxy.
Envoyé sous forme de requête POST signée vers votre URL de webhook. Consultez Configuration et événements pour savoir comment vérifier la signature.
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
}
}Les ouvertures par proxy sont aussi envoyées. Les ouvertures via un proxy envoient quand même cet événement, marqué isProxy: true. Filtrez dessus si vous ne voulez que les ouvertures dont vous êtes sûr qu’elles viennent d’une personne.
Référence des champs
eventValeur fixe : "email_opened".
emailIdID de l'e-mail ouvert. Également répété dans data.emailId.
timestampDate de l'ouverture (ISO 8601, UTC).
data.recipientEmailQui l'a ouvert.
data.trackUniquement pour les e-mails API / SMTP envoyés avec un track : la clé du track.
data.campaignIdUniquement pour les e-mails de campagne : l’ID de la campagne.
data.userAgentUser agent de la requête qui a chargé l'image.
data.ipAdresse IP de cette requête.
data.locationCode pays de cette IP, par exemple "MY" ou "US".
data.isProxyTrue lorsque l'ouverture provient d'un proxy ou d'un scanner de messagerie (proxy d'images de Gmail, confidentialité d'Apple Mail), et non directement du destinataire.
data.isFirstOpenTrue la première fois que ce destinataire ouvre cet e-mail. Peut être null lorsque ce n'est pas possible de le savoir.