Zielgruppen & Kontakte
Saubere Listen, direkt eingebaut.
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 is idempotent on the identifiers each entry carries, so re-running an import updates rather than duplicates. Add up to 1,000 contacts and join them to an audience in the same request, with no separate membership step and no de-dupe pass afterward. Larger lists go up in batches of 1,000. Each call is independent, so an interrupted import is safe to resume where it stopped.
// 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.
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.