Stockez vos contacts une seule fois, uniques par e-mail, et regroupez-les en audiences que vous ciblez depuis un broadcast. Un registre de propriétés typées garde vos données propres, et un upsert par lots de 1 000 lignes injecte une liste rapidement.
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 seul enregistrement de contact. Des attributs qui ne dérivent pas.
Les audiences font partie de l<hub>API Email Bird</hub> : un contact est unique par e-mail et partagé entre vos audiences, une audience nest qu'un ensemble de ces contacts, et les attributs restent toujours sur le contact, sans être copiés sur chaque liste. Grâce au registre de propriétés, un champ mal orthographié est rejeté à l'écriture, et non découvert en pleine campagne.
Cinq choses qui gardent vos données propres.
Le modèle de données s'occupe de la tenue des comptes, pour que vos listes ne se dégradent pas.
- 01
Un enregistrement par personne.
Un contact par e-mail, avec prénom et nom, un ID externe et vos propres données personnalisées.
- 02
Les audiences, c'est l'appartenance.
Une audience est un ensemble de contacts que vous ajoutez et retirez librement. Les attributs restent toujours sur le contact, jamais copiés sur la liste.
- 03
Registre de propriétés typées.
Définissez vos champs personnalisés en amont : string, number ou boolean, avec des valeurs de repli optionnelles. Les clés inconnues et les valeurs au mauvais type sont rejetées à l'écriture.
- 04
Upsert par lot jusqu'à 1 000.
Faites un upsert de jusqu'à 1 000 contacts en un seul appel, et rattachez-les à une audience dans la même requête.
- 05
Recherche par correspondance exacte.
Trouvez un contact par correspondance exacte d'e-mail, pour que vos propres systèmes puissent se synchroniser sans parcourir chaque enregistrement.
Intégrez une liste entière en un seul appel.
L'upsert est idempotent sur l'e-mail : relancer un import met à jour au lieu de dupliquer. Ajoutez jusqu'à 1 000 contacts et rattachez-les à une audience dans la même requête, sans étape d'appartenance distincte ni passe de déduplication après coup. Les listes plus grandes se chargent par lots de 1 000. Chaque appel est indépendant, donc un import interrompu peut reprendre sans risque là où il s'est arrêté.
// 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" } },
],
});Des champs qui ne peuvent pas dériver.
Les données de contact personnalisées passent par un registre typé. Déclarez chaque champ une fois en string, number ou boolean, avec une valeur de repli optionnelle, et une clé mal orthographiée ou une valeur au mauvais type est rejetée dès l'écriture, et non découverte à mi-chemin d'une campagne. Comme les attributs vivent sur le contact, pas sur la liste, déplacer quelqu'un entre audiences ne laisse jamais de copie périmée.
Fonctionne avec le reste d'Email.
products/email/audiences.Ow9XH5
FAQ sur les audiences et contacts
Les contacts sont-ils propres à chaque audience ou globaux ?+
Qu'est-ce que le registre de propriétés ?+
Comment importer une liste ?+
Quel est le lien entre les audiences et les diffusions ?+
Le reste de la plateforme Email
Une seule API, un seul jeu de clés. Explorez les autres capacités.
Près de 40% des e-mails commerciaux dans le monde tournent déjà sur Bird.
E-mail transactionnel et marketing sur une infrastructure que nous exploitons depuis dix ans. Les audiences sont l'une des capacités de l'API Email Bird : envoi, broadcasts, délivrabilité, suppression et analytics sont livrés avec.