Solução de problemas de importações de lista
O que você vai aprender
Saiba como solucionar erros que ocorrem ao fazer upload de um CSV de contatos para uma lista nova ou existente no Klaviyo. Fazendo upload de avaliações? Acesse nosso artigo sobre como importar avaliações.
Antes de começar
Quer garantir que seu arquivo vai importar? Confira a lista de requisitos abaixo antes de importar sua lista.
- Arquivo CSV (não em nenhum outro formato)
- O tamanho do arquivo é de 50 MB ou menos
- A primeira linha contém um cabeçalho exclusivo e não vazio para cada coluna
- Cada linha tem um identificador exclusivo válido, como um endereço de e-mail, número de telefone ou ID externo
- Não há endereços de e-mail ou números de telefone duplicados
Nossa equipe de suporte não consegue importar CSVs para o Klaviyo em seu nome. Se você precisar de ajuda com uma importação, confira a seção de solução de problemas abaixo para ver dicas de como solucionar problemas de importação de listas com sucesso.
Está com problemas para fazer upload de uma lista de perfis com consentimento de SMS? Confira o guia da Klaviyo para fazer upload de uma lista de contatos de SMS.
Índice
- Atraso na importação
- Solução de problemas de importação
- Todas as colunas importadas como um único campo
- Mensagens de erro de formato inválido
- Formatação incorreta de data ou carimbo de data/hora
- Mensagens de erro de identificador único duplicado ou ausente
- Valor ausente em um campo obrigatório
- Problemas de formatação de número de telefone
Atraso na importação
Se você importar um arquivo grande com uma quantidade significativa de dados, o processo de importação pode levar várias horas para ser concluído. Infelizmente, não há como acelerar esse processo depois que ele começa. No entanto, uma forma de agilizar o processo de importação com antecedência é remover todos os e-mails duplicados do seu CSV antes de importar. Recomendamos fortemente que você planeje importar uma nova lista com pelo menos 1 dia de antecedência em relação ao momento em que pretende enviar e-mails para os contatos da lista.
Depois que uma importação começar, você verá inicialmente uma barra de status. Se você sair dessa tela, abra a lista e selecione a aba Importações para verificar o andamento e os resultados. Vamos enviar um e-mail assim que uma importação de lista for concluída.
Solução de problemas de importação
Se o upload do seu arquivo falhar ou algumas linhas forem ignoradas, confira os erros comuns abaixo. Para encontrar e corrigir as linhas ignoradas depois que uma importação terminar:
- Abra a lista e selecione a aba Importações.
- Para uma importação marcada como Concluída com erros, clique em Baixar arquivo de erro se o botão estiver disponível.
- Use a coluna Erros no CSV baixado para identificar e corrigir as linhas afetadas. Remova as colunas Erros e Avisos do arquivo corrigido para que elas não sejam importadas como Propriedades do perfil.
- Clique em Fazer upload de novo arquivo e faça upload do seu CSV corrigido. Mapeie as colunas dele, revise as configurações de consentimento e clique em Importar para iniciar a importação.
Se Baixar arquivo de erro não estiver disponível, confira o CSV original com base nas orientações de solução de problemas abaixo e corrija-o antes de fazer upload novamente.
Todas as colunas importadas como um único campo
Se você estiver usando uma versão do Excel que não usa o inglês como idioma padrão, seu software pode usar ponto e vírgula, e não vírgulas, como separador no seu arquivo. Se esse for o caso, seu arquivo pode ficar assim ao importar:

Para corrigir isso, acesse a configuração Formato de número ou Separador de lista (ou de número) do seu computador. Essa configuração provavelmente está em Idioma e região e pode ficar na seção Configurações avançadas. Substitua o ponto e vírgula por uma vírgula e salve. Agora, quando você exportar arquivos como CSV, eles vão usar o formato com vírgula. Atenção: o local exato dessa configuração pode variar de acordo com o sistema operacional.

