Importar contactos a partir de um ficheiro #

Se tiver uma lista de contactos numa folha de cálculo, pode carregá-los todos de uma vez em vez de os adicionar um a um. A aplicação utiliza um assistente de 3 passos — Carregar → Mapear colunas → Rever — que funciona com o ficheiro CSV que já possui, sem necessidade de descarregar um modelo primeiro.

Como importar contactos #

1. Clique em Contactos na barra lateral esquerda e, em seguida, clique em Importar no topo da página.
2. Carregar. Arraste o seu ficheiro CSV para a zona de largada ou clique no mesmo para procurar. Não existe um modelo para descarregar primeiro — utilize o ficheiro que já possui.

3. Mapear colunas. O assistente lê a linha de cabeçalho do seu ficheiro e tenta corresponder automaticamente cada coluna a um campo de destino: Nome próprio, Apelido, Telefone, E-mail, Etiquetas, Notas, qualquer um dos seus campos personalizados, ou Não importar. Verifique a sugestão de cada coluna e corrija qualquer erro utilizando o seletor ao lado. Uma tabela de pré-visualização mostra as primeiras linhas exatamente como serão importadas.
   • Uma coluna cujo cabeçalho seja o nome de um dos seus campos personalizados é correspondida automaticamente a esse campo. Maiúsculas e acentos não importam, pelo que uma coluna CPF encontra um campo chamado cpf. Também pode escolher manualmente qualquer campo personalizado para qualquer coluna.
   • Uma coluna que ainda não seja um dos seus campos personalizados pode tornar-se um: escolha Novo campo personalizado: no respetivo seletor e o campo será criado quando importar.
   • Se um campo personalizado tiver um tipo (Número, Caixa de verificação, Lista pendente) e alguns dos valores da coluna não se ajustarem, o assistente avisa-o de quantas linhas isso afeta antes de importar. Essas linhas são ignoradas na totalidade, incluindo nome e e-mail. Clique em Mudar para Texto no aviso para alterar o tipo de campo num só passo, ou corrija os valores, ou defina a coluna como Não importar.
   • Uma coluna de número de telefone é obrigatória — não pode continuar sem mapear uma.
   • Uma coluna mapeada para Etiquetas torna-se etiquetas reais em cada contacto. Várias etiquetas numa célula não são um problema — separe-as com uma vírgula ou ponto e vírgula (vip; newsletter; hotmart). As etiquetas que ainda não existem são criadas para si; as etiquetas que já existem são reutilizadas, ignorando maiúsculas.

4. Revisão. Escolha:
   • Canal predefinido — WhatsApp Business, WhatsApp Web ou SMS. Isto aplica-se a qualquer contacto importado que ainda não especifique um canal.
   • Lista — escolha uma lista existente na lista pendente ou escreva um nome para criar uma nova no momento. Só pode fazer uma ou outra, não ambas. Se abrir a importação enquanto a página de Contactos estiver a mostrar uma das suas listas, essa lista já estará selecionada para si; limpe-a se não a pretender.
   • Atualizar contactos existentes — desativado por predefinição. Se estiver desativado, as linhas que correspondem a um contacto que já possui (mesmo número de telefone) são ignoradas como duplicados: nada muda nesse contacto, embora, se tiver escolhido uma lista, o contacto que já possui seja adicionado à mesma. Se estiver ativado, essas linhas atualizam o contacto: o nome, o e-mail e as notas no seu ficheiro substituem o que lá está (as células vazias mantêm o valor atual), quaisquer etiquetas na linha são adicionadas e o contacto é adicionado à lista que escolheu. É assim que volta a importar um ficheiro para corrigir ou enriquecer contactos que já possui.

5. Clique em Importar [count]. Irá parar a um ecrã de resultados que mostra quantos contactos foram criados, quantos contactos existentes foram atualizados (quando essa opção está ativa), quantos contactos que já tinha foram adicionados à lista que escolheu e, se alguma linha foi ignorada, uma descrição do motivo (número de telefone inválido, número de telefone em falta, duplicado, limite de contactos atingido, etc.). Se a opção Atualizar contactos existentes estava desativada e algumas linhas correspondiam a contactos que já possui, o ecrã de resultados indica-o e oferece a opção Atualizar estes contactos: um clique reenvia apenas essas linhas com a opção ativada, para que não tenha de importar o ficheiro novamente.

Detalhes do Mapeamento de Colunas #

