Event webhook · Feedback

fbl_complaint

Dikirim saat penerima melaporkan email Anda sebagai spam: melalui feedback loop penyedia kotak surat (Microsoft, Yahoo, AOL), dengan membalas ke alamat abuse di header X-Report-Abuse, atau di halaman laporan penyalahgunaan yang ditautkan dari email.

i

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

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

Satu event per email Jika email yang sama dilaporkan lebih dari sekali (misalnya oleh feedback loop dan halaman abuse), Anda hanya menerima event sekali. Kontak ditandai sebagai complained dan dilewati oleh semua kampanye sejak saat itu. Komplain juga muncul di halaman Bounces & Complaints dan di API feedback.

Referensi field

  • event

    Nilai tetap: "fbl_complaint"

  • emailId

    Pengenal unik email yang dilaporkan.

  • timestamp

    Kapan komplain diproses (ISO 8601, UTC).

  • data.complainant

    Penerima yang melaporkan email.

  • data.fromAddress

    Alamat pengirim email yang dilaporkan.

  • data.subject

    Subjek email yang dilaporkan. Kosong atau tidak ada jika penyedia menyamarkannya dan di halaman laporan.

  • data.source

    Asal komplain: "fbl_microsoft", "fbl_yahoo" (Yahoo dan AOL), "fbl_other", "abuse_mailbox" (balasan ke alamat X-Report-Abuse), atau "abuse_web" (halaman laporan penyalahgunaan).

  • data.reason

    Hanya untuk "abuse_web": alasan yang dipilih di halaman laporan: "spam", "unsubscribe_failed", "phishing", "offensive", atau "other".