Além disso, confira se o seu CSV está de acordo com os requisitos de formatação da Klaviyo. Se você ainda não fez isso, acesse nossa documentação sobre como formatar seus dados. Cada linha precisa de um identificador exclusivo válido; um endereço de e-mail não é obrigatório quando outro identificador aceito é fornecido.
Solução de mensagens de erro de formato inválido
Quando você importa uma lista para a Klaviyo, a página de mapeamento de campos permite que você associe quaisquer propriedades ao tipo de dados correspondente na Klaviyo. Por exemplo, E-mail sempre tem um tipo de dados Texto; já se você fizer upload de uma propriedade personalizada para Aniversário, convém definir o tipo de dados como Data.
Revise os tipos de dados, os formatos de propriedade de consentimento e os exemplos abaixo.
- Texto
Qualquer texto ou combinação de texto e números. Se você não tem certeza de qual é o formato dos seus dados, escolha esta opção.- Exemplos:
exemplo@exemplo.com
Olá, mundo
$ 5,00
- Exemplos:
- Número
Todos os números. Não inclua símbolos de moeda em campos numéricos.- Exemplos:
2
5,0031
130,0
- Exemplos:
- Booleano
Valores verdadeiros ou falsos.- Exemplos:
verdadeiro
falso
- Exemplos:
- Data
Consulte nosso guia sobre formatos aceitáveis de data e hora para propriedades de perfil e eventos para saber mais sobre os formatos de data aceitos.- Exemplo:
01-09-2014 13:34:08
- Exemplo:
- Lista
Os dados devem ser formatados como uma matriz JSON.- Exemplos:
["apples","bananas","oranges"]
["apples"]
- Exemplos:
- Propriedades de consentimento
Mapeie cada coluna de consentimento para a propriedade do respectivo canal e tipo de consentimento, como Consentimento para marketing por e-mail, Consentimento para marketing por SMS ou Consentimento transacional por SMS. Essas propriedades usam o tipo de dados Texto. Insira "inscrever-se", "Never Subscribed" ou "cancelar inscrição" como valor.
Para saber mais sobre o que envolvem os diferentes tipos de dados e qual selecionar ao importar sua lista, acesse nosso guia sobre como entender tipos de dados.
Para saber mais sobre mensagens de erro de "Formato inválido de [tipo de dados]" (por exemplo, "Formato de lista inválido"), acesse nosso guia de solução de problemas para mensagens de erro de formato inválido.
Formatação incorreta de data ou carimbo de data/hora
Você pode estar usando o formato errado para datas ou carimbos de data/hora. Se você incluiu um deles e não tem certeza sobre os formatos aceitos pela Klaviyo, acesse nosso guia sobre formatos de data e carimbo de data/hora aceitáveis para propriedades de perfil e evento.
Se você receber um erro de carimbo de data/hora de consentimento inválido, verifique se o carimbo de data/hora corresponde ao momento em que o consentimento foi dado e se é em 01/01/1990 ou depois. Verifique também o fuso horário: um carimbo de data/hora sem um deslocamento é interpretado como UTC, o que pode fazer com que um horário local pareça estar no futuro.
Como resolver mensagens de erro de identificador exclusivo duplicado ou ausente
Identificadores duplicados
Erros de identificador duplicado significam que várias linhas usam o mesmo identificador de perfil, como um endereço de e-mail ou número de telefone. O Klaviyo pode pular linhas duplicadas, e você não deve contar que a primeira linha do seu arquivo será importada. Consolide os detalhes de cada contato em 1 linha antes de importar novamente.
Clique em Baixar arquivo de erros, se disponível, para revisar as linhas ignoradas devido a identificadores duplicados. Confira os detalhes que você quer manter antes de reenviar o arquivo, já que os valores importados podem atualizar um perfil existente.
Identificadores exclusivos ausentes
Um erro de identificador exclusivo ausente significa que uma linha ignorada não continha um endereço de e-mail, número de telefone ou outro identificador exclusivo aceito.
Clique em Baixar arquivo de erro, se disponível, para revisar as linhas ignoradas devido à falta de identificadores. Adicione um identificador válido para cada contato e garanta que a coluna dele esteja mapeada para a propriedade Klaviyo correspondente antes de reenviar o arquivo.
Valor ausente em um campo obrigatório
Verifique os campos obrigatórios para as informações que você está importando. Por exemplo, uma linha com consentimento de e-mail precisa de um endereço de e-mail, e uma linha com consentimento de SMS precisa de um número de telefone. Preencha o valor que está faltando ou remova as informações de consentimento que não se aplicam a esse contato antes de fazer o upload novamente.
Endereço de e-mail inválido ou caracteres não reconhecidos
Se você receber esta mensagem de erro, verifique se os endereços de e-mail no seu arquivo têm caracteres inválidos. Os caracteres inválidos incluem ( ) , : ; [ ], bem como espaços.
Para manter a segurança dos seus dados, a equipe de suporte da Klaviyo não pode abrir seus arquivos CSV. Para resolver problemas de importação de listas, forneça uma descrição detalhada e prints do erro à equipe de suporte.
Transferência de perfis entre contas
Ao transferir perfis de uma conta para outra, há algumas propriedades que não podem ser carregadas em outra conta.
Por exemplo, Perfil criado em não pode ser transferido porque está definido como a data em que um perfil é criado na conta. Outro conjunto de exemplos é Primeira vez com atividade e Última vez com atividade, pois eles são definidos automaticamente com base na atividade do perfil na conta.
Problemas de formatação de número de telefone
Os números de telefone devem incluir um código do país ou uma coluna separada indicando o país e devem seguir um formato de número de telefone aceito. Saiba como formatar e fazer upload de números de telefone corretamente.
Recursos adicionais
- Como importar assinantes para uma lista
Saiba como adicionar assinantes a uma lista no Klaviyo. Fazer upload de contatos é essencial no Guia de introdução ao Klaviyo, principalmente se você estiver migrando de outro provedor de serviços ou importando informações de terceiros.
- Formatos aceitáveis de data e carimbo de data/hora para referência de Propriedades do perfil e propriedades de eventos
Saiba quais formatos de data e hora a Klaviyo reconhece em dados de eventos e de perfil enviados pelas nossas APIs ou em um upload de CSV. Observe que isso não se aplica a um carimbo de data/hora de evento enviado pela Track API, que deve ser o horário Unix em segundos.