# Sincronizar los miembros de una audiencia

Usa tu almacén de datos, CRM o aplicación para decidir quién pertenece a una cohorte y aplica esa selección a una audiencia de Bird. La API publicada de audiencias almacena una pertenencia estática. Este patrón de integración la mantiene alineada con el sistema de origen que evalúa tus condiciones, sin inventar un segundo conjunto de reglas en el flujo de envío.

## Antes de empezar

Necesitas una audiencia de Bird con nombre, los registros de contacto correspondientes y acceso a las operaciones de audiencias documentadas. Define qué sistema de origen controla la selección y quién puede cambiar sus condiciones. Usa una cohorte de prueba pequeña antes de ejecutar la integración sobre una audiencia de campaña.

Anota las condiciones de inclusión, las exclusiones y el momento de evaluación. Para una cohorte de clientes que renuevan la próxima semana, especifica la zona horaria y qué ocurre cuando el sistema de origen registra una renovación completada. La selección debe poder reproducirse con suficiente precisión para investigar la presencia de un miembro inesperado.

## Resolver los registros seleccionados

1. Obtén el resultado del sistema de origen y registra en tu integración su momento de evaluación o su revisión.
2. Crea o actualiza los contactos correspondientes en Bird con la [operación de contactos por lotes](/docs/api/reference/create-contact-batch). Elige de forma deliberada cómo usar el identificador de origen para buscar coincidencias.
3. Revisa el resultado de cada entrada. Conserva su ID de origen y el ID de contacto resultante de Bird en el registro de conciliación de la integración.
4. Resuelve los conflictos de identificadores antes de considerar sincronizada a esa persona. Una solicitud con entradas procesadas correctamente también puede contener entradas fallidas.

El lote de contactos acepta `audience_ids` al añadir registros a audiencias conocidas. Úsalo para las incorporaciones cuando corresponda; las retiradas siguen requiriendo una decisión independiente sobre la pertenencia. Que una importación omita a una persona no es una instrucción para retirarla de una audiencia ni eliminarla.

## Conciliar incorporaciones y retiradas

Consulta los miembros existentes con [Listar los contactos de una audiencia](/docs/api/reference/list-audience-contacts) y recorre todas sus páginas. Compara los ID de contacto de Bird con la selección de origen ya resuelta.

| Diferencia                                         | Acción                                                           |
| -------------------------------------------------- | ---------------------------------------------------------------- |
| Seleccionado en el origen, ausente en la audiencia | Añade el contacto a la audiencia                                 |
| Presente en la audiencia, ausente en el origen     | Retira al miembro si el sistema de origen controla esa audiencia |
| Presente en ambos                                  | Mantén la pertenencia                                            |
| No se ha podido resolver el registro de origen     | Investiga antes de completar la actualización                    |

Aplica los cambios mediante [Añadir contactos a una audiencia](/docs/api/reference/assign-audience-contacts) y [Retirar contactos de una audiencia](/docs/api/reference/unassign-audience-contacts). Respeta los límites de lote vigentes que figuran en esas referencias.

No retires a nadie solo porque una exportación del sistema de origen esté incompleta. Antes de calcular las retiradas, confirma que tienes la selección de origen completa, incluida su última página. Evita también combinar una audiencia gestionada por una integración con cambios manuales de miembros ajenos a ella, salvo que tengas una política explícita para conservarlos.

## Completar la actualización

Tras aplicar las diferencias, revisa las operaciones fallidas y vuelve a consultar los miembros afectados. Marca la actualización como completada cuando la pertenencia coincida con la selección de origen prevista. Guarda el resultado en tu integración para que la siguiente ejecución pueda distinguir una actualización terminada de una interrumpida.

Si el proceso se detiene a mitad, reanúdalo a partir del trabajo registrado o vuelve a calcular la diferencia respecto a la audiencia actual. Añadir un miembro existente deja intacta su pertenencia; retirar a un miembro cambia la pertenencia a esa audiencia, no el registro de contacto ni el consentimiento.

Vuelve a comprobar la idempotencia y la especificación de respuesta vigentes de la operación antes de repetir automáticamente una solicitud cuyo resultado sea incierto. Trata la aceptación de la solicitud, los resultados de cada entrada y la conciliación final como observaciones distintas.

## Conectar la audiencia con el envío

Usa la selección completada en el flujo de campaña correspondiente. Registra cuándo se actualizó la audiencia por última vez y revisa la estimación actual de la difusión antes de enviarla. Los datos de contacto, las preferencias y las supresiones pueden cambiar después de actualizar los miembros.

En una difusión de Email, la estimación se reduce desde el total de miembros hasta los miembros con dirección y aquellos a los que se puede enviar. El resultado final de la entrega es una observación independiente. Mantén juntos la cohorte de origen, el contexto de envío y la definición del resultado de negocio al analizar los resultados.

## Solución de problemas

- **Retiradas inesperadas:** comprueba si la exportación de origen está incompleta o si otro proceso o usuario está modificando la misma audiencia.
- **El mismo contacto fallido reaparece en cada ejecución:** resuelve el conflicto del identificador de origen o la propiedad no válida, en lugar de omitirlo indefinidamente sin avisar.
- **Las personas permanecen después de salir del segmento:** verifica que tu integración aplica tanto las retiradas como las incorporaciones.
- **El número de miembros a los que se puede enviar es menor:** revisa las direcciones, las preferencias y las supresiones en lugar de volver a añadir personas.

## Siguientes pasos

- [Miembros y recuentos de una audiencia](/docs/guides/email/audiences)
- [Resultados de importación y coincidencias de contactos](/docs/guides/email/contacts)
- [Guía de producto para la selección de audiencias](/data/segmentation)

## Related resources

- [Getting started with email](/learn/email/getting-started-with-email) (video)
- [Email](/products/email) (product)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=email)