É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.

i

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

  • event

    Valeur fixe : "email_opened".

  • emailId

    ID de l'e-mail ouvert. Également répété dans data.emailId.

  • timestamp

    Date de l'ouverture (ISO 8601, UTC).

  • data.recipientEmail

    Qui l'a ouvert.

  • data.track

    Uniquement pour les e-mails API / SMTP envoyés avec un track : la clé du track.

  • data.campaignId

    Uniquement pour les e-mails de campagne : l’ID de la campagne.

  • data.userAgent

    User agent de la requête qui a chargé l'image.

  • data.ip

    Adresse IP de cette requête.

  • data.location

    Code pays de cette IP, par exemple "MY" ou "US".

  • data.isProxy

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

    True la première fois que ce destinataire ouvre cet e-mail. Peut être null lorsque ce n'est pas possible de le savoir.