Documentação
Sign inGet started
Começar
Guias
Referência de API
SDKs
CLI
Base de conhecimento
Changelog

Públicos

Um público é uma lista de contatos com um nome. Crie uma vez e reutilize: para alcançar o mesmo grupo novamente, basta indicar a lista em vez de reunir os endereços. Um contato pode pertencer a vários públicos, e você adiciona ou remove membros conforme as pessoas entram e saem.
Gerencie os públicos em Contatos > Públicos no painel, com bird audiences pelo terminal, pela API de públicos ou com qualquer um dos SDKs.

A página Públicos

A página Públicos lista seus públicos por nome, data de criação e tipo. O tipo aparece como Estático para uma lista cujos membros você adiciona e remove. Para visualizar a página, é necessária a permissão de leitura de email_marketing; para criar ou editar um público, é necessária a permissão de escrita.
A página Públicos no painel, com um campo de busca por nome, um botão Adicionar público e três linhas de públicos estáticos com descrições e datas de criação
Para criar um público, informe um nome e, opcionalmente, uma descrição de quem faz parte dele. Depois, abra o público para gerenciar seus membros.

Membros

Abra um público para ver seus membros, começando pelos adicionados mais recentemente. Cada linha mostra:
  • O nome e o endereço de e-mail do contato.
  • Os rótulos Email ou SMS, derivados dos identificadores armazenados do contato. Eles não comprovam que é possível alcançar o contato nem que existe permissão para isso.
  • Todos os públicos aos quais o contato pertence, incluindo este.
  • Quando o contato entrou neste público.
Pesquise na lista pelo endereço de e-mail e selecione uma linha para abrir o contato.
O resumo do público tem dois cartões. Membros conta todas as pessoas do público. Email conta os contatos com um endereço e informa uma estimativa de quantos podem receber envios após aplicar as preferências e supressões pertinentes. A estimativa pode mudar antes da execução de uma transmissão e não garante a entrega.
O público Assinantes da newsletter com os cartões de resumo Membros e Email, ambos mostrando 10, seguidos de uma tabela com nomes dos contatos, canais, públicos e horários de entrada
Adicione pessoas de uma destas duas maneiras:
  • Cole endereços de e-mail no público, um por linha, até 1.000 por vez. Associamos cada endereço a um contato existente, ou criamos um caso não haja correspondência, e então adicionamos todos ao público em uma única etapa.
  • Atribua durante a importação adicionando os contatos aos públicos enquanto você os importa ou cria ou atualiza por upsert. O endpoint de processamento em lote e bird contacts batch aceitam uma lista audience_ids, com até 10 públicos por solicitação, junto com os contatos. Todos os públicos indicados devem existir; caso contrário, a solicitação inteira falha e nada é gravado.
A adição é idempotente: um contato que já é membro permanece no público e mantém a data de entrada original. Remover a participação não registra um cancelamento de inscrição. Preferências e supressões continuam separadas. Remover um membro retira o contato apenas daquele público: o contato permanece no seu espaço de trabalho e em todos os outros públicos aos quais pertence. Remova um membro pela própria linha ou selecione vários e remova todos juntos.
Pela CLI, use bird audiences add-contacts <audience-id> para adicionar contatos e bird audiences remove-contacts <audience-id> para removê-los. Os dois comandos aceitam IDs de contatos, então você precisa conhecer o ID de cada contato que deseja adicionar ou remover. Se você só tem uma lista de endereços de e-mail, use bird contacts batch com audience_ids. Esse comando consulta cada endereço, cria um contato para os endereços que não reconhece e adiciona todos ao público em uma única chamada.

Manter uma coorte selecionada atualizada

A API pública de públicos usa participação estática e explícita. Se um CRM ou data warehouse avalia uma coorte com base em regras, sincronize tanto as adições quanto as remoções e registre a última atualização concluída. Siga a orientação em Sincronizar os membros de um público. Atualizar apenas as propriedades de um contato não reavalia um público estático.

Enviar para um público

Enviar uma mensagem para um público inteiro é uma transmissão. Escolha o público e geramos a lista de destinatários a partir dos membros quando o envio começa. Assim, a transmissão se dirige a quem faz parte do público naquele momento. As transmissões são executadas pelo painel, pela API ou pelos comandos bird email broadcasts.
Para uma lista pontual de destinatários que não vale a pena salvar como público, envie um lote.

Próximos passos

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Explore a funcionalidadeContacts and audiencesSiga o percurso de aprendizagemBuild your first integration
Obtenha um resumo de implementação