# Importando contatos de um arquivo Se você tem uma lista de contatos em uma planilha, você pode enviá-los todos de uma vez em vez de adicioná-los um por um. O aplicativo usa um assistente de 3 etapas — **Upload → Mapear colunas → Revisar** — que funciona com o arquivo CSV que você já possui, sem a necessidade de baixar um modelo primeiro. --- ## Como importar contatos 1. Clique em **Contatos** na barra lateral esquerda e, em seguida, clique em **Importar** no topo da página. 2. **Upload.** Arraste seu arquivo CSV para a área de soltar ou clique nela para procurar o arquivo. Não há um modelo para baixar primeiro — traga o arquivo que você já possui. 3. **Mapear colunas.** O assistente lê a linha de cabeçalho do seu arquivo e tenta corresponder automaticamente cada coluna a um campo de destino: **Nome, Sobrenome, Telefone, E-mail, Tags, Notas** ou **Não importar**. Verifique a sugestão de cada coluna e corrija qualquer uma que esteja incorreta usando o seletor ao lado. Uma tabela de visualização mostra as primeiras linhas exatamente como serão importadas. * Uma **coluna de número de telefone é obrigatória** — você não pode continuar sem mapear uma. * Uma coluna mapeada para **Tags** torna-se tags reais em cada contato. Várias tags em uma única célula são permitidas — separe-as com vírgula ou ponto e vírgula (`vip; newsletter; hotmart`). Tags que ainda não existem são criadas para você; tags que já existem são reutilizadas, ignorando letras maiúsculas ou minúsculas. 4. **Revisão.** Escolha: * **Canal padrão** — WhatsApp Business, WhatsApp Web ou SMS. Isso se aplica a qualquer contato importado que ainda não especifique um canal. * **Lista** — escolha uma lista existente no menu suspenso ou digite um nome para criar uma nova na hora. Você só pode fazer uma ou outra, não ambas. * **Atualizar contatos existentes** — desativado por padrão. Se desativado, as linhas que correspondem a um contato que você já possui (mesmo número de telefone) são ignoradas como duplicatas: nada nesse contato muda e ele **não** é adicionado à lista. Se ativado, essas linhas **atualizam** o contato: o nome, e-mail e notas no seu arquivo sobrescrevem o que está lá (células vazias mantêm o valor atual), quaisquer tags na linha são adicionadas e o contato é adicionado à lista que você escolheu. É assim que você reimporta um arquivo para corrigir ou enriquecer contatos que você já possui. 5. Clique em **Importar [count]**. Você chegará a uma tela de resultados mostrando quantos contatos foram criados, quantos contatos existentes foram atualizados (quando essa opção está ativada) e, se alguma linha foi ignorada, uma análise do motivo (número de telefone inválido, número de telefone ausente, duplicata, limite de contatos atingido, etc.). --- ## Detalhes do Mapeamento de Colunas * **Telefone** é a única coluna obrigatória. Linhas sem nenhum número de telefone são descartadas antes da importação e contadas separadamente na tela de resultados. * **Nome / Sobrenome / E-mail** mapeiam diretamente para os campos básicos do contato. * **Notas** mapeia para o campo [Notas / Perfil do Lead](custom-contact-fields.md#notes-lead-profile) do contato. * **Tags** cria (ou reutiliza) tags reais e as aplica ao contato — as mesmas tags pelas quais você filtra, direciona transmissões e dispara webhooks. Coloque várias em uma célula separadas por vírgulas ou pontos e vírgulas. Antes de 19 de agosto de 2026, esta coluna era salva como um campo personalizado chamado `tags`; se você importou antes dessa data, reimporte o mesmo arquivo com **Atualizar contatos existentes** ativado e as tags serão aplicadas corretamente (o campo personalizado `tags` restante não causa problemas; entre em contato com o suporte se desejar que ele seja removido de todos os contatos). * Atualmente, não há mapeamento de coluna 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 alternativa 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 completamente. - Você não precisa remover espaços, traços ou parênteses dos números de telefone — o importador tolera a formatação comum, mas ainda precisa do código do país. - Os arquivos são processados inteiramente no seu navegador, portanto, não há um limite fixo de tamanho de upload do próprio assistente — mas sua contagem total de contatos ainda é limitada pelo seu plano. Se uma importação ultrapassar o limite do seu plano, essas linhas serão rejeitadas e aparecerão na tela de resultados como `contact_limit_reached`. - Se um contato com o mesmo número de telefone já existir, essa linha será ignorada por padrão — ela aparecerá como `duplicate` na tela de resultados. A importação nunca cria uma segunda cópia de alguém. Para editar em massa contatos que você já possui (corrigir nomes ou e-mails, adicionar tags, colocá-los em uma lista), ative **Atualizar contatos existentes** na etapa de Revisão e reimporte o arquivo. --- ## Perguntas Frequentes **Meu CSV tem uma coluna `custom_company` de uma exportação antiga — ela será mapeada corretamente?** Não automaticamente. O correspondente automático do assistente só reconhece cabeçalhos de nome/telefone/e-mail/tags/notas; qualquer outra coisa é definida como **Não importar**, portanto, uma coluna `custom_company` não preencherá o campo personalizado `company` por conta própria. Adicione os valores posteriormente via [Campos Personalizados](custom-contact-fields.md) ou através da API. **Para onde foi o botão "Baixar Modelo"?** Ele não existe mais — o assistente funciona diretamente com qualquer CSV que você já tenha e permite que você corrija quaisquer colunas incompatíveis na etapa de Mapeamento. **Eu já importei meus contatos — como adiciono tags ou corrijo campos para todos eles de uma vez?** Reimporte o mesmo arquivo (ou um atualizado) com **Atualizar contatos existentes** ativado na etapa de Revisão. As linhas que correspondem a um número de telefone existente atualizam esse contato — nome, e-mail, notas, tags e lista — em vez de serem ignoradas. Apenas os números de telefone são usados para correspondência, portanto, mantenha essa coluna exatamente como estava. **Posso importar contatos do Instagram ou Messenger a partir de um arquivo?** Não. A importação suporta apenas WhatsApp Business, WhatsApp Web e SMS, pois esses canais alcançam as pessoas por número de telefone. O Instagram e o Messenger identificam as pessoas por suas contas sociais, portanto, esses contatos são criados automaticamente quando alguém envia uma mensagem para você nesses canais. **Posso importar contatos como inativos para o bot?** Não existe uma coluna por linha para isso. Importe o lote primeiro e, em seguida, use a ação em massa **Bot desligado** nos contatos importados — veja [Excluindo contatos do bot de IA](excluding-contacts-from-bot.md). --- ## Próximos passos - [Organizando Listas e Contatos](list-and-contact-management.md) — gerencie e classifique seus contatos recém-importados. - [Migrando de Campanhas para Transmissões e Agentes](../moving-from-campaigns.md) — comece a enviar mensagens para sua lista importada. - [Campos Personalizados, Perfil do Lead e Notas](custom-contact-fields.md) — preencha detalhes mais ricos após a importação.