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 nos identificadores que cada entrada contém, por isso reexecutar uma importação atualiza em vez de duplicar. Adicione até 1.000 contactos e associe-os a uma audiência no mesmo pedido, sem um passo separado de associação nem uma passagem de deduplicação posterior. Listas maiores são enviadas em lotes de 1.000. Cada chamada é independente, por isso uma importação interrompida pode ser retomada com segurança a partir do ponto onde parou.
// 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);
}
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.
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.