Suppression

Berhenti mengirim ke alamat yang merugikan Anda.

Disiapkan dalam:

Setiap bounce, komplain, dan unsubscribe secara otomatis menambahkan penerima ke daftar suppression Anda, sehingga Anda tidak mengirimnya lagi. Suppression dapat dibatalkan, dapat dikueri melalui API, dan berlaku di seluruh pengiriman transaksional dan marketing.

welcome.tsx
200 · 1.2s
import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.email.send({
  from:    "Bird <hello@bird.com>",
  to:      ["ada@example.com"],
  subject: "Your invite is ready",
  html:    await render(<WelcomeEmail name="Ada" />),
}).safe();

if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."

Tuas tunggal terbesar bagi reputasi Anda.

Suppression terintegrasi ke dalam Email API Bird, bukan daftar yang Anda kelola secara manual. Penyedia mailbox menghukum pengirim yang terus menyasar alamat mati dan komplain spam-trap; Bird menghentikan pengiriman tersebut untuk Anda, secara otomatis, saat seorang penerima menjadi buruk.

Lima cara suppression melindungi Anda.

Otomatis, dapat dibatalkan, dan dapat dikueri.

  1. 01

    Otomatis saat bounce + komplain.

    Hard bounce, keluhan spam, dan unsubscribe menekan penerima secara otomatis. Tanpa perlu kode.

  2. 02

    Dapat dibatalkan.

    Tidak ada yang permanen. Hapus sebuah alamat jika pulih kembali, lalu lanjutkan mengirim email ke alamat itu.

  3. 03

    Entri manual.

    Tambahkan alamat sendiri: misalnya daftar alamat buruk yang sudah diketahui yang Anda impor dari penyedia lain.

  4. 04

    Dapat dikueri melalui API.

    Buat daftar, periksa, tambahkan, dan hapus suppression secara terprogram, sehingga sistem Anda sendiri tetap sinkron.

  5. 05

    Satu daftar, setiap pengiriman.

    Suppression berlaku di seluruh email transaksional dan marketing, sehingga sebuah kampanye tidak dapat mengirim ulang ke alamat yang baru saja mem-bounce sebuah resi.

Otomatis secara bawaan, dan tetap dalam kendali Anda.

Anda tidak perlu menyentuh daftar ini agar berfungsi; bounce dan keluhan menekan dengan sendirinya. Namun saat dibutuhkan, seluruh daftar adalah sebuah API: tambahkan alamat yang sudah Anda tahu buruk, cari satu alamat, atau pulihkan penerima yang sudah membaik.

suppressions.ts
200
// Suppress an address you already know is bad.
await bird.email.suppressions.create({ email: "ada@example.com" });

// Look up why an address is on the list.
const { data } = await bird.email.suppressions.list({
  email: "ada@example.com",
});
// → [{ reason: "hard_bounce", applies_to: "all", created_at }]

// Reinstate one that recovered.
await bird.email.suppressions.remove("ada@example.com");

Empat alasan, dua cakupan.

Tidak setiap suppression memblokir setiap pengiriman. Penerima yang berhenti berlangganan marketing tetap menerima reset kata sandi mereka: keluhan dan unsubscribe hanya berlaku untuk marketing, sedangkan hard bounce dan penambahan manual memblokir semuanya.

AlasanDipicu olehMemblokir
hard_bouncebounce permanensemua email (transaksional + marketing)
complaintkeluhan spampemasaran saja
unsubscribeberhenti berlangganan melalui daftar atau sekali klikpemasaran saja
manualAnda, melalui API atau dashboardsemua email (transaksional + marketing)

Pelajari lebih dalam di dokumentasi.

Baca cara kerja suppression otomatis dan manual di panduan suppression, dan bagaimana ia menyatu dalam gambaran besar di panduan deliverability.

FAQ Suppression

Apa yang di-suppress secara otomatis?+
Hard bounce, komplain spam, dan unsubscribe. Begitu seorang penerima memicu salah satunya, Bird menambahkannya ke daftar suppression Anda dan melewatinya pada pengiriman berikutnya.
Bisakah saya menghapus sebuah alamat dari daftar suppression?+
Ya, suppression dapat dibatalkan. Jika sebuah alamat pulih kembali, hapus dari daftar melalui dashboard atau API, lalu lanjutkan mengirim email ke alamat itu.
Bisakah saya menambahkan suppression saya sendiri?+
Ya. Tambahkan alamat secara manual, misalnya daftar alamat buruk yang sedang Anda impor, dan alamat tersebut akan dilewati sama seperti entri otomatis.
Apakah suppression berlaku untuk email transaksional dan marketing?+
Hard bounce dan entri manual memblokir setiap pengiriman. Keluhan dan berhenti berlangganan hanya tercakup pada pemasaran, sehingga pesan transaksional seperti reset kata sandi tetap menjangkau seseorang yang telah keluar dari kampanye Anda.
Bagaimana cara menguji penekanan tanpa mengorbankan alamat sungguhan?+
Kirim ke alamat sandbox suppressed@messagebird.dev. Alamat ini langsung berhenti persis seolah-olah penerima ada di daftar Anda (ditolak dengan recipient_suppressed), tanpa menulis apa pun ke daftar, sehingga dapat dipakai berulang.

Sekitar 40% surel komersial dunia sudah berjalan di Bird.

Email transaksional dan marketing di atas infrastruktur yang telah kami jalankan selama satu dekade. Suppression adalah salah satu kemampuan dari Bird Email API: pengiriman, deliverability, IP khusus, dan analytics sudah termasuk di dalamnya.

Mulai dengan satu channel.
Tambahkan yang lain saat Anda siap.

API key uji coba langsung tersedia untuk Anda. Akses produksi terbuka setelah Anda menambahkan metode pembayaran dan memverifikasi pengirim.

Menggunakan Claude Code, Cursor, atau Codex? Salin prompt pengaturan dan agen Anda akan menginstal Bird CLI dan skill untuk Anda. Pilih milik Anda: