Audiencias y contactos

Listas limpias, integradas.

Configúralo en:
Cursor

Almacena tus contactos una sola vez, únicos por email, y agrúpalos en audiencias a las que diriges un broadcast. Un registro de propiedades tipadas mantiene tus datos limpios, y un upsert por lotes de 1.000 filas carga una lista rápido.

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

Un registro de contacto. Atributos que no se desvían.

Las audiencias forman parte de la API de Email de Bird: un contacto es único por email y se comparte entre tus audiencias, una audiencia no es más que un conjunto de esos contactos, y los atributos siempre viven en el contacto, no se copian en cada lista. El registro de propiedades hace que un campo con error tipográfico se rechace al escribir, en lugar de descubrirlo en una campaña.

Cinco cosas que mantienen tus datos limpios.

El modelo de datos lleva la contabilidad, así que tus listas no se degradan.

  1. 01

    Un registro por persona.

    Un contacto por email, con nombre y apellido, un ID externo y tus propios datos personalizados.

  2. 02

    Las audiencias son pertenencia.

    Una audiencia es un conjunto de contactos que agregas y quitas libremente. Los atributos siempre viven en el contacto, nunca se copian en la lista.

  3. 03

    Registro de propiedades tipadas.

    Define tus campos personalizados de antemano: string, number o boolean, con fallbacks opcionales. Las claves desconocidas y los valores con tipo incorrecto se rechazan al escribir.

  4. 04

    Upsert por lotes de hasta 1.000.

    Haz upsert de hasta 1.000 contactos en una sola llamada y únelos a una audiencia en la misma petición.

  5. 05

    Búsqueda por coincidencia exacta.

    Encuentra un contacto por coincidencia exacta de email, para que tus propios sistemas puedan sincronizar sin recorrer cada registro.

Incorpora una lista entera con una sola llamada.

Upsert es idempotente sobre los identificadores que lleva cada entrada, por lo que volver a ejecutar una importación actualiza en lugar de duplicar. Añade hasta 1000 contactos y únelos a una audiencia en la misma solicitud, sin un paso de membresía separado ni un proceso de deduplicación posterior. Las listas más grandes se envían en lotes de 1000. Cada llamada es independiente, por lo que una importación interrumpida se puede reanudar de forma segura desde donde se detuvo.

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);
}

Campos que no se desvían.

Los datos personalizados de contacto pasan por un registro tipado. Declara cada campo una vez como string, number o boolean, con un fallback opcional, y una clave con error tipográfico o un valor con tipo incorrecto se rechaza en el momento en que lo escribes, no a mitad de una campaña. Como los atributos viven en el contacto, no en la lista, mover a alguien entre audiencias nunca deja una copia obsoleta detrás.

Funciona con el resto de Email.

Segmenta las audiencias que construyes aquí desde una campaña, y los mismos contactos reciben correo transaccional a través de la API de envío.

Cerca del 40% del email comercial del mundo ya funciona sobre Bird.

Email transaccional y de marketing sobre una infraestructura que llevamos una década operando. Las audiencias son una de las capacidades de la API de Email de Bird: el envío, los broadcasts, la entregabilidad, la supresión y la analítica vienen incluidos.

Empieza con un canal.
Añade los demás cuando estés listo.

Una clave API de prueba es tuya de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

¿Usas Claude Code, Cursor o Codex? Copia un prompt de configuración y tu agente instalará el Bird CLI y las habilidades por ti. Elige el tuyo:

Cursor