Speichere deine Kontakte einmal, eindeutig per E-Mail, und gruppiere sie in Zielgruppen, die du aus einem Broadcast ansprichst. Eine typisierte Property-Registry hält deine Daten sauber, und ein Batch-Upsert von 1.000 Zeilen bringt eine Liste schnell rein.
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.
Ein Kontaktdatensatz. Attribute, die nicht abdriften.
Zielgruppen sind Teil der Bird Email API: Ein Kontakt ist eindeutig per E-Mail und wird über deine Zielgruppen hinweg geteilt, eine Zielgruppe ist einfach eine Menge dieser Kontakte, und Attribute leben immer am Kontakt, nicht kopiert auf jede Liste. Die Property-Registry sorgt dafür, dass ein vertipptes Feld beim Schreiben abgelehnt wird, statt erst in einer Kampagne aufzufallen.
Fünf Dinge, die deine Daten sauber halten.
Das Datenmodell übernimmt die Buchführung, damit deine Listen nicht verrotten.
- 01
Ein Datensatz pro Person.
Ein Kontakt pro E-Mail, mit Vor- und Nachname, einer externen ID und deinen eigenen benutzerdefinierten Daten.
- 02
Zielgruppen sind Zugehörigkeit.
Eine Zielgruppe ist eine Menge von Kontakten, die du frei hinzufügst und entfernst. Attribute leben immer am Kontakt, nie kopiert auf die Liste.
- 03
Typisierte Property-Registry.
Definiere deine benutzerdefinierten Felder vorab: string, number oder boolean, mit optionalen Fallbacks. Unbekannte Keys und falsch typisierte Werte werden beim Schreiben abgelehnt.
- 04
Batch-Upsert von bis zu 1.000.
Führe einen Upsert von bis zu 1.000 Kontakten in einem einzigen Aufruf durch und füge sie im selben Request einer Zielgruppe hinzu.
- 05
Exakter Match-Lookup.
Finde einen Kontakt per exaktem E-Mail-Match, damit deine eigenen Systeme synchronisieren können, ohne jeden Datensatz zu durchsuchen.
Bring eine ganze Liste mit einem Aufruf rein.
Upsert ist idempotent auf der E-Mail, sodass ein erneut ausgeführter Import aktualisiert statt dupliziert. Füge bis zu 1.000 Kontakte hinzu und verbinde sie im selben Request mit einer Zielgruppe, ohne separaten Zugehörigkeitsschritt und ohne nachträglichen De-Dupe-Durchlauf. Größere Listen gehen in Batches von 1.000 hoch. Jeder Aufruf ist unabhängig, sodass ein unterbrochener Import sicher dort fortgesetzt werden kann, wo er stehengeblieben ist.
// Upsert up to 1,000 contacts and add them to an audience at once.
await bird.email.contacts.batchUpsert({
audienceId: "aud_2bX91Yk8h",
contacts: [
{ email: "ada@example.com", firstName: "Ada", data: { plan: "growth" } },
{ email: "grace@example.com", firstName: "Grace", data: { plan: "free" } },
],
});Felder, die nicht abdriften können.
Benutzerdefinierte Kontaktdaten laufen durch eine typisierte Registry. Deklariere jedes Feld einmal als string, number oder boolean, mit einem optionalen Fallback, und ein vertippter Key oder falsch typisierter Wert wird in dem Moment abgelehnt, in dem du ihn schreibst, statt mitten in einer Kampagne aufzufallen. Weil Attribute am Kontakt leben, nicht an der Liste, hinterlässt das Verschieben einer Person zwischen Zielgruppen nie eine veraltete Kopie.
FAQ zu Zielgruppen & Kontakten
Sind Kontakte pro Zielgruppe oder global?+
Was ist die Property-Registry?+
Wie importiere ich eine Liste?+
Wie hängen Zielgruppen mit Broadcasts zusammen?+
Der Rest der Email-Plattform
Eine API, ein Satz Keys. Entdecke die weiteren Funktionen.
Rund 40 % der kommerziellen E-Mails weltweit laufen bereits über Bird.
Transaktionale und Marketing-E-Mails auf einer Infrastruktur, die wir seit einem Jahrzehnt betreiben. Zielgruppen sind eine Funktion der Bird Email API: Senden, Broadcasts, Zustellbarkeit, Suppression und Analytics sind direkt mit dabei.