# Por que a importação dos meus contatos falhou?

> Resolva importações de contatos que falham ou trazem menos contatos que o esperado. Cobre o limite de 2.500 linhas, e-mails inválidos, campos personalizados e os limites das listas de contatos.

Este artigo ajuda quando a importação de contatos de um arquivo CSV ou Excel mostra um erro ou termina com menos contatos do que o seu arquivo tem.

## Sintomas

A caixa de diálogo **Import CSV** em **Email Marketing → Contacts** mostra um banner vermelho na etapa de pré-visualização, como:

- `A maximum of 2500 contacts can be imported per request.`
- `Contact #42 has an invalid email address.`
- `Unknown custom field key(s): …`
- `Pay as you go includes 10,000 subscribers per audience.`

Ou o botão **Continue** continua desativado com **You must map at least one column to the Email field.**

## Causa

Cada importação é verificada como um todo. Se uma regra falhar, nada é importado:

- **Mais de 2.500 linhas.** Cada importação aceita até 2.500 contatos.
- **Um endereço de e-mail inválido.** Um único endereço malformado faz o arquivo inteiro falhar. O número na mensagem conta os contatos depois que as linhas vazias são removidas, então pode ser diferente do número da linha na planilha.
- **Um campo personalizado que não existe.** As colunas associadas a campos personalizados exigem que esses campos sejam criados antes.
- **Nenhuma coluna associada a Email.** Email é o único campo obrigatório.
- **A lista de contatos ultrapassaria o limite do seu plano.** O Pay as you go permite 10.000 inscritos por lista, o Pro 50.000 e o Business 250.000. A verificação conta todas as linhas do seu arquivo mais os inscritos atuais da lista.

Menos contatos que o esperado geralmente significa linhas com a célula de e-mail vazia. Elas são ignoradas sem erro. Apenas a primeira planilha de um arquivo Excel é lida.

## Solução

1. **Divida arquivos grandes.** Separe o arquivo em partes de até 2.500 linhas e importe-as uma após a outra.

2. **Limpe a coluna de e-mail.** Remova espaços, pontuação no final e vários endereços em uma mesma célula. Para encontrar endereços inválidos ou arriscados, passe a lista pela [verificação de e-mails](/pt/docs/email-verification/lists/) antes.

3. **Crie os campos personalizados antes.** Adicione os campos que faltam em **Workspace → Settings**, em **Custom fields**, e comece a importação de novo. Consulte [Campos personalizados](/pt/docs/contacts/custom-fields/).

4. **Confira a associação das colunas.** Se o seu arquivo tiver uma linha de cabeçalho, mantenha **File has header** ativado para que as colunas sejam associadas pelo nome. Associe uma coluna a **Email**, defina as colunas não usadas como **Exclude** e revise a pré-visualização.

5. **Fique abaixo do limite da lista.** Importe para outra lista de contatos, remova os inscritos inativos ou faça upgrade do seu plano. Consulte [Limites](/pt/docs/limits/).

6. **Espere o processamento.** As importações são processadas em segundo plano. Quando a caixa de diálogo confirmar “Contact import has been queued and will be processed shortly.”, espere um minuto e atualize a lista de contatos.

> **As importações reinscrevem contatos:** Importar um contato para uma lista da qual ele tinha se descadastrado o inscreve de novo. Remova do arquivo as pessoas que pediram para sair antes de importá-lo.

Os contatos que já existem são atualizados em vez de duplicados. Os nomes só são substituídos quando o arquivo tem um valor, e os campos personalizados são mesclados. Leia [Importar e exportar contatos](/pt/docs/contacts/import-export/) para o guia completo ou use [Criar um contato](/pt/docs/api-reference/contacts/create/) para sincronizar contatos a partir da sua aplicação.

## Ainda com problemas?

[Fale com o suporte](/contact/) ou pergunte no [Discord](https://discord.emailit.com), enviando a mensagem de erro e as primeiras linhas do seu arquivo, sem dados pessoais.

---
Fonte: https://emailit.com/pt/docs/kb/contacts-import-failed/