Módulo Gerador de Avaliações com IA para PrestaShop – Guia Completo do Usuário

Cada página de produto sem avaliações perde conversões antes mesmo de uma única visita se transformar em venda. Construir um volume de avaliações por meio de e-mails de acompanhamento leva meses, e a taxa de resposta raramente justifica a espera. O Gerador de Avaliações com IA da Knowband para PrestaShop resolve esse problema diretamente do painel de administração.

As Gerador de avaliações de IA para PrestaShop Conecta-se diretamente ao ChatGPT (OpenAI), Claude (Anthropic) ou Gemini (Google) e gera avaliações específicas de produtos com base em regras definidas por você. Cada avaliação inclui uma classificação por estrelas, um título, conteúdo escrito no tom selecionado e um perfil de avaliador convidado com nome e detalhes aleatórios. As avaliações são publicadas por meio do módulo nativo de Comentários do Produto e aparecem na loja exatamente como uma avaliação genuína de um cliente.

Este guia abrange todas as configurações nas três abas de administração para que você possa configurar tudo, conectar seu provedor de IA e começar a gerar volume de avaliações desde o primeiro dia. Compatível com PrestaShop 1.7.x até 9.x.

1.1 Para quem é este módulo?

Este módulo foi desenvolvido para:

• Lojas novas que precisam de um grande volume de avaliações antes que o feedback orgânico tenha tempo de se consolidar.
• Lojistas que lançam novos produtos e desejam obter prova social desde o primeiro dia.
• Lojistas com lojas multilíngues que precisam de avaliações em vários idiomas sem fluxos de trabalho separados.
• Qualquer administrador do PrestaShop que deseje avaliações de produtos ricas em palavras-chave na loja virtual, sem depender que os clientes as enviem.

Guia de Instalação 2.0 para Addon Gerador de Avaliações de IA para Prestashop

Requerimentos do sistema

Verifique estes itens antes de iniciar a instalação:

• PrestaShop 1.7.x, 8.x ou 9.x
• PHP 7.2 ou superior 
• O módulo nativo de comentários de produtos do PrestaShop está instalado e ativo.
• Uma chave de API válida da OpenAI, Anthropic ou Google.

Instalando o Módulo

Passo 1: Baixe o arquivo ZIP da sua conta e abra o painel administrativo do PrestaShop.

Passo 2: Acesse Módulos e, em seguida, Gerenciador de Módulos. Encontre a opção de upload no canto superior direito da tela.

Passo 3: Selecione o arquivo ZIP em seus downloads. O PrestaShop processa o upload e descompacta os arquivos automaticamente.

Passo 4: Clique em Instalar na mensagem que aparecer. A tela de configuração do módulo será carregada logo em seguida.

Passo 5: Caso o módulo não apareça, digite “AI Review Generator” na busca do Gerenciador de Módulos e abra a opção Configurar.

Problemas comuns de instalação

O upload falhou: O servidor está rejeitando o arquivo devido ao tamanho. Peça ao seu provedor de hospedagem para aumentar os parâmetros upload_max_filesize e post_max_size para pelo menos 32 MB.

Módulo não visível após a instalação: Limpe o cache do PrestaShop em Parâmetros Avançados, depois em Desempenho e execute a pesquisa novamente.

As avaliações não estão sendo exibidas na página inicial: O módulo nativo de Comentários de Produtos precisa estar instalado e ativado. As avaliações geradas por este módulo passam por ele e não serão exibidas sem a sua instalação.

Visão geral do painel de administração 3.0 Addon Gerador de Avaliações de IA para Prestashop

O Gerador de Avaliações com IA para PrestaShop adiciona três abas ao painel administrativo:

• Configurações Gerais: Ligue o módulo, conecte um provedor de IA e obtenha o URL CRON para geração automatizada.
• Regras de avaliação: Crie e gerencie as regras que definem como as avaliações são criadas, onde se aplicam e quando são publicadas.
• Comentários: Confira, aprove ou remova qualquer avaliação gerada antes ou depois de ela ser publicada na loja.

4.0 Aba Configurações Gerais no Módulo Gerador de Avaliações de Produtos do Prestashop

Esta aba contém a configuração global do módulo de geração de avaliações com IA para PrestaShop. Um aviso no topo da página indica se as configurações atuais se aplicam a todas as lojas ou apenas a uma.

