Armazene seus contatos uma única vez, únicos por email, e agrupe-os em audiences que você segmenta a partir de um broadcast. Um registro de propriedades tipado mantém seus dados limpos, e um upsert em lote de 1.000 linhas insere uma lista rapidamente.
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.
Um registro de contato. Atributos que não se desviam.
As audiences fazem parte da Bird Email API: um contato é único por email e compartilhado entre suas audiences, uma audience é apenas um conjunto desses contatos, e os atributos sempre vivem no contato, em vez de serem copiados para cada lista. O registro de propriedades significa que um campo com erro de digitação é rejeitado no momento da escrita, não descoberto durante uma campanha.
Cinco coisas que mantêm os seus dados limpos.
O modelo de dados faz a contabilidade, então suas listas não apodrecem.
- 01
Um registro por pessoa.
Um contato por email, com nome e sobrenome, um ID externo e seus próprios dados personalizados.
- 02
Audiências são participação.
Uma audience é um conjunto de contatos que você adiciona e remove livremente. Os atributos sempre vivem no contato, nunca copiados para a lista.
- 03
Registro de propriedades tipadas.
Defina seus campos personalizados antecipadamente: string, number ou boolean, com fallbacks opcionais. Chaves desconhecidas e valores com tipo errado são rejeitados no momento da escrita.
- 04
Upsert em lote de até 1.000.
Faça upsert de até 1.000 contatos em uma única chamada e associe-os a uma audience na mesma requisição.
- 05
Busca por correspondência exata.
Encontre um contato por correspondência exata de email, para que seus próprios sistemas possam sincronizar sem varrer todos os registros.
Insira uma lista inteira com uma única chamada.
O upsert é idempotente por email, então re-executar uma importação atualiza em vez de duplicar. Adicione até 1.000 contatos e associe-os a uma audience na mesma requisição, sem passo de associação separado e sem passagem de de-dupe depois. Listas maiores entram em lotes de 1.000. Cada chamada é independente, então uma importação interrompida é segura para retomar de onde parou.
// 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" } },
],
});Campos que não podem se desviar.
Os dados personalizados de contato passam por um registro tipado. Declare cada campo uma vez como string, number ou boolean, com um fallback opcional, e uma chave com erro de digitação ou um valor com tipo errado é rejeitado no momento em que você o escreve, não descoberto no meio de uma campanha. Como os atributos vivem no contato, não na lista, mover alguém entre audiences nunca deixa uma cópia obsoleta para trás.
Perguntas frequentes sobre audiências e contatos
Os contatos são por audiência ou globais?+
O que é o registro de propriedades?+
Como importo uma lista?+
Como as audiências se relacionam com os broadcasts?+
O resto da plataforma de Email
Uma API, um conjunto de chaves. Explore os outros recursos.
Cerca de 40% de todo o email comercial do mundo já roda na Bird.
Email transacional e de marketing em infraestrutura que operamos há uma década. As audiences são uma das capacidades da Bird Email API: envio, broadcasts, deliverability, supressão e analytics vêm junto.