Evento de webhook · Tracking

email_clicked

Enviado quando um destinatário clica em um link de um email com tracking de cliques ativo. Inclui a URL e se foi o primeiro clique.

i

Enviado como um POST assinado para a sua URL de webhook. Veja Configuração e eventos para saber como verificar a assinatura.

Payload

// First click (API / SMTP email)
{
  "event": "email_clicked",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T05:15:22.000Z",
  "data": {
    "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
    "recipientEmail": "john.doe@example.com",
    "track": "a41f9c0e7b2d58e6",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "ip": "203.112.45.78",
    "location": "MY",
    "url": "https://example.com/promotion",
    "isFirstClick": true,
    "isFirstOpen": true
  }
}
!

Um clique sem abertura também envia email_opened. Se o destinatário clica antes de as imagens carregarem, também contamos a abertura: você recebe email_clicked com isFirstOpen: true e um evento email_opened logo em seguida.

Referência dos campos

  • event

    Valor fixo: "email_clicked".

  • emailId

    ID do email que recebeu o clique. Também repetido em data.emailId.

  • timestamp

    Quando o clique aconteceu (ISO 8601, UTC).

  • data.recipientEmail

    Quem clicou.

  • data.track

    Só para emails de API / SMTP enviados com um track: a chave do track.

  • data.campaignId

    Só para emails de campanha: o ID da campanha.

  • data.url

    O link que foi clicado.

  • data.isFirstClick

    True na primeira vez que este destinatário clica neste email.

  • data.isFirstOpen

    True quando este clique também é a primeira abertura (as imagens não tinham sido carregadas antes).

  • data.userAgent

    User agent do clique.

  • data.ip

    Endereço IP do clique.

  • data.location

    Código do país desse IP, como "MY" ou "US".