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. Mapeie as 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, qualquer um dos seus campos personalizados ou Não importar. Verifique a sugestão de cada coluna e corrija qualquer uma que esteja incorreta usando o seletor ao lado dela. Uma tabela de visualização mostra as primeiras linhas exatamente como serão importadas.
   • Uma coluna cujo cabeçalho é o nome de um dos seus campos personalizados é correspondida a esse campo automaticamente. Maiúsculas e acentos não importam, então uma coluna CPF encontra um campo chamado cpf. Você também pode escolher qualquer campo personalizado para qualquer coluna manualmente.
   • Uma coluna que ainda não é um dos seus campos personalizados pode se tornar um: escolha Novo campo personalizado: no seletor e o campo será criado quando você importar.
   • Se um campo personalizado tiver um tipo (Número, Caixa de seleção, Menu suspenso) e alguns dos valores da coluna não se encaixarem, o assistente avisa quantas linhas isso afeta antes de você importar. Essas linhas são ignoradas por completo, incluindo nome e e-mail. Clique em Mudar para Texto no aviso para alterar o tipo do campo em uma etapa, ou corrija os valores, ou defina a coluna como Não importar.
   • Uma coluna de número de telefone é obrigatória — você não pode continuar sem mapear uma.
   • Uma coluna mapeada para Tags se torna tags reais em cada contato. Várias tags em uma célula são permitidas — separe-as com uma 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 maiúsculas e 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. Se você abrir a importação enquanto a página de Contatos estiver exibindo uma de suas listas, essa lista já estará selecionada para você; limpe-a se não a desejar.
   • Atualizar contatos existentes — desativado por padrão. 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 é alterado, embora, se você escolheu uma lista, o contato que você já possui ainda seja adicionado a ela. 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 estiver ativada), quantos contatos que você já tinha foram adicionados à lista que você escolheu e, se alguma linha foi ignorada, um detalhamento do motivo (número de telefone inválido, número de telefone ausente, duplicata, limite de contatos atingido, etc.). Se Atualizar contatos existentes estiver desativado e algumas linhas corresponderem a contatos que você já possui, a tela de resultados informará isso e oferecerá Atualizar estes contatos: um clique reenvia apenas essas linhas com a opção ativada, para que você não precise importar o arquivo novamente.

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 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, importe novamente o mesmo arquivo com a opção Atualizar contatos existentes ativada 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).
• Campos personalizados — cada um dos seus campos personalizados é seu próprio destino. Um cabeçalho que corresponda ao nome de um campo é escolhido para você; o valor é salvo no contato exatamente como está no arquivo (um campo de Número, Data, Caixa de seleção ou Lista suspensa 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 a opção Atualizar contatos existentes ativada, os valores dos campos personalizados no arquivo também atualizam os contatos que você já possui; células vazias mantêm o valor atual.
• Uma coluna que contém identificadores com pontos, traços ou zeros à esquerda (um CPF, um número fiscal, um CEP) pertence a um campo de Texto. Em um campo de Número, esses valores não se encaixam 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 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 analisados inteiramente no seu navegador, portanto, não há um limite fixo de tamanho de upload no 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. Escolher uma lista ainda funciona nessas linhas: o contato que você já possui é adicionado à lista e contado separadamente na tela de resultados, portanto, reimportar o mesmo arquivo é a maneira de preencher uma lista com pessoas que já estão na sua conta. Para também atualizar seus campos (corrigir nomes ou e-mails, adicionar tags), 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 por conta própria, porque o cabeçalho não é exatamente company. Escolha Campo personalizado: company no seletor daquela coluna e ele será importado para o campo company. Renomear o cabeçalho para company antes de fazer o upload fará com que o assistente o corresponda para você.

Algumas linhas foram ignoradas com “O valor de um campo personalizado não se encaixa no tipo desse campo” — por quê? 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 em um campo de Número. Clique em Mudar para Texto no aviso na etapa de Mapear colunas (ou altere o tipo em Campos personalizados) e importe o arquivo novamente com Atualizar contatos existentes ativado.

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.

Próximos passos #

• Organizando Listas e Contatos — gerencie e classifique seus contatos recém-importados.
• Migrando de Campanhas para Transmissões e Agentes — comece a enviar mensagens para sua lista importada.
• Campos Personalizados, Perfil do Lead e Notas — preencha detalhes mais ricos após a importação.