Guia em vídeo
Aprenda como importar e gerenciar contatos no Bird. Este guia cobre a importação de arquivos CSV, a criação de listas de contatos, a gestão de status de assinatura e a adição de contatos individuais a listas existentes.
Guia passo a passo
Importar contatos para o Bird permite que você gerencie sua audiência de forma eficiente ao fazer o upload de informações de contato em massa. Este guia fornece um processo passo a passo para importar contatos usando um arquivo CSV.
Acesse a página de Contatos
Vá para Marketing > Público > Contatos
Você também pode ir para CRM > Contatos
Clique em Gerenciar dados > Importar de CSV
Prepare seu arquivo CSV
Baixe o arquivo modelo: No importador CSV, baixe o arquivo modelo fornecido para usar como um modelo para o formato correto.
Assegure a estrutura correta: Seu arquivo CSV deve incluir pelo menos um identificador para cada contato, como um número de telefone ou endereço de email. Você também pode incluir atributos adicionais, como país, primeiro nome, sobrenome etc.
Se você formatar seu arquivo CSV como o abaixo, você conseguirá concluir sua importação com sucesso.
Note que nem todos os campos estão preenchidos, mas cada contato possui dados em uma das colunas telefone ou email.
primeiroNome | sobrenome | país | telefone | |
|---|---|---|---|---|
Jane | Smith | US | +911234567892 | jane-smith@sample.com |
Daan | Bakker | DE | daan-bakker@sample.com | |
Maria | UK | +911234567891 | ||
fatima-khan@sample.com |
Duplicação e Mesclagem:
Note que quaisquer linhas duplicadas serão ignoradas e nenhum contato duplicado será criado. Também, note que como tanto telefone quanto email são considerados identificadores, se duas linhas tiverem o mesmo email e números de telefone diferentes, elas serão mescladas em um único contato. O mesmo se aplica a duas linhas com o mesmo telefone e emails diferentes.
Adicionando colunas de atributo
Você também pode adicionar valores para quaisquer atributos no upload CSV referenciando o nome deles no cabeçalho CSV. Por exemplo, para adicionar valores para o atributo Cidade no seu upload CSV, adicione a seção destacada no campo Nome (não nome de exibição) do atributo após atributo, ou seja, attributes.cidade ao cabeçalho CSV.
Você pode encontrar esses nomes em Contatos > Gestão de Dados > Atributos
Note que o nome da coluna deve ser cidade neste caso e NÃO o nome de exibição Cidade.
Abaixo estaria o formato CSV:
telefone | país | cidade | aniversário | |
|---|---|---|---|---|
jane-smith@sample.com | +911234567891 | US | Nova Iorque | 2025-07-25T12:00:00Z |
O formato para fazer upload do atributo de tipo data é AAAA-MM-DDTHH:MM:SSZ
Identificadores Personalizados
Ao fazer upload de identificadores personalizados e atributos de comunicação, você pode não precisar de email ou telefone como colunas obrigatórias, mas a coluna de identificador personalizada será obrigatória. Se o nome do seu atributo de identificador personalizado é attributes.userId (não nome de exibição), então a coluna que você deve usar deve ser identifier.userId.
Para atributos de comunicação para telefone ou email, você precisará usar seus nomes como qualquer outra coluna de nome de atributo. Se o seu atributo de comunicação for attributes.phone_number e attributes.email_address, então a importação CSV ficará como abaixo
identifier.userId | phone_number | email_address | país | cidade |
|---|---|---|---|---|
1234 | +911234567891 | a@b.com | US | Nova Iorque |
Faça upload do seu arquivo CSV
Arraste e solte seu arquivo CSV preparado na área designada, ou clique em Navegar para selecionar o arquivo do seu dispositivo.
Após o upload, revise os campos para garantir que todos os dados foram mapeados corretamente.
Role pelas colunas para verificar a precisão.
Uma vez satisfeito, clique em Continuar.
Mapear Colunas
Na seção de Colunas do Mapa, você verá um mapeamento onde as colunas do seu arquivo CSV à esquerda estão mapeadas para os atributos de Contato à direita.
Alguns dos mapeamentos serão preenchidos automaticamente para você, e você pode atualizá-los conforme necessário. Após atualizar, clique em Salvar mapeamento.
Você pode clicar no ícone de engrenagem ao lado de qualquer mapeamento para ver configurações avançadas para o atributo do contato, como
Se você deseja substituir o valor existente ou apenas defini-lo se estiver em branco. Por padrão, a importação é configurada para substituir.
Se você deseja que o valor seja obrigatório, o que significa que a linha do contato não será importada se o valor estiver faltando para um atributo obrigatório. Por padrão, os atributos não são obrigatórios.
Fornecer mais configuração
No passo de Configuração, você pode definir configurações adicionais, como Assinatura, identificadores, listas, além de habilitar automações.
Mapeamento de identificadores: Você pode configurar e selecionar quaisquer identificadores que desejar definir e mapeá-los com os cabeçalhos de coluna do arquivo csv. Você também pode criar novos identificadores personalizados digitando e selecionando no menu suspenso.
Adicionando a Listas: Você pode selecionar uma ou mais listas existentes para adicionar os contatos. Você também pode criar uma nova lista e adicionar a ela.
Habilitar automações: Você pode configurar se deseja que as automações, como jornadas e fluxos, sejam acionadas automaticamente com base na sua importação, quando os contatos são criados ou atualizados. Por padrão, as automações serão acionadas se forem baseadas na criação ou atualização de contatos.
Gerenciamento de Assinaturas: Você pode definir para cada plataforma como deseja configurar os valores do atributo Assinatura dos contatos que estão sendo importados. Observe que apenas os contatos Assinados aparecerão como destinatários estimados nas Campanhas.
Revisar e Importar
Revise todas as configurações e mapeamentos.
Clique em Continuar para importar a seção
Você pode clicar em Executar Auditoria para verificar seus dados quanto a erros antes de importar
Se tudo estiver bom, clique em Importar
Você será redirecionado para a guia de Importações, onde poderá monitorar o progresso e ver os detalhes de todas as importações
Perguntas Comuns durante a Importação
Por que minha lista tem menos contatos do que os importados
A visualização de importação mostra o número total de linhas processadas do seu arquivo CSV, no entanto, se o seu arquivo tiver identificadores duplicados, como telefone ou e-mail, o número total de contatos criados e adicionados à sua lista será menor do que o esperado.
Note que se você tiver identificadores comuns, então seu contato será criado como um e outros identificadores serão adicionados a ele. Por exemplo, se você tiver 2 contatos com e-mails diferentes, mas o mesmo número de telefone, você terá apenas um contato criado com 2 e-mails e 1 número de telefone.
