5 erros de tradução de CSV que quebram a sua importação (e como evitá-los)

O ponto principal: A falha na importação de CSV é geralmente causada por corrupção estrutural e não por uma má tradução: ao utilizar uma ferramenta que protege IDs, handles e tags HTML, enquanto impõe a codificação UTF-8, elimina o atrito técnico da localização em massa.

O CSV parece idêntico ao original. A importação falha na mesma. É assim que a maioria dos projetos de tradução em massa desperdiça um fim de semana. Muitas vezes é porque a equipa não utilizou o melhor software de tradução de sites para as suas necessidades técnicas específicas.

Uma importação de CSV quebrada quase nunca apresenta um erro claro. Em vez disso, obtém um produto Shopify com um SKU em falta, um item do Webflow CMS com um slug 404, ou uma aplicação SaaS onde cada etiqueta alemã é subitamente o dobro do tamanho do botão que a contém. O dano é feito silenciosamente e só o nota quando um cliente o faz. Isto sublinha por que a tradução de sites é importante e por que deve compreender os benefícios do SEO multilingue antes de escalar.

Já vi isto acontecer em projetos reais mais vezes do que consigo contar. Os cinco erros abaixo são os que voltam vezes sem conta, e a boa notícia é que são todos evitáveis com o fluxo de trabalho de tradução de CSV correto. Seguir um guia adequado de tradução de sites para SEO e compreender a definição de SEO multilingue ajudá-lo-á a evitar estas armadilhas técnicas.

Erro 1: Traduzir colunas que devem permanecer intocadas

Este é o erro mais comum e geralmente acontece quando alguém entrega um CSV completo ao ChatGPT ou ao DeepL e deixa o modelo decidir o que é “texto”, o que é uma das muitas razões pelas quais as ferramentas de IA genéricas falham na localização estruturada.

A armadilha: um ID, um handle, um SKU, um URL ou uma coluna de preço é traduzido juntamente com o conteúdo real. O ficheiro é importado sem erros, mas agora cada linha aponta para o produto errado, para a página errada ou para um link quebrado.

Exemplos reais que já vi:

• Uma exportação do Shopify onde o vendor foi traduzido de “Nike” para “Nique” em francês. Todos os produtos Nike desapareceram do filtro da marca de um dia para o outro.
• Um Webflow CMS onde a coluna slug foi traduzida, quebrando 400 links internos e cada backlink que a empresa tinha conquistado.
• Um ficheiro de strings de uma aplicação SaaS onde a coluna key (o identificador voltado para o programador) foi traduzida, resultando numa aplicação carregada com literalmente zero strings correspondentes, onde cada etiqueta da interface voltou para o inglês.

Como evitá-lo: nunca utilize uma ferramenta que traduz “tudo por padrão”. Com o AI Glot, o modo Colunas Selecionadas força-o a marcar explicitamente quais as colunas que são traduzíveis. IDs, handles, preços, URLs e SKUs permanecem byte a byte idênticos à origem. A estrutura que o seu CMS ou loja espera é garantida.

Erro 2: Corromper tags HTML dentro do texto traduzido

Este erro é o que mais dói porque parece correto até pré-visualizar a página.

Quando uma ferramenta de tradução de sites como o Weglot exporta o seu CSV, as células de conteúdo raramente são apenas texto simples. Estão cheias de tags inline: <wg-1>, <wg-2>, <strong>, <a href="...">. Estas tags envolvem um conjunto de palavras para estilização ou links. O trabalho do tradutor não é apenas traduzir as palavras, mas mover as tags para que continuem a envolver o conjunto equivalente no idioma de destino.

É aqui que o DeepL, as ferramentas de IA genéricas e até tradutores freelancers humanos têm dificuldade:

• O inglês “Click here to learn more” torna-se no alemão “Klicken Sie hier, um mehr zu erfahren”, mas o modelo perde a tag, envolve a palavra errada ou duplica-a.

• Quando uma frase em inglês se torna duas palavras em alemão, ou vice-versa, o limite da tag tem de mudar. Um tradutor ingénuo mantém a tag no lugar errado (o link está agora na palavra errada) ou remove-a (o link desapareceu completamente).

Eu próprio já passei por esta dor de cabeça: uma ronda de tradução que parecia perfeita na folha de cálculo mas que, uma vez reimportada, produziu páginas onde o botão de chamada para ação (CTA) já não estava ligado, ou onde a estilização em negrito caiu na metade errada da frase.

Como evitá-lo: utilize uma ferramenta que compreenda a preservação de tags como uma funcionalidade central. O AI Glot foi construído em torno da tradução nativa de CSV, por isso trata as tags inline como elementos estruturais que devem envolver o equivalente semântico no idioma de destino. E se tiver uma regra específica para um lote (como “nunca quebrar as tags <wg-cta>”), pode adicioná-la diretamente através de instruções por lote antes de lançar, além do glossário do workspace.

Erro 3: Perder a codificação UTF-8 (também conhecido como o desastre do carater ”?”)

Se alguma vez abriu um CSV traduzido no Excel e viu uma linha de ? ou é onde deveriam estar acentos franceses, já encontrou este erro.

Os ficheiros CSV são sensíveis à codificação de carateres. Quando um ficheiro se move entre o Excel, Google Sheets, uma janela de chat de um LLM e volta, a codificação pode mudar silenciosamente de UTF-8 para um padrão regional (Windows-1252, ISO-8859-1, etc.). Assim que isso acontece, cada carater acentuado nas suas traduções em alemão, francês, espanhol ou polaco fica corrompido.

Como evitá-lo:

• Exporte e reimporte sempre como UTF-8 com BOM sempre que a sua plataforma o suporte.
• Evite passar pelo Excel para idiomas com carateres não-ASCII; prefira o Google Sheets ou um editor nativo de CSV.
• Utilize uma plataforma de tradução que preserve explicitamente o UTF-8 em todo o processo. O AI Glot lê, processa e escreve em UTF-8 por padrão, para que o ficheiro que descarrega esteja pronto para importação.

Erro 4: Traduzir os cabeçalhos das colunas quando não era essa a intenção

Os cabeçalhos são identificadores de campos que o seu sistema de importação lê para saber o que cada coluna significa. Se title se tornar titre ou body_html se tornar corps_html, o seu CMS não reconhecerá o ficheiro e a importação falhará imediatamente ou, pior, colocará os dados nos campos errados.

Isto é exatamente o que acontece quando alguém cola um CSV no ChatGPT e pede para “traduzir isto para francês”. O modelo não tem forma de saber que a linha 1 é estrutural e que as linhas 2 em diante são conteúdo.

Como evitá-lo:

• Seja explícito sobre o âmbito. O modo Colunas Selecionadas do AI Glot traduz os valores nas colunas que escolher e não altera os cabeçalhos. O modo CSV Completo é uma escolha deliberada para ficheiros onde os cabeçalhos devem realmente ser traduzidos (uma tabela de dados pública, por exemplo).
• Em caso de dúvida, passe o ficheiro pelo passo de revisão primeiro. Confirmar que os “cabeçalhos serão preservados” antes de lançar não custa nada e salva a importação.

Erro 5: Desalinhamento de linhas causado por vírgulas ou carateres novos

O assassino silencioso: o ficheiro parece bem e a contagem de linhas está correta, mas algures no meio uma tradução introduziu uma vírgula, uma aspa ou uma quebra de linha que não foi escapada corretamente. A partir dessa linha, cada célula é deslocada uma coluna para a esquerda ou para a direita. O CMS importa o ficheiro sem se queixar e os títulos dos seus produtos estão agora na coluna do preço.

Isto acontece porque:

• As ferramentas de IA por vezes “melhoram” a pontuação quando traduzem (transformando " em " ou «), o que quebra as regras de escape do CSV.
• As traduções podem introduzir naturalmente vírgulas onde a origem não tinha nenhuma (“Hello world” → “Olá, mundo”).
• Traduções longas ocasionalmente incluem quebras de linha que o redator não notou.

Como evitá-lo: utilize uma ferramenta que gira o escape de CSV ao nível estrutural e não apenas como texto simples. O AI Glot escreve uma saída corretamente escapada (campos entre aspas, aspas escapadas, quebras de linha preservadas dentro das células) para que o que reimporta esteja byte-correto.

O quadro geral: por que os modos de tradução importam

Se leu até aqui, provavelmente notou um padrão: cada um destes erros vem de uma ferramenta que não sabe que partes do seu CSV são conteúdo e que partes são estrutura. As ferramentas gerais de chat de IA não fazem esta distinção. Mesmo algumas plataformas de tradução confundem-na.

É exatamente por isso que o AI Glot é construído em torno de modos de tradução de CSV explícitos:

• Coluna Única: traduz uma coluna de origem para uma nova coluna de destino ou uma já existente. Perfeito para um ficheiro de glossário ou um CSV de par de idiomas.
• Colunas Multi-idioma: traduz uma coluna de origem para várias colunas de idiomas existentes. Perfeito para folhas de cálculo com cabeçalhos como Inglês, Espanhol, Francês e Alemão.
• Colunas Selecionadas: traduz um subconjunto escolhido de colunas no lugar, deixando tudo o resto intocado. O modo correto para Webflow CMS, Shopify, WordPress ou qualquer exportação de CMS onde a maioria das colunas são metadados estruturais.
• CSV Completo: traduz cada célula e cada cabeçalho. Reservado para ficheiros onde todo o conteúdo é genuinamente traduzível (um ficheiro de strings de uma aplicação simples, por exemplo).

Combine isto com instruções por lote (como “preserve estas tags” ou “não traduza o nome desta marca”) e um glossário do workspace que se aplica automaticamente entre pares de idiomas, e os cinco erros acima tornam-se estruturalmente impossíveis em vez de erros que tem de se lembrar de evitar.

Quando os CSVs são a ferramenta de eleição

Uma nota honesta antes de fecharmos. A tradução em massa baseada em CSV não é a resposta certa para tudo.

• Para um comunicado de imprensa, uma página inicial ou uma página de produto principal, contrate um tradutor humano profissional. Eles trazem conhecimento da marca e da indústria, e a competência linguística para levar a mensagem no idioma de destino. Nenhuma IA replicará isso para cópias de alto risco.
• Para alguns parágrafos de texto pontual, o ChatGPT ou o Claude funcionam bem. Terá algum trabalho manual de configuração de glossário e copiar/colar a saída, mas para tarefas pontuais é perfeitamente razoável.
• Para trabalho de tradução por lotes, centenas ou milhares de linhas de catálogo, CMS, blogue ou conteúdo de aplicação, é aí que o AI Glot se encaixa. Pagar 1.000€ por peça para mil peças não é um fluxo de trabalho; aprender como fazer traduções em massa é.

Uma lista de verificação que não deveria precisar de memorizar

Os cinco erros acima representam a vasta maioria das importações de CSV quebradas que vi em projetos de localização reais. Não são casos raros e obscuros, são previsíveis, e cada um deles desaparece quando a ferramenta compreende a estrutura do ficheiro que está a traduzir.

Se prefere não memorizar uma lista de verificação cada vez que traduz um ficheiro, inicie um lote gratuito no AI Glot. Modos de tradução, proteção de glossário, instruções por lote e um passo de revisão antes de gastar um único crédito. A sua reimportação agradecerá.