4.1 Habilitar Módulo

A opção principal. Ao ser ativada, o módulo fica ativo em toda a loja. Ao ser desativada, a geração de conteúdo é interrompida, mas todas as regras, avaliações e histórico permanecem ativos.

4.2 Provedor de IA

Escolha entre três fornecedores:

• ChatGPT (OpenAI)
• Claude (Antrópico)
• Gêmeos (Google)

Apenas um provedor é executado por vez. Alterar a seleção não afeta as regras existentes nem as avaliações já geradas.

4.3 Chave de API

Insira a chave da API do provedor selecionado. A ausência da chave significa que o serviço de IA não pode ser acessado, a geração não será executada e o módulo permanecerá inativo.

Como obter sua chave de API:

Para a OpenAI: acesse platform.openai.com, abra a seção Chaves de API na sua conta e crie uma nova chave. Copie-a imediatamente, pois ela só é exibida uma vez.

Para a Anthropic: acesse console.anthropic.com, abra “Chaves de API” e crie uma nova.

Para o Google Gemini: acesse aistudio.google.com, clique em “Obter chave de API” e gere uma chave para o projeto escolhido.

Clique na Chave de teste Para verificar a conexão antes de salvar.

4.4 Seleção de Modelo

Escolha o modelo que melhor se adapta às suas necessidades dentre os disponíveis em cada fornecedor.

Modelos OpenAI: GPT-5.5, GPT-5.4, GPT-5.4 mini, GPT-5.4 nano, GPT-5 (bate-papo), GPT-4.1, GPT-4.1 mini, GPT-4.1 nano, o3, o3-mini, o4-mini, GPT-4o, GPT-4o mini, GPT-4 Turbo, GPT-4, GPT-3.5 Turbo

Modelos Claude: Claude Opus 4.7, Claude Sonnet 4.6, Claude Opus 4.6, Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5, Claude Opus 4.1, Claude Sonnet 4, Claude Opus 4

Modelos Gemini: Gemini 3.5 Flash, Gemini 3 Flash (Prévia), Gemini 3.1 Flash-Lite, Gemini 2.5 Flash-Lite, Gemini Flash (Última versão), Gemini Flash-Lite (Última versão)

4.5 Tokens Máximos

Este número define o limite máximo de texto que a IA pode escrever por solicitação de revisão. O intervalo é de 1 a 16384, e o valor padrão é 4000. Aumentar esse valor permite que a IA escreva conteúdo mais detalhado, mas aumenta o custo da chamada à API. Manter um valor menor resulta em revisões mais curtas, reduz custos e acelera cada execução. Alinhe-o com o valor de “Palavras Máximas por Revisão” que você estiver usando nas regras.

4.6 Temperaturas

A temperatura determina o quão consistente ou variada será a saída da IA. A escala varia de 0.0 a 1.0. Em zero, a saída é previsível e uniforme, o que é adequado para lojas que precisam que todas as avaliações sigam um tom específico. Mais próximo de 1, a saída se torna mais variada. Para avaliações que devem ter uma leitura natural, um valor entre 0.5 e 0.7 tende a oferecer um bom equilíbrio.

4.7 Verificar avaliações existentes

Defina esta opção como “Sim” e o módulo executará uma verificação em cada produto antes de gerar a requisição. Se já existirem avaliações, o produto será ignorado. Isso impede que o mesmo produto receba requisições repetidas e evita o desperdício de tokens da API com conteúdo desnecessário.

4.8 URL CRON para geração agendada

Na aba Configurações Gerais, está disponível um URL protegido por token para geração automática de avaliações programadas. Tanto as avaliações imediatas quanto as agendadas são publicadas por meio desse URL.

Copie e adicione ao seu cron job do servidor. A frequência recomendada é a cada 15 minutos. Somente as requisições que contêm o token correto acionam a geração. A URL não faz nada sem ele.

Clique Economize Para aplicar todas as alterações nesta aba.

5.0 Guia de Regras de Revisão

As Regras de Revisão controlam exatamente como o PrestaShop gera avaliações automaticamente O processo é executado. Cada regra tem como alvo um conjunto de produtos ou categorias e define o modo de publicação, os limites de geração, o tom, o idioma e a distribuição de classificação para esse conjunto.

