Bounces & Complaints

Ketahui email mana yang tidak sampai, dan alasannya

Hard dan soft bounce, pemblokiran, keluhan spam, dan laporan penyalahgunaan dalam satu feed. Polling dengan cursor, bersihkan daftar Anda, dan jangan pernah melewatkan event.

  • Perintah JSON
  • Polling dengan cursor
  • Hingga 1000 per panggilan
  • 90 hari terakhir
  • Hanya baca
POSThttps://g.sendcorex.com/v1/feedbackfeedback:read

Cara kerjanya

Semua yang kembali

Bounce saat pengiriman, pesan bounce yang datang belakangan, feedback loop dari Microsoft dan Yahoo, serta laporan penyalahgunaan yang dikirim orang kepada kami. Satu feed, satu struktur.

Hard, soft, atau diblokir

Tidak setiap 5xx berarti alamat buruk. Setiap event menyebutkan apakah alamat sudah tidak ada (hard), bersifat sementara (soft), atau pesannya sendiri yang ditolak (blocked).

Dibuat untuk polling

Terlama lebih dulu, dengan cursor yang selalu dikembalikan. Simpan, kirim lagi, dan Anda mendapatkan tepat apa yang baru. Satu event per email, tidak pernah dua kali.

Mulai

Hanya key yang dibutuhkan sebelum request pertama Anda.

  1. 1

    Buat API key dengan feedback:read

    Di dashboard, buka Developers → API Keys dan buat key dengan scope feedback:read, atau tambahkan ke key yang sudah Anda pakai.

    Token webmail tidak berfungsi di sini. API ini memakai API key dari dashboard.

  2. 2

    Polling feed

    List Feedback mengembalikan apa yang baru sejak cursor Anda. Simpan next_cursor yang diberikan dan kirim di panggilan berikutnya.

  3. 3

    Cari satu email

    Get Email memberi tahu semua yang kembali untuk satu id email: bounce-nya, keluhannya, atau alasan email itu tidak dikirim.

Event

Kedua perintah mengembalikan event dengan struktur ini.

{
  "email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
  "kind": "bounce_hard",
  "source": "smtp",
  "recipient": "old.address@gmail.com",
  "from": "noreply@yourdomain.com",
  "smtp_code": 550,
  "enhanced_code": "5.1.1",
  "diagnostic": "550-5.1.1 The email account that you tried to reach does not exist.",
  "at": "2026-10-17T05:58:44.031Z"
}
kind

bounce_hard, bounce_soft, blocked, complaint, atau dropped. Hanya hard bounce dan keluhan yang berarti "berhenti mengirim ke alamat ini".

source

Asalnya: jawaban SMTP, pesan bounce yang datang belakangan, feedback loop, atau laporan penyalahgunaan.

smtp_code / enhanced_code

Kode yang dijawab server, seperti 550 dan 5.1.1. diagnostic berisi teks lengkapnya.

email_id

id yang sama dengan di Logs dan di webhook, sehingga Anda bisa menggabungkannya.

Request pertama Anda

Hard bounce dan keluhan Anda sejak awal bulan. Ganti SENDCOREX_API_KEY dengan API key Anda.

curl -X POST 'https://g.sendcorex.com/v1/feedback' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_feedback", "args": { "since": "2026-10-01T00:00:00Z", "kinds": ["bounce_hard", "complaint"] } }
  ]
}'

Anda mendapatkan event terlama lebih dulu dan sebuah next_cursor. Simpan dan kirim di panggilan berikutnya untuk hanya mendapatkan yang baru. Request yang sama dalam 8 bahasa ada di List Feedback.

Tugas umum

Jaga daftar Anda tetap bersih

Lakukan polling setiap 30 detik dan hapus alamat yang mengalami hard bounce atau mengeluh. Reputasi Anda tetap tinggi dan pengiriman Anda tidak masuk spam.

Polling

Tangkap keluhan dengan cepat

Filter feed ke complaint dan beri tahu tim Anda: lonjakan keluhan adalah tanda pertama sebuah kampanye bermasalah.

Filter berdasarkan jenis

Jelaskan email yang tidak sampai

Berdasarkan id email, tunjukkan kepada pelanggan Anda alasan persis yang diberikan server penerima.

Get Email

Dapatkan lewat push

Webhook bounced dan fbl_complaint mengirim event yang sama saat terjadi. Gunakan polling sebagai jaring pengaman.

Webhooks

Referensi lengkap

Semua yang bertanda CMD adalah perintah yang dikirim melalui POST /v1/feedback, hingga 20 per request.