• Telefone é a única coluna obrigatória. As linhas sem qualquer número de telefone são descartadas antes da importação e contadas separadamente no ecrã de resultados.
• Nome próprio / Apelido / E-mail mapeiam diretamente para os campos básicos do contacto.
• Notas mapeia para o campo Notas / Perfil de Lead do contacto.
• Etiquetas cria (ou reutiliza) etiquetas reais e aplica-as ao contacto — as mesmas etiquetas pelas quais filtra, para as quais direciona transmissões e a partir das quais dispara webhooks. Coloque várias numa célula separadas por vírgulas ou pontos e vírgula. Antes de 19 de agosto de 2026, esta coluna era guardada como um campo personalizado chamado tags; se importou antes dessa data, volte a importar o mesmo ficheiro com Atualizar contactos existentes ativado e as etiquetas serão aplicadas corretamente (o campo personalizado tags restante não causa problemas; contacte o suporte se desejar que seja removido de todos os contactos).
• Campos personalizados — cada um dos seus campos personalizados é o seu próprio destino. Um cabeçalho que corresponda ao nome de um campo é selecionado para si; o valor é guardado no contacto exatamente como está no ficheiro (um campo de Número, Data, Caixa de verificação ou Lista pendente converte formas reconhecíveis como 19,99, 01/02/1990 ou yes). Escolha Novo campo personalizado para criar um campo a partir de uma coluna. Com Atualizar contactos existentes ativado, os valores dos campos personalizados no ficheiro também atualizam os contactos que já possui; as células vazias mantêm o valor atual.
• Uma coluna que contenha identificadores com pontos, travessões ou zeros à esquerda (um CPF, um número de identificação fiscal, um código postal) pertence a um campo de Texto. Num campo de Número, esses valores não se ajustam e a linha é ignorada.

Dicas #

• Verifique se os números de telefone incluem o código do país. Sem ele, as mensagens não serão entregues — e as linhas sem um número de telefone utilizável são ignoradas por completo.
• Não precisa de remover espaços, travessões ou parênteses dos números de telefone — o importador tolera a formatação comum, mas continua a precisar do código do país.
• Os ficheiros são analisados inteiramente no seu navegador, pelo que não existe um limite de tamanho de carregamento fixo por parte do assistente — mas o seu número total de contactos continua a estar limitado pelo seu plano. Se uma importação o fizer ultrapassar o limite do seu plano, essas linhas são rejeitadas e aparecem no ecrã de resultados como contact_limit_reached.
• Se um contacto com o mesmo número de telefone já existir, essa linha é ignorada por predefinição — aparece como duplicate no ecrã de resultados. A importação nunca cria uma segunda cópia de alguém. Escolher uma lista continua a funcionar nessas linhas: o contacto que já possui é adicionado à lista e contado separadamente no ecrã de resultados, pelo que voltar a importar o mesmo ficheiro é a forma de preencher uma lista com pessoas que já estão na sua conta. Para atualizar também os seus campos (corrigir nomes ou e-mails, adicionar etiquetas), ative Atualizar contactos existentes no passo de Revisão e volte a importar o ficheiro.

Perguntas Frequentes #

O meu CSV tem uma coluna custom_company de uma exportação antiga — será mapeada corretamente? Não por si só, porque o cabeçalho não é exatamente company. Escolha Campo personalizado: company no seletor dessa coluna e será importado para o campo company. Mudar o nome do cabeçalho para company antes de carregar fará com que o assistente o corresponda por si.

Algumas linhas foram ignoradas com “Um valor de campo personalizado não se ajusta ao tipo desse campo” — porquê? A coluna está mapeada para um campo personalizado com tipo (por exemplo, Número) e essas linhas contêm outra coisa, como 001.576.401-08 num campo de Número. Clique em Mudar para Texto no aviso no passo Mapear colunas (ou altere o tipo em Campos personalizados) e importe o ficheiro novamente com Atualizar contactos existentes ativado.

Para onde foi o botão “Descarregar Modelo”? Desapareceu — o assistente funciona diretamente com qualquer CSV que já possua e permite-lhe corrigir quaisquer colunas incompatíveis no passo de Mapeamento.

Já importei os meus contactos — como adiciono etiquetas ou corrijo campos para todos de uma vez? Volte a importar o mesmo ficheiro (ou um atualizado) com a opção Atualizar contactos existentes ativada no passo de Revisão. As linhas que correspondem a um número de telefone existente atualizam esse contacto — nome, email, notas, etiquetas e lista — em vez de serem ignoradas. Apenas os números de telefone são utilizados para a correspondência, por isso mantenha essa coluna exatamente como estava.

Posso importar contactos do Instagram ou do Messenger a partir de um ficheiro? Não. A importação apenas suporta o WhatsApp Business, o WhatsApp Web e SMS, uma vez que estes canais chegam às pessoas através do número de telefone. O Instagram e o Messenger identificam as pessoas através da sua conta de rede social, pelo que esses contactos são criados automaticamente quando alguém lhe envia uma mensagem através desse canal.

Posso importar contactos como inativos para o bot? Não existe uma coluna por linha para isso. Importe o lote primeiro e, em seguida, utilize a ação em massa Bot desligado nos contactos importados — consulte Excluir Contactos do Bot de IA.

Próximos Passos #

• Organizar Listas e Contactos — gere e ordene os seus contactos recém-importados.
• Passar de Campanhas para Transmissões e Agentes — comece a enviar mensagens para a sua lista importada.
• Campos Personalizados, Perfil de Lead e Notas — preencha detalhes mais ricos após a importação.