Event webhook · Pelacakan

email_opened

Dikirim saat penerima membuka email dengan pelacakan open aktif. Berisi perangkat, IP, negara, dan apakah open datang melalui proxy.

i

Dikirim sebagai POST bertanda tangan ke URL webhook Anda. Lihat Penyiapan & event untuk cara memverifikasi tanda tangan.

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

Open melalui proxy juga dikirim. Open melalui proxy tetap mengirim event ini, ditandai dengan isProxy: true. Filter berdasarkan field ini jika Anda hanya ingin open yang pasti berasal dari manusia.

Referensi field

  • event

    Nilai tetap: "email_opened".

  • emailId

    ID email yang dibuka. Juga diulang di data.emailId.

  • timestamp

    Kapan open terjadi (ISO 8601, UTC).

  • data.recipientEmail

    Siapa yang membukanya.

  • data.track

    Hanya untuk email API / SMTP yang dikirim dengan track: kunci track.

  • data.campaignId

    Hanya untuk email kampanye: ID kampanye.

  • data.userAgent

    User agent dari request yang memuat gambar.

  • data.ip

    Alamat IP dari request tersebut.

  • data.location

    Kode negara dari IP tersebut, misalnya "MY" atau "US".

  • data.isProxy

    True jika open datang dari proxy atau pemindai kotak surat (proxy gambar Gmail, privasi Apple Mail), bukan langsung dari penerima.

  • data.isFirstOpen

    True saat pertama kali penerima ini membuka email ini. Bisa null jika tidak dapat diketahui.