Quando você envia uma lista de contatos e vê uma mensagem de “registro de erros” no registro de ações, significa que tem algo errado na sua lista de contatos.
Possíveis causas de registro de erros:
• Arquivo de contato (CSV) formatado incorretamente *
• Número incorreto de colunas de cabeçalho
• Poucas colunas em uma determinada linha (ou separadores de campo ausentes)
• Um ou mais endereços de e-mail não estão no formato nome@site.com
• Endereços de e-mail duplicados (o endereço duplicado será descartado)
• Não foi possível converter o valor (formatos de data incorretos)
• Importação cancelada pelo sistema devido a um erro “crítico”
Para baixar o registro de erros, clique no botão “Baixar registro de erros”. Revise as mensagens de erro no arquivo de log e corrija sua lista de contatos. Aviso: se não houver erros em seu próximo envio, o registro de erros desaparecerá.
* Para informações sobre como criar um arquivo CSV para enviar seus contatos, leia nossa Pergunta Frequente.
Explicação dos logs de erro
O número de propriedades do contato excede o limite de X
A importação do seu CSV está tentando criar/mapear mais propriedades de contato (campos personalizados) do que o sistema permite. 200 é o limite máximo (incluindo o campo de e-mail).
Exemplo típico
O limite é de 200 propriedades, mas seu arquivo tem 260 colunas personalizadas:
e-mail,field_01,field_02,field_03,...,field_260 john@exemplo.com,a,b,c,...,z
→ O importador precisaria de 260 propriedades (uma por coluna), o que está acima do limite → O número de propriedades do contato excede o limite de 200.
Correção: remova/mescle colunas ou realize múltiplos uploads, especificando propriedades diferentes em cada arquivo:
- CSV 1 - propriedades 1-199
- CSV 2 - propriedades 200-260
Coluna de e-mail não encontrada
Isso significa que o sistema de importação não conseguiu identificar nenhuma coluna em seu CSV como o campo de e-mail, então ele não sabe qual valor usar como o identificador único do contato.
Isso geralmente acontece em um destes casos:
1) O arquivo não tem nenhuma coluna de e-mail
Cabeçalho:
firstname,lastname,city
Simplesmente não há coluna que contenha e-mails → Coluna de e-mail não encontrada.
Correção: Adicione uma coluna de e-mail:
e-mail,firstname,lastname,city
2) O arquivo tem e-mails, mas o nome do cabeçalho não é reconhecido
O cabeçalho do exemplo usa um nome não padrão:
contact_address,firstname,lastname john@exemplo.com,John,Doe
O importador detecta automaticamente apenas cabeçalhos como e-mail / E-mail → Coluna de e-mail não encontrada.
Correção: Renomeie o cabeçalho para e-mail.
3) O arquivo não tem linha de cabeçalho (a primeira linha contém dados)
john@exemplo.com,John,Doe jane@exemplo.com,Jane,Doe
Se o importador espera uma linha de cabeçalho, ele não consegue “ver” uma coluna de e-mail → Coluna de e-mail não encontrada.
Correção: Adicione uma linha de cabeçalho:
e-mail,firstname,lastname john@exemplo.com,John,Doe
4) O delimitador errado torna o cabeçalho ilegível
O cabeçalho é separado por ponto e vírgula, mas o restante do CSV é separado por vírgulas (ou vice-versa):
e-mail;firstname;lastname john@exemplo.com,John,Doe
Isso faz com que as linhas sejam analisadas de forma diferente do cabeçalho e leve a um erro.
Correção: Use apenas um delimitador em todo o arquivo (cabeçalho + todas as linhas).
Importação abortada
Normalmente, quando muitos erros são encontrados (1000 erros ou 10% da lista importada, o que for maior).
Caractere UTF-8 inválido na linha X
O arquivo não é UTF-8 válido (codificação incorreta ou caracteres corrompidos) nessa linha.
Exemplo 1 (típico): arquivo salvo em Windows-1252, contém “cotações inteligentes”
A linha do seu CSV pode parecer correta no Excel, mas as cotações são “curvas”:
john@exemplo.com,John,“Marketing team”
Essas cotações curvas (“ ”) são comuns quando o texto é copiado do Word/Outlook e o arquivo não é salvo como UTF-8. O importador então sinaliza: Caractere UTF-8 inválido na linha X.
Correção: Reexporte como CSV UTF-8 (ou abra em um editor de texto e salve como UTF-8).
Exemplo 2 (comum com cirílico): arquivo salvo em Windows-1251, contém cirílico
ivan@exemplo.com,Иван,София
Se o arquivo for Windows-1251, mas o importador esperar UTF-8, os bytes para Иван / София não serão decodificados corretamente e você receberá: Caractere UTF-8 inválido na linha X.
Correção: Salve/exporte o CSV como UTF-8.
Exemplo 3 (byte corrompido): “caractere de substituição” ou símbolo estranho aparece
john@exemplo.com,John,ACME Ltd
O geralmente indica bytes corrompidos/inválidos durante a conversão. Essa linha pode acionar o erro de UTF-8.
Correção: Remova/substitua o símbolo incorreto e salve como UTF-8.
Muitas colunas na linha X
Essa linha tem mais valores do que o cabeçalho exige, geralmente devido a delimitadores ausentes ou aspas/novas linhas quebradas.
Como isso funciona na prática
Cabeçalho (espera 3 colunas, separadas por vírgulas):
email,firstname,lastname
Linha incorreta (, extra → 4 colunas):
john@exemplo.com,John,,Doe
Se o valor do meio não for intencional, corrija-o:
john@exemplo.com,John,Doe
Se for um campo do meio vazio que é intencional, seu cabeçalho/mapeamento também deve incluir essa coluna.
Poucas colunas na linha X
Essa linha tem menos valores do que o cabeçalho exige, geralmente devido a delimitadores ausentes ou aspas/novas linhas quebradas.
Como isso funciona na prática
Cabeçalho (espera 4 colunas):
email,firstname,lastname,city
Linha incorreta (apenas 3 colunas → “poucas colunas”):
john@exemplo.com,John,Sofia
Aqui, o valor de lastname está ausente (ou um delimitador está ausente), então a linha tem apenas 3 campos em vez de 4.
Formato de e-mail incorreto (campo: e-mail)
O valor de e-mail nessa linha não é um endereço de e-mail válido (@ ausente, espaços, caracteres inválidos, múltiplos e-mails, etc.).
Exemplos comuns que o acionam
Ausente @:
john.exemplo.com
Parte do domínio ausente:
john@
Espaços (geralmente de copiar/colar):
john @exemplo.com
Espaços no início/fim (podem ser invisíveis):
" john@exemplo.com "
Caracteres inválidos:
john<>@exemplo.com
Dois e-mails em uma célula:
john@exemplo.com; jane@exemplo.com
Nome de exibição em vez do endereço bruto:
John Doe <john@exemplo.com>
Como corrigir
Certifique-se de que a célula contenha apenas um e-mail no formato padrão:
john@example.com
(Apare os espaços, remova nomes/colchetes e divida múltiplos e-mails em linhas separadas.)
E-mail duplicado (campo: e-mail)
O mesmo e-mail aparece mais de uma vez no arquivo carregado.
Parte local muito longa (campo: e-mail)
A parte antes de @ é mais longa do que o permitido, muitas vezes causada por mapeamento de coluna incorreto ou dados inválidos na coluna de e-mail. Mapeie a coluna de e-mail correta e corrija o valor.
Domínio muito longo (campo: e-mail)
A parte depois de @ é mais longa que o permitido, muitas vezes causada por mapeamento incorreto ou valores de e-mail malformados. Mapeie corretamente e corrija o e-mail.
Não foi possível converter o valor (NomeDoCampo)
Esses erros significam que a propriedade existe, mas o valor na linha não pode ser armazenado porque não corresponde ao tipo da propriedade no banco de dados. Formate o valor corretamente (por exemplo, datas válidas, números apenas numéricos).
Exemplo (propriedade de número inteiro)
Propriedade: age é inteiro
A linha do CSV contém:
email,age john@exemplo.com,abc
→ a conversão falha porque abc não é um número inteiro.
Correção:
john@exemplo.com,43
Exemplo (propriedade de data)
Propriedade: birthdate espera uma data
email,birthdate john@exemplo.com,today
→ formato/valor de data inválido.
Correção (use o formato esperado):
john@exemplo.com,2026-03-06
Erro de validação de propriedade (NomeDoCampo)
Este erro significa que o nome da propriedade do contato retirado do cabeçalho do seu CSV não é permitido, então o sistema não pode criar/mapear essa propriedade.
1) Caractere inválido no nome na posição N: X
Significado: O nome da propriedade (cabeçalho da coluna) contém um caractere proibido na posição N.
Exemplo (cabeçalho incorreto):
email,first-name john@exemplo.com,John
Se - não for permitido → caractere inválido.
Correção: Renomeie o cabeçalho usando caracteres permitidos (geralmente letras/sublinhado):
email,first_name
2) Números não podem ser usados como nomes: X
Significado: O nome da propriedade não pode ser apenas numérico (ou não pode começar com um número, dependendo das regras).
Exemplo (cabeçalho incorreto):
email,123 john@exemplo.com,test
Correção:
email,field_123
3) Nome inválido: X é uma palavra reservada.
Significado: O cabeçalho corresponde a uma palavra-chave reservada que o sistema não permite como nome de propriedade.
Exemplo (cabeçalho incorreto):
email,class john@exemplo.com,A
Correção: Renomeie o cabeçalho:
email,customer_class
O cabeçalho mapeado tem menos colunas do que o cabeçalho no arquivo
Ao importar um arquivo CSV, o sistema primeiro lê a linha do cabeçalho — os nomes das colunas na parte superior do arquivo. Na tela de importação, ele tenta corresponder cada coluna a uma propriedade de contato existente, ou sugere criar uma nova com um tipo de dados apropriado.
Este processo é chamado de cabeçalho mapeado. Ele define como as colunas do seu arquivo CSV correspondem aos campos que o Mailjet usará durante a importação.
Se o cabeçalho mapeado não corresponder ao cabeçalho real no arquivo, a importação não poderá continuar e será interrompida imediatamente.
Se você encontrar este erro, entre em contato com nossa equipe de suporte para obter mais assistência.
O cabeçalho mapeado tem mais colunas do que o cabeçalho no arquivo
Ao importar um arquivo CSV, o sistema primeiro lê a linha do cabeçalho — os nomes das colunas na parte superior do arquivo. Na tela de importação, ele tenta corresponder cada coluna a uma propriedade de contato existente, ou sugere criar uma nova com um tipo de dados apropriado.
Este processo é chamado de cabeçalho mapeado. Ele define como as colunas do seu arquivo CSV correspondem aos campos que o Mailjet usará durante a importação.
Se o cabeçalho mapeado não corresponder ao cabeçalho real no arquivo, a importação não poderá continuar e será interrompida imediatamente.
Se você encontrar este erro, entre em contato com nossa equipe de suporte para obter mais assistência.