A lista de Regras de Revisão exibe todas as regras criadas com seu ID, nome, modo de publicação, tipo de conteúdo, número máximo de revisões por dia, status ativo, botão “Gerar” e loja atribuída. Clique em “Gerar agora” em qualquer linha para executar a regra imediatamente. Clique em “Editar” para alterar as configurações da regra.

5.1 Adicionando uma nova regra de revisão

Clique no botão Adicionar regra para abrir o formulário de criação de regras.

Loja: Ao configurar uma rede com várias lojas, selecione a qual loja esta regra se aplica.

Ativar regra: Ative esta opção para tornar a regra ativa. As regras desativadas são salvas, mas não são executadas pelo CRON nem geradas automaticamente.

Modo de publicação: Três opções controlam quando as avaliações geradas são publicadas.

• Imediato (publicar na geração): As avaliações são publicadas no momento em que são geradas. Sem espera, sem etapa de aprovação.
• Programado (publicar após um atraso aleatório): As avaliações são geradas e armazenadas, sendo publicadas aleatoriamente dentro de um período mínimo e máximo definido por você. Um intervalo de 0 a 7 dias faz com que cada avaliação seja publicada aleatoriamente dentro desse período. Isso faz com que o padrão de acúmulo de avaliações pareça orgânico, em vez de instantâneo.
• Manual (aguardando aprovação em Revisões): As avaliações são geradas e armazenadas na aba “Avaliações”. Nada é publicado até que um administrador abra cada entrada e a aprove. Ideal quando o controle editorial sobre o que é publicado é importante.

Atraso aleatório (dias): Aparece quando o modo Agendado está selecionado. Defina um intervalo de dias mínimo e máximo. As avaliações geradas são publicadas em um ponto aleatório dentro desse intervalo.

Máximo por Cron: O número máximo de revisões que esta regra pode gerar em uma única execução do CRON.

Máximo por dia: O número total de revisões que esta regra pode gerar em todas as execuções do CRON em um dia do calendário.

Máximo por produto por dia: Este é o número máximo de avaliações que um único produto pode receber em um dia, de acordo com esta regra. Isso impede que um produto acumule um volume anormal em um curto período.

Número máximo de palavras por avaliação: O número máximo de palavras para cada avaliação gerada. Defina como 150 para avaliações de tamanho padrão. Reduza para 50 ou menos para avaliações curtas. Aumente para conteúdo longo e detalhado.

Idiomas: Selecione os idiomas nos quais as avaliações devem ser geradas. Se inglês e francês estiverem selecionados, todas as avaliações serão geradas em ambos os idiomas. Somente os idiomas instalados na sua loja PrestaShop aparecem nesta lista.

Tipo de conteúdo: Escolha se a regra se aplica a Produtos ou Categorias. Selecionar Produtos permite pesquisar e adicionar produtos específicos. Selecionar Categorias permite aplicar a uma categoria inteira; todos os produtos dessa categoria receberão avaliações de acordo com essa regra.

Tom: Selecione a voz para as avaliações geradas.

• Professional
• Casual
• Técnicos
• Persuasivo

Gerar usando: Ative ou desative quais pontos de dados do produto a IA usa ao escrever a avaliação. Pelo menos um deles deve estar ativado.

• Nome do produto
• Descrição do produto
• Preço do produto
• Categoria de produto

Desativar um dado significa que a IA não o considerará na avaliação. Ativar o preço significa que as avaliações podem fazer referência ao valor do produto. Ativar a descrição fornece à IA mais contexto para conteúdo detalhado e específico do produto.

Distribuição da classificação (%): Defina a porcentagem de distribuição entre as avaliações de 1 a 5 estrelas. O total deve ser exatamente igual a 100%. Por exemplo: 5 estrelas 50%, 4 estrelas 30%, 3 estrelas 10%, 2 estrelas 5%, 1 estrela 5%. O módulo usa essa distribuição para ponderar a classificação atribuída a cada avaliação gerada, mantendo a distribuição natural em vez de uma distribuição perfeitamente uniforme.

Nome da regra: Campo obrigatório. Dê à regra um nome claro que identifique sua finalidade, por exemplo, “Coleção de Verão em Inglês” ou “Categoria Casual da Página Inicial”.

