Documentación
Sign inGet started
Comenzar
Guías
Referencia de API
SDKs
CLI
Base de conocimientos
Registro de cambios

Audiencias

Una audiencia es una lista de contactos con nombre. Créala una vez y reutilízala: para volver a dirigirte al mismo grupo, basta con indicar la lista en lugar de reunir las direcciones. Un contacto puede pertenecer a varias audiencias, y tú añades o retiras miembros a medida que las personas se incorporan o salen.
Gestiona las audiencias en Contactos > Audiencias en el panel de control, con bird audiences desde el terminal, mediante la API de audiencias o con cualquiera de los SDK.

La página Audiencias

La página Audiencias muestra tus audiencias por nombre, fecha de creación y tipo. El tipo indica Estática para una lista cuyos miembros añades y retiras tú. Para ver la página necesitas permiso de lectura de email_marketing, y para crear o editar una audiencia necesitas permiso de escritura.
La página Audiencias del panel de control, con un campo de búsqueda por nombre, un botón Añadir audiencia y tres filas de audiencias estáticas con sus descripciones y fechas de creación
Para crear una, introduce un nombre y, si quieres, una descripción de quién forma parte de ella. Después, abre la audiencia para gestionar sus miembros.

Miembros

Abre una audiencia para ver sus miembros, empezando por los añadidos más recientemente. Cada fila muestra:
  • El nombre y la dirección de correo electrónico del contacto.
  • Las etiquetas Email o SMS, derivadas de los identificadores almacenados del contacto. No demuestran que sea posible contactar con él ni que exista permiso para hacerlo.
  • Todas las audiencias a las que pertenece el contacto, incluida esta.
  • Cuándo se incorporó el contacto a esta audiencia.
Busca en la lista por dirección de correo electrónico y selecciona una fila para abrir el contacto.
El resumen de la audiencia tiene dos tarjetas. Miembros cuenta a todas las personas de la audiencia. Email cuenta los contactos con una dirección e indica una estimación de cuántos pueden recibir envíos tras aplicar las preferencias y supresiones correspondientes. La estimación puede cambiar antes de que se ejecute una difusión y no garantiza la entrega.
La audiencia Suscriptores del boletín con las tarjetas de resumen Miembros y Email, ambas con el valor 10, seguidas de una tabla con los nombres de los contactos, canales, audiencias y fechas de incorporación
Añade personas de una de estas dos formas:
  • Pega direcciones de correo electrónico en la audiencia, una por línea, hasta 1.000 cada vez. Buscamos un contacto existente que coincida con cada dirección, o creamos uno si no hay coincidencias, y los añadimos todos a la audiencia en un solo paso.
  • Asigna durante la importación añadiendo los contactos a audiencias al importarlos o crearlos o actualizarlos mediante upsert. El endpoint de procesamiento por lotes y bird contacts batch aceptan una lista audience_ids, con hasta 10 audiencias por solicitud, junto con los contactos. Todas las audiencias que indiques deben existir; de lo contrario, falla toda la solicitud y no se escribe nada.
La adición es idempotente: un contacto que ya es miembro permanece en la audiencia y conserva su fecha de incorporación original. Retirar a un miembro no registra una cancelación de suscripción. Las preferencias y las supresiones siguen siendo independientes. Retirar a un miembro solo saca al contacto de esa audiencia: el contacto permanece en tu espacio de trabajo y en todas las demás audiencias a las que pertenece. Retira a un miembro desde su fila o selecciona varios y retíralos juntos.
Desde la CLI, usa bird audiences add-contacts <audience-id> para añadir contactos y bird audiences remove-contacts <audience-id> para retirarlos. Ambos comandos aceptan ID de contactos, por lo que debes conocer el ID de cada contacto que quieras añadir o retirar. Si solo tienes una lista de direcciones de correo electrónico, usa bird contacts batch con audience_ids. Ese comando busca cada dirección, crea un contacto para las direcciones que no reconoce y los añade todos a la audiencia en una sola llamada.

Mantener actualizada una cohorte seleccionada

La API pública de audiencias utiliza una pertenencia estática y explícita. Si un CRM o un almacén de datos evalúa una cohorte basada en reglas, sincroniza tanto las incorporaciones como las retiradas y registra la última actualización completada. Sigue la guía Sincronizar los miembros de una audiencia. Actualizar solo las propiedades de un contacto no vuelve a evaluar una audiencia estática.

Enviar a una audiencia

Enviar un mensaje a toda una audiencia es una difusión. Elige la audiencia y, cuando comience el envío, generaremos la lista de destinatarios a partir de sus miembros. Así, la difusión se dirige a quienes pertenecen a la audiencia en ese momento. Las difusiones se ejecutan desde el panel de control, la API o los comandos bird email broadcasts.
Si tienes una lista de destinatarios para un envío puntual que no merece la pena guardar como audiencia, envía un lote.

Siguientes pasos

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Explorar la funcionalidadContacts and audiencesSeguir la ruta de aprendizajeBuild your first integration
Obtener un resumen de implementación