1. Introdução
O módulo Mass Translate by ChatGPT no Magento 2 permite a tradução automática de descrições de produtos, possibilitando adaptar rapidamente a oferta a novos mercados. Os conteúdos traduzidos são guardados no store view selecionado.
Instalação do módulo
Para instalar o módulo, basta:
- Instale o módulo: - Adicione o repositório composer à configuração, executando
composer config repositories.masstranslatebychatgpt vcs https://github.com/kowalco/magento-2-mass-product-translate-by-chatgpt
Adicione o token de acesso ao repositório privadocomposer config --global --auth github-oauth.github.com <YOUR_TOKEN>
Instale o módulo composer executandocomposer require kowal/module-masstranslatebychatgpt
Ative o módulo executandophp bin/magento module:enable Kowal_MassTranslateByChatGPT
- Execute os comandos:
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush bin/magento indexer:reindex sales_order_grid
2. Configuração do módulo
Para configurar o módulo, aceda a:
Admin Panel Magento 2 → Stores → Configuration → KOWAL → Mass Translate by ChatGPT - Settings
ou
Admin Panel Magento 2 → KOWAL.co → Mass Translate by ChatGPT - Settings
2.1. Definições gerais (General Settings)
- Enable Module – Ativa ou desativa o módulo.
- OpenAI API Key – Chave API para comunicação com o ChatGPT, que pode gerar aqui
- Max Translations per Day – Número máximo de produtos para tradução por dia.
Define o limite de produtos que podem ser traduzidos no período de um dia. O limite depende do tamanho das descrições dos produtos.
2.2. Definições de tradução (Translation Settings)
- Source Language (Língua de origem) – Seleção da língua e do Store ID.
Selecione a língua a partir da qual os conteúdos serão traduzidos.
Importante! A seleção da língua significa simultaneamente a seleção do Store ID, ou seja, o store view a partir do qual serão obtidos os textos originais.
- Target Language (Língua de destino) – Seleção da língua de destino e do Store View.
Selecione a língua para a qual os produtos devem ser traduzidos.
Importante! A definição da língua de destino significa também a seleção do store view no qual os conteúdos traduzidos serão guardados.
- AI Model Instructions – Instruções para o ChatGPT.
Pode adaptar os comandos para o ChatGPT.
Exemplo: Traduz os atributos indicados de polaco para inglês.
- AI Model – Seleção do modelo AI.
- Attributes to Translate – Lista de atributos a traduzir.
Defina quais os campos dos produtos que devem ser traduzidos, por exemplo:
Description (Descrição do produto)
Image Label (Etiqueta da imagem)
Instrukcja (Instrução de utilização)
Kompatybilność (Dados de compatibilidade)
3. Execução da tradução de produtos
- Aceda a Catalog -> Products.
- Selecione os produtos a traduzir assinalando a checkbox junto deles
- Escolha a opção de tradução em massa.
Clique no menu de ações e selecione o comando relacionado com a tradução.
O sistema iniciará o processamento e os produtos serão enviados para a OpenAI.
- Será automaticamente redirecionado para a secção de Tarefas para acompanhar o progresso.
4. Monitorização das tarefas de tradução (Translations)
Para verificar o estado das tarefas:
- Aceda à secção Translations.
- Aí encontrará a lista de todas as traduções solicitadas com os detalhes:.
Status – completed (concluído) ou error (erro).
Produtos – quantos produtos foram traduzidos.
ChatGPT Model – qual o modelo AI utilizado.
Tokens Input/Output – quantidade de tokens processados no pedido.
Instruction – comando AI aplicado.
Language From / Language To – língua de origem e de destino.
Estados das tarefas
completed – tradução concluída com sucesso.
error – erro de tradução.
Se a tradução não tiver sido bem-sucedida, verifique:
Se a chave API OpenAI introduzida está correta.
Se o modelo AI selecionado é suportado.
Se o limite diário de traduções não foi excedido.
5. Visualização e gravação dos conteúdos traduzidos (Product Tasks)
- Aceda à secção Product Tasks.
- Aí encontrará dados detalhados dos produtos traduzidos
ID – identificador da tarefa de tradução.
- Status – estado da gravação do texto traduzido.
SKU – número de catálogo do produto.
Store ID – store view no qual as traduções serão guardadas.
Translated Attributes – campos do produto traduzidos.
Created At – data de execução da tradução.
6. Resumo
O módulo Mass Translate by ChatGPT automatiza as traduções de produtos, poupando tempo e recursos. É possível:
- Selecionar a língua e o Store View para as traduções.
- Monitorizar o progresso das traduções.
- As traduções guardadas ficam disponíveis no store view selecionado.
Esta solução facilita significativamente a gestão de uma oferta internacional de produtos no Magento 2.

























