Importar contatos

Atualizado em 24 de agosto de 2026

Use a importação para carregar no Pluspoint uma lista de clientes que você já tem, ou para atualizar dados em massa a partir de outro sistema. Cada linha do arquivo é comparada com os seus contatos existentes. Você vê exatamente o que vai mudar antes de qualquer coisa ser gravada, e as linhas que não correspondem a ninguém entram como registros novos.

Antes de começar

Você precisa de acesso completo a Contatos. Com acesso restrito, o botão Importar não aparece — veja Usuários e permissões.

Importar só está disponível no computador. Fica oculto em telas com 768 pixels de largura ou menos.

Você precisa escolher pelo menos uma localização durante a importação, então crie as suas localizações primeiro — veja Gerenciar localizações.

O arquivo precisa ser um CSV de verdade. Salve qualquer planilha como CSV antes de enviar.

Onde encontrar

Contatos → Importar, ou acesse https://app.pluspoint.io/contacts e selecione Importar.

A caixa de diálogo traz um link Baixar amostra do CSV. para um modelo em https://docs.google.com/spreadsheets/d/1elW5JQyXmByeMzRHhhsSuX3PXL42HyxGhNytbWXfVsI/.

Preparar o CSV

O arquivo precisa de uma linha de cabeçalho, separadores de vírgula e cabeçalhos escritos exatamente como abaixo. Campos com vírgulas podem vir entre aspas. Dentro de um campo entre aspas, duplique cada aspa.

Cabeçalho da coluna	Corresponde a
`First Name`	Primeiro nome
`Last Name`	Último nome
`Mobile Number`	Telefone
`Email`	Endereço de e-mail
`Facebook`	Nome de usuário do Facebook, sem o prefixo `facebook.com/`
`Instagram`	Nome de usuário do Instagram, sem o prefixo `instagram.com/`
`External ID`	ID externo — o identificador deste cliente no seu próprio sistema

Regras que o analisador aplica ao arquivo em si:

As colunas que ele não reconhece são ignoradas, então você pode deixar dados extras no arquivo.
Uma linha com um número de colunas diferente do da linha de cabeçalho é descartada sem aviso. Atenção a vírgulas soltas em valores sem aspas.
O seletor de arquivos oferece .xlsx e .xls além de .csv, mas só texto CSV puro é lido. Enviar uma pasta de trabalho do Excel de verdade falha com Formato incorreto de arquivo.

Nota Uma exportação de contatos grava a coluna do ID externo como External Id, enquanto a importação espera External ID. Se você edita uma exportação e a carrega de volta, renomeie esse cabeçalho antes. Caso contrário, todos os IDs externos do arquivo são ignorados em silêncio.

Fazer a importação

Selecione Importar.
Escolha uma ou mais Localizações. Todos os contatos alcançados pela importação são atribuídos às localizações que você escolher aqui.
Selecione Escolher Arquivo e escolha o seu arquivo.
Selecione Validar.
Reveja a tabela das linhas lidas. Os valores que falharam na validação aparecem em vermelho.
Remova qualquer linha que você não queira com o ícone de lixeira. Importar continua desativado enquanto houver uma única linha inválida. Exclua essas linhas, ou selecione Voltar, corrija o arquivo e envie de novo.
Selecione Importar.

Como as linhas são validadas

A caixa de diálogo limpa o arquivo em silêncio antes de mostrar qualquer coisa, então a quantidade de linhas na tabela pode ser menor do que a da sua planilha.

Regra	Efeito
Uma linha sem telefone e sem e-mail	Descartada em silêncio
Duas linhas com o mesmo telefone	Só a primeira é mantida. As linhas sem telefone são todas mantidas
Um telefone que não começa com `+` nem com `0`	Um `+` é acrescentado antes da validação
Um telefone que começa com `0` em uma conta com idioma da Ucrânia	Vira `+38` seguido do número
Um telefone que começa com `0` em uma conta com idioma do Reino Unido	Vira `+44` seguido do número sem o zero inicial
Qualquer telefone depois disso	Validado como número internacional e reescrito no formato E.164. Um número inválido bloqueia a linha, mesmo que o e-mail esteja correto
Um e-mail	Validado pelo formato. Uma célula vazia é aceitável, mas um endereço malformado bloqueia a linha
Uma linha que a caixa de diálogo emparelha com um contato existente mas que não altera nada	Removida por completo da importação

