Memorizza i tuoi contatti una sola volta, univoci per email, e raggruppali in audience che puoi targettizzare da un broadcast. Un registro tipizzato delle proprietà mantiene puliti i tuoi dati, e un upsert in batch da 1.000 righe carica velocemente una lista.
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.
Un solo record contatto. Attributi che non vanno alla deriva.
Le audience fanno parte della Bird Email API: un contatto è univoco per email e condiviso tra le tue audience, un'audience è semplicemente un insieme di quei contatti e gli attributi vivono sempre sul contatto, non copiati su ogni lista. Il registro delle proprietà fa sì che un campo con errore di battitura venga rifiutato al momento della scrittura, non scoperto durante una campagna.
Cinque cose che mantengono puliti i tuoi dati.
È il modello dati a fare la contabilità, così le tue liste non si deteriorano.
- 01
Un record per persona.
Un contatto per email, con nome e cognome, un ID esterno e i tuoi dati personalizzati.
- 02
Le audience sono appartenenza.
Un'audience è un insieme di contatti che aggiungi e rimuovi liberamente. Gli attributi vivono sempre sul contatto, mai copiati sulla lista.
- 03
Registro di proprietà tipizzato.
Definisci i tuoi campi personalizzati in anticipo: string, number o boolean, con fallback opzionali. Le chiavi sconosciute e i valori con tipo errato vengono rifiutati al momento della scrittura.
- 04
Upsert in batch fino a 1.000.
Esegui l'upsert fino a 1.000 contatti in una sola chiamata e uniscili a un'audience nella stessa richiesta.
- 05
Ricerca per corrispondenza esatta.
Trova un contatto tramite corrispondenza esatta dell'email, così i tuoi sistemi possono sincronizzarsi senza scansionare ogni record.
Inserisci un'intera lista con una sola chiamata.
L'upsert è idempotente sull'email, quindi rieseguire un'importazione aggiorna anziché duplicare. Aggiungi fino a 1.000 contatti e uniscili a un'audience nella stessa richiesta, senza un passaggio separato di membership e senza una passata di de-dupe successiva. Le liste più grandi vengono caricate in batch da 1.000. Ogni chiamata è indipendente, quindi un'importazione interrotta può riprendere in sicurezza dal punto in cui si è fermata.
// 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" } },
],
});Campi che non possono andare alla deriva.
I dati personalizzati dei contatti passano attraverso un registro tipizzato. Dichiara ogni campo una sola volta come string, number o boolean, con un fallback opzionale, e una chiave con errore di battitura o un valore con tipo errato viene rifiutato nel momento in cui lo scrivi, non scoperto a metà di una campagna. Poiché gli attributi vivono sul contatto, non sulla lista, spostare qualcuno tra le audience non lascia mai dietro una copia obsoleta.
FAQ su audience e contatti
I contatti sono per audience o globali?+
Cos'è il registro di proprietà?+
Come importo una lista?+
Come si relazionano le audience ai broadcast?+
Il resto della piattaforma Email
Un'API, un solo set di chiavi. Esplora le altre funzionalità.
Circa il 40% delle email commerciali del mondo gira già su Bird.
Email transazionali e marketing su un'infrastruttura che gestiamo da un decennio. Le audience sono una delle funzionalità della Bird Email API: invio, broadcast, deliverability, soppressione e analytics sono inclusi.