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
https://g.sendcorex.com/v1/feedbackfeedback:readCara 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
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
Polling feed
List Feedback mengembalikan apa yang baru sejak cursor Anda. Simpan next_cursor yang diberikan dan kirim di panggilan berikutnya.
- 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"
}kindbounce_hard, bounce_soft, blocked, complaint, atau dropped. Hanya hard bounce dan keluhan yang berarti "berhenti mengirim ke alamat ini".
sourceAsalnya: jawaban SMTP, pesan bounce yang datang belakangan, feedback loop, atau laporan penyalahgunaan.
smtp_code / enhanced_codeKode yang dijawab server, seperti 550 dan 5.1.1. diagnostic berisi teks lengkapnya.
email_idid 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.
PollingTangkap keluhan dengan cepat
Filter feed ke complaint dan beri tahu tim Anda: lonjakan keluhan adalah tanda pertama sebuah kampanye bermasalah.
Filter berdasarkan jenisJelaskan email yang tidak sampai
Berdasarkan id email, tunjukkan kepada pelanggan Anda alasan persis yang diberikan server penerima.
Get EmailDapatkan lewat push
Webhook bounced dan fbl_complaint mengirim event yang sama saat terjadi. Gunakan polling sebagai jaring pengaman.
WebhooksReferensi lengkap
Semua yang bertanda CMD adalah perintah yang dikirim melalui POST /v1/feedback, hingga 20 per request.