Essa última regra tem uma consequência que vale a pena planejar. Como essas linhas nunca são enviadas, as localizações que você escolheu no passo 2 não são aplicadas a elas. Para adicionar uma localização a contatos cujos dados já estão corretos, selecione-os na página Contatos e use Editar em massa — veja Gerenciar contatos.

O que a importação altera

Uma linha é tratada como um contato existente quando qualquer um destes corresponde a um contato da sua conta:

um ID externo não vazio que seja igual,
um telefone que seja igual depois da limpeza,
ou um endereço de e-mail que seja igual.

A tabela de pré-visualização é mais rigorosa do que isso. Ela só emparelha uma linha com um contato existente em dois casos: quando os telefones são iguais, ou quando nem a linha nem o contato têm telefone e os endereços de e-mail são iguais. Por isso, uma linha que a importação vai fazer corresponder pelo ID externo — ou pelo e-mail, quando os dois telefones diferem — aparece e é contada como nova. Ela é importada sem o preenchimento prévio descrito abaixo.

Para um contato correspondente	Para um contato novo
Primeiro nome, último nome, e-mail, telefone, Instagram e Facebook são sobrescritos pelos valores importados, inclusive as células em branco. Em uma linha que a pré-visualização emparelhou, os espaços em branco são preenchidos antes a partir do registro existente, então nada se perde. Em uma linha que ela não emparelhou, uma célula em branco sobrescreve o valor salvo	Criado com tudo o que a linha fornece
Um ID externo existente é mantido. O arquivo nunca sobrescreve um que já esteja definido	O ID externo do arquivo é salvo
As localizações que você escolheu são adicionadas. As localizações existentes nunca são removidas	Atribuído às localizações que você escolheu
Os segmentos existentes ficam intocados	Criado sem nenhum segmento
Nenhuma nova atividade Contato criado	Uma entrada Contato criado é gravada na linha do tempo

Duas coisas que uma importação deliberadamente não faz:

Ela não consegue atribuir segmentos. Não há coluna de segmento, e os segmentos que um contato já tem sobrevivem intocados à importação. Atribua segmentos depois com Editar em massa — veja Segmentos.
Ela não consegue remover nada. As localizações são apenas adicionadas, e nenhum contato é excluído ou desinscrito por uma importação.

Tamanho e importações repetidas

Mantenha cada arquivo em um tamanho gerenciável e divida uma lista muito grande em várias importações, em vez de mandar um arquivo enorme.

Reimportar o mesmo arquivo é seguro. A segunda execução compara cada linha com o contato que ela criou, não encontra nada alterado e remove as linhas da importação. É também por isso que uma reimportação não reaplica a localização que você escolheu.

Solução de problemas

Sintoma	Causa	Solução
Não aparece o botão Importar	Você tem acesso restrito a Contatos, ou está em uma tela com 768 pixels de largura ou menos	Peça acesso completo, ou use um navegador de computador
Formato incorreto de arquivo	O arquivo é uma pasta de trabalho do Excel ou não é texto separado por vírgulas	Salve como CSV e envie de novo
Menos linhas na tabela do que no arquivo	Linhas sem telefone e sem e-mail, telefones duplicados, linhas malformadas e correspondências sem alteração são todas removidas antes de a tabela ser desenhada	Verifique esses casos no arquivo de origem
Um telefone aparece em vermelho	Ele não é um número internacional válido depois da limpeza	Escreva-o em formato internacional completo, começando com `+` e o código do país
Os IDs externos não entraram	O cabeçalho diz `External Id` em vez de `External ID`, ou os contatos já tinham um ID externo	Renomeie o cabeçalho; IDs externos existentes nunca são sobrescritos
As localizações que você escolheu não foram aplicadas a alguns contatos	Essas linhas corresponderam a um contato existente e não alteraram nada, então foram descartadas	Atribua a localização com Editar em massa na página Contatos
Os contatos importados não têm segmentos	A importação não consegue definir segmentos	Selecione-os na página Contatos e use Editar em massa
Não foi possível importar	O lote falhou como um todo	Nada foi gravado. Verifique se o arquivo é muito grande ou tem linhas malformadas e tente de novo