Prompt personalizado (en): Um campo opcional que substitui a instrução de geração padrão para esta regra. Escreva uma instrução simples e insira qualquer uma das variáveis ​​suportadas para trazer os dados do produto para o prompt.

Variáveis ​​suportadas: {product_name}, {product_description}, {price}, {category}, {shop_name}, {tone}, {max_words}

Por exemplo: Escreva uma avaliação para {product_name} com preço de {price}. Mantenha o texto com menos de {max_words} palavras e use um tom {tone}.

Clique Economize Para criar a regra, ela aparecerá imediatamente na lista de Regras de Revisão.

5.2 Editar e excluir regras

Clique em Editar em qualquer linha de regra para reabrir o formulário de configuração e alterar as configurações desejadas. Clique na seta suspensa ao lado de Editar e selecione Excluir para remover uma regra permanentemente. A exclusão de uma regra não exclui as avaliações já geradas para ela.

5.3 Ações em massa

O menu suspenso “Ações em massa” na parte inferior da lista de regras permite aplicar ações a várias regras selecionadas simultaneamente.

6.0 Avaliações (Aba)

A aba Avaliações mostra todas as avaliações geradas por este módulo. É aqui que você aprova, publica ou remove avaliações antes ou depois de elas serem exibidas na loja.

6.1 Lista de avaliações

Cada entrada na lista mostra:

• IDENTIDADE: Número de revisão sequencial.
• Produto: Para qual produto foi gerada a avaliação?
• Idioma: Em que idioma esta avaliação foi gerada?
• Prévia da análise: Uma versão resumida do corpo de revisão.
• Revisor: O nome e o endereço de e-mail do avaliador gerados.
• Classificação: A classificação por estrelas é atribuída com base nas configurações de distribuição da regra.
• Estado: Programado, publicado ou aguardando aprovação.
• Criado: Quando a avaliação foi gerada.
• Publicado em: Quando a avaliação foi publicada na loja.
• Shop: A qual loja pertence a avaliação?

Filtre a lista por produto, idioma, avaliador, classificação, status, intervalo de datas de criação, data de publicação ou loja usando os controles de pesquisa acima da lista.

6.2 Aprovação e publicação de revisões

Para regras definidas no modo de publicação manual, as revisões aparecem nesta guia com o status “Aguardando aprovação”. Clique em “Aprovar e publicar” em qualquer linha para enviar essa revisão imediatamente.

Clique na seta suspensa ao lado de Aprovar e Publicar para acessar a opção Visualizar. Isso abrirá o texto completo da revisão para que você possa lê-lo antes de publicar.

6.3 Excluindo avaliações

Clique na seta suspensa ao lado de Aprovar e Publicar e selecione Excluir para remover permanentemente uma avaliação gerada. Avaliações excluídas não podem ser recuperadas.

7.0 perguntas frequentes

P: O que é Knowband? Gerador de avaliações de IA para PrestaShop, e como funciona?

Conecta-se ao ChatGPT (OpenAI), Claude (Anthropic) ou Gemini (Google) e gera avaliações específicas para cada produto com base em regras definidas no painel de administração. Cada avaliação é escrita individualmente para o produto específico, no idioma e tom especificados pela regra, e publicada através do módulo nativo de Comentários de Produtos. Compatível com PrestaShop 1.7.x até 9.x.

P: Quais provedores de IA são compatíveis com o Gerador de Avaliações de IA do PrestaShop?

O módulo de avaliações de produtos com IA para PrestaShop é compatível com três provedores: ChatGPT via OpenAI, Claude via Anthropic e Gemini via Google. A conexão é feita usando sua própria chave de API. Apenas um provedor pode estar ativo por vez. A troca de provedores pode ser feita na aba Configurações Gerais, sem afetar as regras existentes ou as avaliações geradas.

P: Quais são os três modos de publicação no módulo de avaliações geradas automaticamente do PrestaShop?

A opção “Imediata” publica uma avaliação no momento em que ela é gerada. A opção “Agendada” a retém e a libera em um momento aleatório dentro de um intervalo de dias definido por você, criando um padrão de acumulação com aparência natural. As avaliações configuradas como “Manual” permanecem na aba “Avaliações” com o status “Aguardando Aprovação”. Um administrador precisa abrir cada uma e aprová-la antes que ela seja exibida na loja.

P: Como funciona o recurso de distribuição de avaliações no módulo de avaliações de produtos com IA do PrestaShop?

