Suppression
Przestań wysyłać na adresy, które Ci szkodzą.
Każde odbicie, skarga i wypis automatycznie dodaje odbiorcę do Twojej listy suppression, więc nie wysyłasz do niego ponownie. Suppression jest odwracalne, dostępne do zapytań przez API i obejmuje wysyłki transakcyjne i marketingowe.
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..."
You can sign in any time at bird.com/login.
Your test API key is on your dashboard, ready to send.
Największa pojedyncza dźwignia wpływająca na Twoją reputację.
Supresja jest wbudowana w Bird Email API, a nie w listę, którą prowadzisz ręcznie. Dostawcy skrzynek pocztowych karzą nadawców, którzy ciągle wysyłają na martwe adresy i generują skargi na spam. Te wysyłki są automatycznie blokowane w momencie, gdy odbiorca staje się nieaktywny.
Pięć sposobów, w jakie suppression Cię chroni.
Automatyczne, odwracalne i dostępne do zapytań.
- 01
Automatyczne przy odbiciu i skardze.
Trwałe odbicia (hard bounce), skargi na spam i rezygnacje z subskrypcji automatycznie wstrzymują wysyłkę do odbiorcy. Bez pisania kodu.
- 02
Odwracalne.
Nic nie jest trwałe. Usuń adres, jeśli wróci do użytku, i wznów wysyłkę do niego.
- 03
Wpisy ręczne.
Dodawaj adresy samodzielnie, na przykład znaną listę nieprawidłowych adresów importowaną od innego dostawcy.
- 04
Dostępne do zapytań przez API.
Wyświetl całą listę, filtruj po adresie lub przyczynie, dodaj wpis lub usuń go po identyfikatorze rekordu, aby Twoje systemy były zsynchronizowane.
- 05
Jedna lista, każda wysyłka.
Suppression obejmuje pocztę transakcyjną i marketingową, więc kampania nie może ponownie wysłać na adres, na którym właśnie odbiło się potwierdzenie.
Domyślnie automatyczne, w pełni pod Twoją kontrolą.
Nie musisz zarządzać listą, aby działała — odbicia i skargi są automatycznie supresjonowane. Gdy jednak zajdzie taka potrzeba, cała lista jest dostępna przez API: dodaj adres, o którym wiesz, że jest nieprawidłowy, filtruj po adresie lub przyczynie albo usuń rekord, aby przywrócić odbiorcę, który odzyskał aktywność. Bird CLI obsługuje odczyt i usuwanie, a agent uzyskuje dostęp do tych samych operacji przez MCP.
# Look up why an address is on the list.
$ bird email suppressions list --email ada@example.com \
| jq -c '.data[] | {id, reason, applies_to}'
{"id":"sup_01krdgeqcxet5s7t44vh8rt9mg","reason":"hard_bounce",
"applies_to":"all"}
# Reinstate one that recovered, by record id.
$ bird email suppressions remove sup_01krdgeqcxet5s7t44vh8rt9mg --yes
Cztery powody, dwa zakresy.
Nie każda wstrzymana wysyłka blokuje każdą wiadomość. Odbiorca, który zrezygnował z subskrypcji marketingowej, nadal otrzyma reset hasła: skargi i rezygnacje obejmują tylko marketing, podczas gdy trwałe odbicia i ręczne wpisy blokują wszystko.
| Powód | Wyzwalane przez | Blokuje |
|---|---|---|
| hard_bounce | trwałe odbicie | cała poczta (transakcyjna + marketingowa) |
| complaint | skargę na spam | tylko marketing |
| unsubscribe | rezygnację z listy lub jednym kliknięciem | tylko marketing |
| manual | Ciebie, przez API lub panel | cała poczta (transakcyjna + marketingowa) |
Zgłęb temat w dokumentacji.
Przeczytaj, jak działa automatyczne i ręczne suppression, w przewodniku po suppression, oraz jak wpisuje się w szerszy obraz, w przewodniku po dostarczalności.
Reszta platformy Email
Jedno API, jeden zestaw kluczy. Poznaj pozostałe funkcje.
Około 40% komercyjnej poczty e-mail na świecie już działa na Bird.
Poczta transakcyjna i marketingowa na infrastrukturze, którą prowadzimy od dekady. Wstrzymywanie wysyłki to jedna z funkcji Email API od Bird: wysyłka, dostarczalność, dedykowane adresy IP i analityka są jego częścią.