Map the source carefully.
Use contact properties for personalization and an audience for membership. Neither audience membership nor an imported email address proves permission for a particular campaign.
Manage contact identity ↗EmailAudiences
Know your audience.
Make the message matter.
Keep contact properties and audience membership ready for the next campaign. Give the team useful context while keeping permission and sending eligibility explicit.
One person. A more useful picture.
Bring contact details and audience membership together so your next campaign reaches the right people. Explore how a customer profile changes as your application learns more.
FICTIONAL CONTACTS
Typed properties.
Rejected: this value is not a number. Correct it and retry the same contact identity. Importing does not grant permission.
The numeric property is updated on the same fictional contact. Audience membership and permission have not changed.
con_alex_example
Alex Lee
- City
- London
- visits_count
- 3
- Source revision
- 12
This contact is outside the Studio audience.
Audience member, but missing marketing permission. Exclude from this sample campaign.
Included in this sample. Other preferences, suppressions and account policy can still exclude the address.
Source revision 12: membership true Duplicate revision 12: unchanged Late revision 11: ignored Contact: con_alex_example
This application-owned revision policy avoids duplicate contacts and late membership reversal. It is an illustrative synchronization design, not a Bird guarantee of source-version enforcement.
Companies that trust Bird across their communications.
Read Bird customer storiesKeep identity, membership and permission distinct.
Build an explicit synchronization.
Decide which system owns additions and removals. Reconcile the complete membership snapshot and preserve restrictions before a broadcast uses that audience.
Synchronize audience membership ↗Un registro de contacto. Atributos que no se desvían.
Un contacto contiene la dirección de email, el número de teléfono y las propiedades de una persona. Una audiencia agrupa esos contactos para una campaña. Añade a alguien a varias audiencias y sus datos se mantienen juntos en un solo registro. Todo forma parte de la plataforma de email de Bird.
Cinco cosas que mantienen tus datos limpios.
El modelo de datos lleva la contabilidad, así que tus listas no se degradan.
Un registro por persona.
Un contacto del espacio de trabajo puede contener una dirección de email, un número de teléfono o ambos, además de nombres, un ID externo y datos personalizados.
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.
Registro de propiedades tipadas.
Define tus campos personalizados de antemano: string, number, boolean o datetime, con valores por defecto opcionales. Las claves desconocidas y los valores con tipo incorrecto se rechazan en el momento de la escritura.
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.
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.
Las importaciones por lotes comparan los identificadores que trae cada entrada y reportan resultados por entrada. Inserta o actualiza hasta 1.000 contactos y asócialos a una audiencia en una sola solicitud. Cuando los identificadores apuntan a contactos distintos, revisa la entrada en conflicto antes de reintentar. Reconcilia las entradas completadas y fallidas al reanudar una importación interrumpida.
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.entry.email, item.status);
}
Synchronize audience membership with CLI or MCP, then list its contacts to check the result. Keep subscription and consent decisions with your contact records.
Consulta las audiencias detrás de tu próxima campaña.
Importa una hoja de cálculo, revisa el mapeo de campos y organiza los contactos en grupos reutilizables. Los nombres y las propiedades tipadas permanecen en el contacto; la membresía determina a qué audiencia pertenecen.
Captura de pantalla del producto con registros de ejemplo. Revisa la membresía de la audiencia y la entregabilidad antes de enviar.
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.
Datos de cliente compartidos
Usa la misma base de contactos en todo tu flujo de mensajería.
Keep an audience in sync
Work through additions, removals and an incomplete refresh before launching a campaign.
Identidad y propiedades del contacto
Inspecciona identificadores, reglas de coincidencia y el registro de cliente detrás de un destinatario.
Selección de audiencia
Conecta reglas de origen, membresía explícita y elegibilidad de canal.
Mantén una cohorte sincronizada
Aplica las altas y bajas del sistema de origen que evalúa tu selección.
Continúa con el flujo que necesitas
Elige el producto o la guía que se ajuste a la siguiente tarea.
Importa una hoja de cálculo
Sube un archivo CSV, TSV o Excel, revisa el mapeo de campos y asigna una audiencia.
Gestiona la membresía
Añade o elimina contactos de una lista reutilizable e inspecciona su recuento de entregables.
Crea la campaña
Usa la audiencia en un envío masivo cuando su contenido y remitente estén listos.
Guías y preguntas frecuentes de email
Conoce el modelo de contactos o encuentra ayuda con el siguiente flujo.
Preguntas sobre contactos y audiencias
¿Dónde se almacenan mis contactos y audiencias?
Los contactos pertenecen a un espacio de trabajo. Un registro puede contener una dirección de correo electrónico, un número de teléfono o ambos, además de un ID externo y propiedades tipadas. Las audiencias hacen referencia a esos registros, así que actualizar un contacto mantiene sus datos consistentes en todas las listas a las que pertenece.
¿Cómo puedo importar una lista?
Sube un archivo CSV, TSV o Excel en el dashboard y revisa el mapeo de campos antes de importar. Puedes asignar contactos a audiencias durante la importación. Para sincronizaciones desde tu aplicación, haz upsert por lotes de hasta 1.000 contactos por solicitud a través de API o CLI.
¿Las audiencias son segmentos dinámicos?
El flujo de audiencias documentado usa membresía estática: tú agregas o eliminas contactos. Un broadcast resuelve la audiencia cuando comienza el envío. Usa tu aplicación o el flujo de importación para mantener la membresía actualizada.
¿Qué tipos de propiedades de contacto se admiten?
Define propiedades de texto, número, booleanas y de fecha/hora con valores de respaldo opcionales. Usa esas propiedades para la personalización del destinatario y mantén los valores tipados consistentes al importar o sincronizar contactos.
Ponlo en práctica.
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Ver la guíaManage your customers: contacts & audiencesSeguir la ruta de aprendizajeBuild your first integration
Obtener un resumen de implementaciónUsa tu audiencia
Campañas
Campañas de marketing: redacta, dirige a una audiencia, programa y envía.
Plantillas
Plantillas de correo almacenadas y versionadas, personalizadas por destinatario en el envío.
Supresiones
Supresiones de destinatarios y preferencias de exclusión verificadas antes del envío.
Visión general de la Email API
La API de Email completa: envío, entregabilidad, IPs, supresión, analítica y broadcasts.
Habla con nuestro equipo de email
Planifica tus contactos y la configuración de audiencias.
Trae tus fuentes de contactos, necesidades de segmentación y requisitos de consentimiento. Te ayudaremos a conectarlos con tus campañas de email.
Crea tu cuenta, luego añade contactos y construye tu primera audiencia.