Tradução por IA e SEO: guia completo
Instalar, configurar e explorar a tradução e a otimização de SEO por IA dos seus produtos, categorias, páginas CMS e marcas, para PrestaShop 8 e 9.
Este módulo traduz e melhora o conteúdo e os dados de SEO dos seus produtos, categorias, páginas CMS e marcas com a IA à sua escolha, seja o ChatGPT (OpenAI), o Claude (Anthropic), o Gemini (Google) ou o Mistral, em todos os idiomas instalados na sua loja PrestaShop 8 ou 9. Foi pensado para quem gere a loja: assinala-se, escolhem-se os idiomas e lança-se.
Em resumo: ligue a sua chave de API, selecione fichas, escolha o idioma de origem e os idiomas de destino e clique em Executar. Uma barra de progresso trata cada ficha e cada idioma sem tempo esgotado no servidor. Inclui pré-visualização antes e depois, pontuação de SEO e reversão com um clique.
Instalação
- No back-office, vá a Módulos > Gestor de módulos, clique em Carregar um módulo e envie o ficheiro
dfaicontent-1.1.0.zip. - Depois de instalado, aparece um separador Conteúdo IA e SEO em Catálogo.
- Abra o separador Parâmetros para configurar pelo menos um fornecedor de IA antes da primeira utilização.
Configurar um fornecedor de IA
O módulo é compatível com quatro fornecedores. Usa a sua própria chave de API e paga a IA ao consumo diretamente ao fornecedor, sem qualquer subscrição adicional cobrada pelo módulo.
- Fornecedor ativo: o fornecedor usado nas gerações.
- Chave API e Modelo por fornecedor: por exemplo,
gpt-4o-mini(OpenAI),claude-sonnet-4(Anthropic),gemini-2.0-flash(Google) oumistral-small-latest(Mistral). - Clique em Testar junto de cada fornecedor para verificar a ligação.
Para controlar o orçamento, comece com um modelo económico (Mistral Small, GPT-4o mini). A tradução completa de uma ficha de produto custa tipicamente uma fração de cêntimo.
Executar uma tradução (3 passos)
- Assinale os produtos ou as categorias na lista (a pesquisa por nome ou por ID ajuda a filtrar).
- Na barra de ação, defina o idioma de origem, os idiomas de destino, os campos a tratar, o modo e a velocidade (1 a 3 pedidos em paralelo).
- Clique em Executar. É apresentada uma estimativa dos tokens e do custo para confirmação, e a fila corre depois com uma barra de progresso e um registo.
Os três modos
- Traduzir: tradução fiel do idioma de origem para cada idioma de destino.
- Traduzir e melhorar (predefinição): tradução seguida de reescrita comercial e de SEO.
- Melhorar (no mesmo idioma): reescreve cada idioma de destino no lugar; o idioma de origem é ignorado.
Campos suportados
- Produtos: nome, descrição curta, descrição, meta título, meta descrição, URL amigável, etiquetas (palavras-chave) e atributos alt das imagens.
- Categorias: nome, descrição, descrição adicional, metadados e URL amigável.
- Páginas CMS: conteúdo, meta título, meta descrição e URL amigável.
- Marcas: descrições curta e longa, meta título e meta descrição.
O PrestaShop 8 eliminou o campo meta keywords: o módulo gera etiquetas de produto em substituição. Numa loja migrada em que a coluna ainda exista, é detetada e proposta automaticamente.
Ao traduzir para português, escreva nas instruções personalizadas que pretende português europeu, nunca do Brasil. Sem essa indicação, os modelos tendem a produzir formas brasileiras («usuário», «tela», «time») que destoam numa loja portuguesa. Verifique também a concordância do tratamento: escolha entre «você» e a forma impessoal e mantenha-a em todo o catálogo.
Os URL amigáveis gerados perdem os acentos, o que é o comportamento correto: um slug do tipo sapatilhas-de-pele é preferível a uma versão acentuada. Confirme, ainda assim, que a tradução não gera colisões com slugs já existentes noutro idioma antes de aplicar um lote grande.
Pré-visualização antes e depois
O botão Pré-visualizar numa linha gera o conteúdo sem gravar nada e mostra uma comparação antes e depois. Se o resultado servir, Aplicar este conteúdo grava exatamente o que foi pré-visualizado, sem uma segunda chamada à IA e, portanto, sem custo adicional. Teste sempre uma ficha em pré-visualização antes de um lote grande.
Pontuação de SEO
O botão SEO em cada linha calcula uma pontuação de 0 a 100 por idioma, com uma lista de verificação detalhada: comprimento do meta título e da meta descrição, presença da palavra-chave no início do título, riqueza do conteúdo, subtítulos, validade do slug, número de etiquetas e cobertura dos atributos alt.
Compatibilidade com o Creative Elements
As descrições construídas com o Creative Elements (ou com o Elementor) estão protegidas por dois mecanismos:
- Tokenização: os scripts, estilos, iframes, SVG, shortcodes
[...]e marcadores{...}são substituídos por tokens antes do envio à IA e reinjetados depois tal e qual. - Instrução de sistema estrita: a IA traduz apenas o texto visível e preserva todas as etiquetas, classes, ids, estilos inline e atributos
data-*.
Se usar um widget do Creative Elements que produza um padrão não coberto, acrescente um padrão ao método protect() da classe DfAiContentProcessor.
Histórico e reversão
Cada lote fica registado com os valores antigos de todos os campos. O separador Histórico permite restaurar uma operação completa com um clique, incluindo etiquetas e atributos alt. A entrada de histórico é então eliminada.
Estimativa do custo
Antes de cada execução, o módulo mede o volume real dos conteúdos selecionados na base de dados e mostra o número de chamadas, os tokens estimados de entrada e de saída e o custo correspondente, segundo os preços por milhão de tokens que configurou nos parâmetros.
Cron de tradução automática
O módulo pode traduzir automaticamente os novos conteúdos:
- Em Parâmetros > Cron, ative o cron e defina o idioma de origem, os idiomas de destino, os campos, os tipos e o limite por execução.
- Copie o URL protegido por token e chame-o a cada 5 a 15 minutos a partir do agendador do seu alojamento.
Em cada passagem, o módulo deteta as fichas cuja origem tem conteúdo mas cujos destinos não têm meta título nem descrição, e traduz um pequeno lote. Uma lista de exclusão evita repetir indefinidamente uma ficha com erro; o registo da última passagem é apresentado nos parâmetros.
Se regenerar o token, o URL de cron antigo deixa imediatamente de funcionar: lembre-se de atualizar o agendador.
Definições editoriais
- Termos protegidos: marcas e nomes de produtos que nunca são traduzidos (um por linha).
- Glossário: traduções impostas, uma regra por linha, no formato
termo de origem => tradução. - Tom de escrita, comprimentos máximos de SEO e instruções personalizadas próprias da sua loja.
O glossário é o lugar certo para fixar o vocabulário português do seu setor e evitar oscilações entre lotes: por exemplo, livraison => entrega, panier => carrinho, avis => avaliações, devis => orçamento. Acrescente também as formas que quer excluir, escrevendo a versão correta do lado direito.
Resolução de problemas
- «Source content is empty»: a ficha não tem conteúdo no idioma de origem escolhido. Selecione outro idioma de origem.
- Erro de chave de API: verifique a chave e o modelo em Parâmetros e use depois o botão Testar.
- Um idioma de destino igual ao de origem é automaticamente ignorado no modo Traduzir.
Notas técnicas
- Compatível com PrestaShop 8.0 a 9.x, sem overrides do núcleo (controlador de administração e mecanismos nativos).
- Atua na loja do contexto atual, em multiloja.
- Sem dependências Composer; os conteúdos são enviados apenas à API do fornecedor escolhido, através da sua chave.
Os conteúdos enviados são descrições de catálogo, não dados pessoais de clientes. Ainda assim, se colocar informação identificável numa descrição (o nome de um artesão, por exemplo), tenha presente que ela é transmitida ao fornecedor de IA escolhido, e mencione esse subcontratante no seu registo de atividades de tratamento, sob supervisão da CNPD.