# 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, Email, Etiquetas, Notas** ou **Não importar**. Verifique a sugestão de cada coluna e corrija qualquer uma que esteja errada utilizando o seletor ao lado. Uma tabela de pré-visualização mostra as primeiras linhas exatamente como serão importadas. * 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 única 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 e minúsculas. 4. **Rever.** Escolha: * **Canal predefinido** — WhatsApp Business, WhatsApp Web ou SMS. Isto aplica-se a qualquer contacto importado que não especifique já um canal. * **Lista** — escolha uma lista existente a partir do menu pendente ou escreva um nome para criar uma nova no momento. Só pode fazer uma ou outra, não ambas. * **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 nesse contacto é alterado e este **não** é adicionado à lista. Se estiver ativado, essas linhas **atualizam** o contacto: o nome, email e notas no seu ficheiro substituem o que lá está (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á ativada) e, se alguma linha foi ignorada, um detalhe do motivo (número de telefone inválido, número de telefone em falta, duplicado, limite de contactos atingido, etc.). --- ## 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 / Email** mapeiam diretamente para os campos básicos do contacto. * **Notas** mapeia para o campo [Notas / Perfil de Lead](custom-contact-fields.md#notes-lead-profile) 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 a opção **Atualizar contactos existentes** ativada e as etiquetas serão aplicadas corretamente (o campo personalizado `tags` remanescente não causa problemas; contacte o suporte se desejar que seja removido de todos os contactos). * Atualmente, não existe mapeamento de colunas para campos personalizados arbitrários (como as colunas `custom_` do clássico) — consulte [Carregamento em massa de campos personalizados](custom-contact-fields.md#bulk-loading-custom-fields) para a solução atual. --- ## 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 ainda assim necessita do código do país. - Os ficheiros são processados inteiramente no seu navegador, pelo que não existe um limite de tamanho de carregamento fixo por parte do próprio assistente — mas o seu número total de contactos continua 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. Para editar em massa contactos que já possui (corrigir nomes ou emails, adicionar etiquetas, colocá-los numa lista), ative a opção **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 automaticamente. O correspondente automático do assistente apenas reconhece cabeçalhos de nome/telefone/e-mail/etiquetas/notas; tudo o resto assume por predefinição **Não importar**, pelo que uma coluna `custom_company` não preencherá o campo personalizado `company` por si só. Adicione os valores posteriormente através de [Campos Personalizados](custom-contact-fields.md) ou através da API. **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](excluding-contacts-from-bot.md). --- ## Próximos Passos - [Organizar Listas e Contactos](list-and-contact-management.md) — gere e ordene os seus contactos recém-importados. - [Passar de Campanhas para Transmissões e Agentes](../moving-from-campaigns.md) — comece a enviar mensagens para a sua lista importada. - [Campos Personalizados, Perfil de Lead e Notas](custom-contact-fields.md) — preencha detalhes mais ricos após a importação.