Audiencias y contactos

Listas limpias, integradas.

Configúralo en:

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

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.

01
Un registro por persona.
Un contacto por email, con nombre y apellido, un ID externo y tus propios datos personalizados.
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.
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.
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.
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.

El upsert es idempotente por email, así que volver a ejecutar una importación actualiza en lugar de duplicar. Agrega hasta 1.000 contactos y únelos a una audiencia en la misma petición, sin un paso de membresía aparte y sin una pasada de deduplicación posterior. Las listas más grandes se cargan en lotes de 1.000. Cada llamada es independiente, así que una importación interrumpida se puede reanudar con seguridad desde donde se detuvo.

import.ts

202

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

Preguntas frecuentes sobre audiencias y contactos

¿Los contactos son por audiencia o globales?+

Global. Un contacto es único por email, y las audiencias solo lo referencian. Mueve un contacto entre audiencias y sus atributos lo siguen, porque viven en el contacto, no en la lista.

¿Qué es el registro de propiedades?+

Un esquema cerrado y tipado para tus campos personalizados de contacto. Declaras de antemano el tipo de cada campo (cadena, número o booleano) con un valor de reserva opcional; las claves desconocidas o los valores con tipo erróneo se rechazan al escribirlos, de modo que tus datos se mantienen limpios.

¿Cómo importo una lista?+

Haz upsert por lotes de hasta 1.000 contactos en una sola llamada y únelos a una audiencia en la misma petición, sin un paso de adición aparte. El upsert es idempotente por email, así que volver a ejecutar una importación actualiza en lugar de duplicar.

¿Cómo se relacionan las audiencias con las campañas?+

Una campaña segmenta una sola audiencia. Construye y mantén la audiencia aquí; referénciala por ID cuando envíes.

El resto de la plataforma de Email

Una API, un único juego de claves. Explora las demás capacidades.

EnvíoEmail transaccional y de marketing, plantillas y envíos por lotes.CampañasCampañas de marketing: redacta, dirige a una audiencia, programa y envía.EntregabilidadAutenticación, calentamiento de IP, supresión y monitorización de blocklist.AnalíticasMétricas de entrega e interacción por dominio, por ISP y por IP.IP dedicadasIP dedicadas y pools gestionados, calentados automáticamente.Dominios de envíoVerificación de dominio, firma DKIM/SPF/DMARC y monitorización de DMARC.SupresionesSupresión automática y reversible de rebotes, quejas y bajas.Visión general de la Email APILa API de Email completa: envío, entregabilidad, IPs, supresión, analítica y broadcasts.

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.

Explora la plataforma de Email Empezar