Evento de webhook · Feedback

fbl_complaint

Enviado quando um destinatário denuncia seu email como spam: pelo feedback loop de um provedor de email (Microsoft, Yahoo, AOL), respondendo ao endereço de abuso do header X-Report-Abuse ou na página de denúncia de abuso linkada no email.

i

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

Payload

// Feedback loop (Yahoo)
{
  "event": "fbl_complaint",
  "emailId": "4b1f0c7e-2d9a-4e83-9b6c-1a7d5e0f3c28",
  "timestamp": "2026-10-20T13:05:41.000Z",
  "data": {
    "complainant": "john@yahoo.com",
    "fromAddress": "Acme <news@acme.com>",
    "subject": "Your October deals",
    "source": "fbl_yahoo"
  }
}
!

Um evento por email Se o mesmo email for denunciado mais de uma vez (por exemplo, pelo feedback loop e pela página de abuso), você recebe o evento só uma vez. O contato é marcado como complained e passa a ser ignorado por todas as campanhas a partir daí. As reclamações também aparecem na página Bounces & Complaints e na API de feedback.

Referência dos campos

  • event

    Valor fixo: "fbl_complaint"

  • emailId

    Identificador único do email denunciado.

  • timestamp

    Quando a reclamação foi processada (ISO 8601, UTC).

  • data.complainant

    Destinatário que denunciou o email.

  • data.fromAddress

    Endereço do remetente do email denunciado.

  • data.subject

    Assunto do email denunciado. Vazio ou ausente quando o provedor o oculta e na página de denúncia.

  • data.source

    De onde veio a reclamação: "fbl_microsoft", "fbl_yahoo" (Yahoo e AOL), "fbl_other", "abuse_mailbox" (resposta ao endereço do X-Report-Abuse) ou "abuse_web" (página de denúncia de abuso).

  • data.reason

    Só para "abuse_web": o motivo escolhido na página de denúncia: "spam", "unsubscribe_failed", "phishing", "offensive" ou "other".