# Sincronizar os membros de um público

Use seu data warehouse, CRM ou aplicativo para decidir quem faz parte de uma coorte e aplique essa seleção a um público da Bird. A API publicada de públicos armazena participação estática. Esse padrão de integração mantém a participação alinhada com a origem que avalia suas condições, sem inventar um segundo conjunto de regras no fluxo de envio.

## Antes de começar

Você precisa de um público da Bird com um nome, dos registros de contato correspondentes e de acesso às operações de públicos documentadas. Defina qual sistema de origem controla a seleção e quem pode alterar suas condições. Use uma pequena coorte de teste antes de executar a integração em um público de campanha.

Anote as condições de inclusão, as exclusões e o horário da avaliação. Para uma coorte de clientes que renovam na próxima semana, especifique o fuso horário e o que acontece quando a origem registra uma renovação concluída. A seleção deve ser reproduzível o suficiente para investigar um membro inesperado.

## Resolver os registros selecionados

1. Obtenha o resultado da origem e registre na integração o horário da avaliação ou a revisão.
2. Crie ou atualize os contatos correspondentes na Bird com a [operação de contatos em lote](/docs/api/reference/create-contact-batch). Escolha deliberadamente como usar o identificador de origem para encontrar a correspondência.
3. Inspecione o resultado de cada entrada. Mantenha o ID de origem e o ID de contato resultante da Bird no registro de reconciliação da integração.
4. Resolva conflitos de identificadores antes de considerar a pessoa sincronizada. Uma solicitação com entradas bem-sucedidas também pode conter entradas com falha.

O lote de contatos aceita `audience_ids` ao adicionar registros a públicos conhecidos. Use esse campo nas adições quando for adequado; as remoções ainda exigem uma decisão separada sobre a participação. Uma importação que omite uma pessoa não é uma instrução para removê-la de um público nem para excluí-la.

## Reconciliar adições e remoções

Consulte os membros existentes com [Listar os contatos de um público](/docs/api/reference/list-audience-contacts) e percorra todas as páginas. Compare os IDs de contato da Bird com a seleção de origem resolvida.

| Diferença                                      | Ação                                                    |
| ---------------------------------------------- | ------------------------------------------------------- |
| Selecionado na origem, ausente no público      | Adicione o contato ao público                           |
| Presente no público, ausente na origem         | Remova a participação se a origem controla esse público |
| Presente em ambos                              | Mantenha a participação                                 |
| Não foi possível resolver o registro de origem | Investigue antes de concluir a atualização              |

Aplique as alterações por meio de [Adicionar contatos a um público](/docs/api/reference/assign-audience-contacts) e [Remover contatos de um público](/docs/api/reference/unassign-audience-contacts). Respeite os limites de lote atuais dessas referências.

Não remova alguém apenas porque uma exportação da origem estava incompleta. Confirme que você tem a seleção de origem completa, incluindo a última página, antes de calcular as remoções. Evite também combinar um público gerenciado pela integração com edições manuais independentes de membros, a menos que exista uma política explícita para preservá-las.

## Concluir a atualização

Depois de aplicar as diferenças, inspecione as operações com falha e consulte novamente os membros afetados. Marque a atualização como concluída quando a participação corresponder à seleção de origem pretendida. Armazene o resultado na integração para que a próxima execução diferencie uma atualização concluída de uma interrompida.

Se o processo parar no meio, retome a partir do trabalho registrado ou recalcule a diferença em relação ao público atual. Adicionar um membro existente mantém a participação intacta; remover um membro altera a participação naquele público, não o registro do contato nem o consentimento.

Verifique novamente a idempotência e a especificação de resposta atuais da operação antes de repetir automaticamente uma solicitação cujo resultado é incerto. Trate a aceitação da solicitação, os resultados de cada entrada e a reconciliação final como observações distintas.

## Conectar o público ao envio

Use a seleção concluída no fluxo de campanha pertinente. Registre quando o público foi atualizado pela última vez e inspecione a estimativa atual da transmissão antes do envio. Dados de contato, preferências e supressões podem mudar após a atualização dos membros.

Em uma transmissão de Email, a estimativa parte do total de membros e se restringe aos membros com endereço e aos que podem receber envios. O resultado final da entrega é uma observação separada. Ao analisar os resultados, mantenha juntos a coorte de origem, o contexto do envio e a definição do resultado de negócio.

## Solução de problemas

- **Remoções inesperadas:** verifique se a exportação da origem está incompleta ou se outro processo ou usuário está alterando o mesmo público.
- **O mesmo contato com falha reaparece a cada execução:** resolva o conflito do identificador de origem ou a propriedade inválida em vez de ignorar o contato indefinidamente sem avisar.
- **As pessoas permanecem depois de sair do segmento:** verifique se sua integração aplica remoções além de adições.
- **A contagem de membros que podem receber envios é menor:** inspecione endereços, preferências e supressões em vez de adicionar as pessoas novamente.

## Próximos passos

- [Membros e contagens de um público](/docs/guides/email/audiences)
- [Resultados da importação e correspondência de contatos](/docs/guides/email/contacts)
- [Guia do produto para seleção de públicos](/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)