Abra qualquer regra de avaliação e encontre a seção Distribuição de Classificação (%). Atribua uma porcentagem a cada nível de estrelas, de 1 a 5. Os números devem somar exatamente 100%. Por exemplo: 5 estrelas a 50%, 4 estrelas a 30%, 3 estrelas a 10%, 2 estrelas a 5%, 1 estrela a 5%. Quando o módulo gera avaliações, ele segue essa distribuição ao atribuir cada classificação, para que o perfil geral em uma página de produto não pareça artificialmente uniforme.

P: Como funciona a automação CRON para a automação de avaliações de produtos no PrestaShop?

A aba Configurações Gerais fornece uma URL CRON protegida por token. Adicione esta URL à sua tarefa cron do servidor, configurada para ser executada a cada 15 minutos. Cada execução utiliza as regras de geração automática de avaliações do PrestaShop para produzir conteúdo e publicar avaliações imediatas e agendadas. A URL só aciona a geração quando o token correto é incluído; sem ele, o acesso é bloqueado.

P: O módulo de geração automática de avaliações do PrestaShop suporta vários idiomas?

Sim. Dentro de cada regra de avaliação, marque os idiomas nos quais as avaliações devem ser geradas. Se inglês e francês estiverem selecionados, todas as avaliações serão geradas em ambos os idiomas. Somente os idiomas instalados na loja PrestaShop aparecem na lista de idiomas.

P: O que é a funcionalidade de prompts personalizados no módulo de geração de avaliações com IA do PrestaShop?

O campo “Prompt Personalizado” está presente em cada regra de avaliação e é opcional. Preencha-o quando a saída de geração padrão não corresponder ao tom da sua loja ou quando precisar que as avaliações se concentrem em um atributo específico do produto. Escreva uma instrução simples e insira qualquer uma das variáveis ​​compatíveis para trazer dados do produto para o prompt: {product_name}, {product_description}, {price}, {category}, {shop_name}, {tone}, {max_words}.

P: O que o Max Tokens controla no módulo de avaliações de produtos com IA do PrestaShop?

O parâmetro “Tokens Máximos” limita a quantidade de texto que a IA gera por avaliação em uma única solicitação. O intervalo aceito é de 1 a 16384. Um número maior permite que a IA escreva avaliações mais longas e detalhadas, mas aumenta o custo da API por geração. Um número menor reduz tanto o tamanho quanto o custo. Defina-o de acordo com o valor de “Palavras Máximas por Avaliação” na regra para que ambos os limites permaneçam consistentes.

P: Posso impedir que avaliações duplicadas sejam geradas?

Sim. Ative a opção “Verificar avaliações existentes” nas Configurações gerais. Quando ativada, o módulo verifica cada produto antes de gerar avaliações e ignora aqueles que já possuem avaliações. Isso mantém o banco de dados organizado e evita o gasto de tokens da API em produtos que não precisam de conteúdo novo.

P: O Gerador de Avaliações com IA para PrestaShop é compatível com o PrestaShop 9?

Sim. O Gerador de avaliações de IA para PrestaShop Funciona no PrestaShop 1.7.xx até 9.x. Antes de gerar, certifique-se de que o módulo nativo de Comentários de Produtos esteja instalado e ativado. Nenhuma alteração no tema ou nos modelos personalizados é necessária.

Conclusão 8.0

Este módulo integra a automação de avaliações de produtos com inteligência artificial ao painel de administração do PrestaShop. Basta definir uma regra, conectar uma chave de API e o módulo cuida da geração, do agendamento e da publicação das avaliações. Avaliações ricas em palavras-chave são exibidas nas páginas de produtos automaticamente, sem a necessidade de os clientes as escreverem.

Os controles de distribuição de avaliações mantêm a credibilidade da seleção de opiniões. A automação de avaliações de produtos do PrestaShop funciona de ponta a ponta sem necessidade de gerenciamento diário, uma vez definidas as regras. A geração multilíngue abrange todos os mercados atendidos pela loja. O modo de aprovação manual oferece controle editorial completo quando necessário. A automação CRON cuida do restante, conforme o cronograma.

Para suporte, desenvolvimento personalizado ou requisitos de complementos para PrestaShop, entre em contato diretamente com a equipe da Knowband através de [email protected]