Doelgroepen & contacten

Schone lijsten, ingebouwd.

Geïntegreerd in:

Sla je contacten ��n keer op, uniek per e-mailadres, en groepeer ze in audiences die je vanuit een broadcast target. Een getypeerd property-register houdt je data schoon, en een batch-upsert van 1.000 rijen zet een lijst er snel in.

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..."

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..."

Eén contactrecord. Attributen die niet afdrijven.

Audiences zijn onderdeel van de Bird Email API: een contact is uniek per e-mailadres en wordt gedeeld over je audiences, een audience is gewoon een set van die contacten, en attributen staan altijd op het contact, niet gekopieerd op elke lijst. Het property-register betekent dat een verkeerd getypt veld bij het schrijven wordt geweigerd, niet pas in een campagne ontdekt.

Vijf dingen die je data schoon houden.

Het datamodel doet de boekhouding, zodat je lijsten niet verrotten.

01
E�n record per persoon.
E�n contact per e-mailadres, met voor- en achternaam, een externe ID en je eigen custom data.
02
Doelgroepen zijn lidmaatschap.
Een audience is een set contacten die je vrij toevoegt en verwijdert. Attributen staan altijd op het contact, nooit gekopieerd op de lijst.
03
Getypeerd property-register.
Definieer je custom velden vooraf: string, number of boolean, met optionele fallbacks. Onbekende keys en verkeerd getypeerde waarden worden bij het schrijven geweigerd.
04
Batch-upsert tot 1.000.
Upsert maximaal 1.000 contacten in ��n call en koppel ze in dezelfde request aan een audience.
05
Exacte-match-opzoeking.
Vind een contact via een exacte e-mailmatch, zodat je eigen systemen kunnen synchroniseren zonder elk record te scannen.

Voeg een hele lijst toe met één call.

Upsert is idempotent op de identifiers die elk item bevat, dus het opnieuw uitvoeren van een import werkt bij in plaats van te dupliceren. Voeg tot 1.000 contacten toe en koppel ze in hetzelfde verzoek aan een doelgroep — zonder aparte lidmaatschapsstap en zonder deduplicatie achteraf. Grotere lijsten worden in batches van 1.000 verwerkt. Elke aanroep is onafhankelijk, dus een onderbroken import kan veilig worden hervat waar deze stopte.

import.ts

202

// Upsert up to 1,000 contacts and add them to an audience at once.
const result = await bird.contacts.batch({
  audience_ids: ["adn_01krdgeqcxet5s7t44vh8rt9mg"],
  contacts: [
    { email: "ada@example.com",   first_name: "Ada",   data: { plan: "growth" } },
    { email: "grace@example.com", first_name: "Grace", data: { plan: "free" } },
  ],
});

// Per-contact results come back in submission order.
for (const item of result.data) {
  console.log(item.email, item.status);
}

Velden die niet kunnen afdrijven.

Custom contactdata loopt via een getypeerd register. Declareer elk veld ��n keer als string, number of boolean, met een optionele fallback, en een verkeerd getypte key of verkeerd getypeerde waarde wordt geweigerd op het moment dat je hem schrijft, niet halverwege een campagne ontdekt. Omdat attributen op het contact staan en niet op de lijst, laat het verplaatsen van iemand tussen audiences nooit een verouderde kopie achter.

Werkt samen met de rest van Email.

Target de doelgroepen die je hier bouwt vanuit een broadcast, en dezelfde contacten ontvangen transactionele mail via de verzend-API.

De rest van het Email-platform

Één API, één set keys. Verken de andere mogelijkheden.

VerzendenTransactionele en marketing-e-mail, templates en batchverzendingen.SjablonenOpgeslagen, geversioneerde e-mailsjablonen, per ontvanger gepersonaliseerd bij verzending.BroadcastsMarketingcampagnes: opstellen, een audience targeten, inplannen en versturen.BezorgbaarheidAuthenticatie, IP-warmup, suppressie en blocklist-monitoring.AnalyticsBezorg- en engagementstatistieken per domein, per ISP en per IP.Dedicated IP'sBeheerde dedicated IP's en pools, automatisch opgewarmd.VerzenddomeinenDomeinverificatie, DKIM/SPF/DMARC-ondertekening en DMARC-monitoring.SuppressiesAutomatische, omkeerbare suppressie van bounces, klachten en uitschrijvingen.Email API-overzichtDe volledige Email API: verzenden, deliverability, IP's, suppression, analytics en broadcasts.

Ongeveer 40% van alle commerciële e-mail ter wereld draait al op Bird.

Transactionele en marketing-e-mail op infrastructuur die we al tien jaar draaien. Audiences zijn ��n van de mogelijkheden van de Bird Email API: verzenden, broadcasts, deliverability, suppression en analytics horen er standaard bij.

Verken het Email-platform Aan de slag