CENTRO DE AJUDA Shopify, WooCommerce, PrestaShop, VTEX

Perguntas e Respostas sobre o produto para sua loja online

Widget de perguntas e respostas com IA para as páginas de produto da sua loja online.

⚠️

Requisito: Loja online conectada

Este plugin requer que sua loja online (Shopify, WooCommerce, PrestaShop ou VTEX) esteja conectada ao WAzion para obter as informações dos produtos. Se você ainda não a conectou, vá para Dashboard → Integrações.

O que é Product Q&A?

Product Q&A é um widget que se integra nas páginas de produto da sua loja online. Permite que os visitantes façam perguntas específicas sobre o produto e recebam respostas instantâneas da IA, baseadas nas informações reais do produto.

  • Respostas baseadas no título, descrição, variantes e estoque do produto
  • Não é necessário configurar prompt (mas você pode adicionar instruções adicionais)
  • Suporte multilíngue com tradução automática
  • 10 temas de design para combinar com sua loja
  • Estatísticas de perguntas por produto

Como ativar o plugin

  1. Abra o Painel de Controle do WAzion
  2. Vá para “Plugins“ → “Product Q&A
  3. Ativa o interruptor “Plugin ativo
  4. Adicione seu domínio em “Domínios Autorizados“ (ex: mitienda.myshopify.com)
  5. Copie o código de integração
  6. Cole-o na página do produto da sua loja (no Shopify: main-product.liquid)

Código de integração

Este é o código que você precisa adicionar à página do produto da sua loja:

<!-- WAzion Product Q&A -->
<div id="wazion-product-qa"></div>
<script>
(function(w,d,s,t,p){
  if(w.WazionProductQA)return;
  w.WazionProductQA={token:t,productId:p};
  var js=d.createElement(s);js.async=true;
  js.src='https://www.wazion.com/plugins/product-qa/embed.js';
  js.dataset.token=t;js.dataset.product=p;
  d.body.appendChild(js);
})(window,document,'script','TU_TOKEN_AQUI','{{ product.id }}');
</script>
<!-- /WAzion Product Q&A -->

Nota: {{ product.id }} é uma variável do Liquid que o Shopify substitui automaticamente pelo ID do produto atual. Não a modifique.

Disponível em todas as plataformas

O Product Q&A funciona com Shopify, WooCommerce, PrestaShop e VTEX. O widget se integra na página do produto de qualquer plataforma. Mais abaixo você encontrará guias de instalação passo a passo para cada plataforma:

A sincronização de FAQs na loja (metafields) está disponível para Shopify. Para as demais plataformas, as FAQs são geradas automaticamente no painel.

Guia passo a passo: Instalação no Shopify Guia Shopify

Siga estes passos detalhados para adicionar o widget de Perguntas e Respostas de Produto às páginas de produto da sua loja Shopify.

1

Acesse o editor de código do tema

No seu painel de administração do Shopify:

  1. Clique em Loja online no menu lateral esquerdo
  2. Seleciona Temas
  3. No seu tema atual (aquele que diz “Atual“), clique nos três pontos (...)
  4. No menu suspenso, selecione Editar código

Conselho: Antes de fazer alterações, considere duplicar seu tema como backup. Vá aos três pontos e selecione “Duplicar“.

2

Procure o arquivo da página do produto

No painel lateral esquerdo do editor de código:

Temas Loja Online 2.0 (Dawn, etc.)

  1. Expanda a pasta Seções
  2. Procure e clique em main-product.liquid

Temas antigos (Vintage, Debut, etc.)

  1. Expanda a pasta Templates
  2. Procure product.liquid ou product-template.liquid

Não encontra? Use Ctrl+F (ou Cmd+F no Mac) na lista de arquivos e procure por “product“.

3

Encontre onde inserir o código

Procure um bom lugar para o widget. Recomendamos colocá-lo após a descrição do produto:

Buscar referências comuns:

Use Ctrl+F (Cmd+F no Mac) para buscar estas referências:

  • • product.description
  • • product-form
  • • add-to-cart
  • • buy-buttons

Localização ideal: Após o formulário de adicionar ao carrinho ou após a descrição do produto.

4

Cole o código do widget

Insira o seguinte código na localização que você escolheu:

<!-- WAzion Product Q&A Widget -->
<div id="wazion-product-qa" style="margin: 20px 0;"></div>
<script>
(function(w,d,s,t,p){
  if(w.WazionProductQA)return;
  w.WazionProductQA={token:t,productId:p};
  var js=d.createElement(s);js.async=true;
  js.src='https://www.wazion.com/plugins/product-qa/embed.js';
  js.dataset.token=t;js.dataset.product=p;
  d.body.appendChild(js);
})(window,document,'script','TU_TOKEN_AQUI','{{ product.id }}');
</script>
<!-- /WAzion Product Q&A Widget -->

Importante! Substitua SEU_TOKEN_AQUI pelo token que aparece no seu Dashboard da WAzion → Plugins → Product Q&A.

5

Guarda as alterações

Clique no botão Salvar no canto superior direito do editor de código.

6

Verifique a instalação

  1. Abra sua loja em uma janela anônima
  2. Vá a qualquer página de produto
  3. Você deveria ver o widget de Perguntas e Respostas do Produto
  4. Faça uma pergunta de teste para verificar se funciona

Método alternativo: Criar um bloco de seção (Online Store 2.0)

Este método permite adicionar/remover o widget pelo personalizador visual sem precisar mexer no código toda vez:

  1. No editor de código, vá para a pasta Snippets
  2. Clique em Adicionar um novo snippet
  3. Nomeie-o wazion-product-qa (será criado como wazion-product-qa.liquid)
  4. Cole o código do widget e salve
  5. Agora em main-product.liquid, onde quiser o widget, adicione:
{% render 'wazion-product-qa' %}

Assim você pode mover ou remover o widget facilmente editando apenas uma linha.

Guia passo a passo: Instalação no WooCommerce Guia WooCommerce

Siga estes passos detalhados para adicionar o widget de Perguntas e Respostas sobre Produtos às páginas de produtos da sua loja WooCommerce.

1

Acesse o editor de temas ou use um plugin de snippets

No seu painel de administração do WordPress:

  1. Vá em AparênciaEditor de temas
  2. Ou use um plugin como Code Snippets para adicionar código sem modificar os arquivos do tema diretamente.

Conselho: Sempre use um tema filho para modificações. Se você atualizar o tema pai, perderá as alterações feitas diretamente nele.

2

Localize o modelo de produto individual

Busque o arquivo de modelo de produto em seu tema:

Localização habitual

  • • woocommerce/single-product.php
  • • woocommerce/content-single-product.php

Não encontra? Se o seu tema não tem esses arquivos, copie-os de wp-content/plugins/woocommerce/templates/ para o seu tema filho mantendo a mesma estrutura de pastas.

3

Busque a localização ideal para o widget

Recomendamos colocar o widget após o resumo do produto:

Referências comuns:

  • • woocommerce_after_single_product_summary
  • • woocommerce_after_single_product
  • • Antes do fechamento do contêiner do produto
4

Insira o código do widget

Cole o seguinte código na localização que você escolheu:

<!-- WAzion Product Q&A -->
<div id="wazion-product-qa"></div>
<script>
(function(w,d,s,t,p){
  if(w.WazionProductQA)return;
  w.WazionProductQA={token:t,productId:p};
  var js=d.createElement(s);js.async=true;
  js.src='https://www.wazion.com/plugins/product-qa/embed.js';
  js.dataset.token=t;js.dataset.product=p;
  d.body.appendChild(js);
})(window,document,'script','TU_TOKEN_AQUI','<?php echo get_the_ID(); ?>');
</script>

Importante! Substitua SEU_TOKEN_AQUI pelo token que aparece no seu Dashboard do WAzion → Plugins → Product Q&A. A função get_the_ID() obtém automaticamente o ID do produto no WooCommerce.

5

Guarda as alterações

Guarde o arquivo modificado. Se você estiver usando o editor de temas do WordPress, clique em Atualizar arquivo. Se você estiver usando um plugin de snippets, ative o snippet.

6

Verifique a instalação

  1. Abra sua loja em uma janela anônima
  2. Vá a qualquer página de produto
  3. Você deveria ver o widget de Perguntas e Respostas do Produto
  4. Faça uma pergunta de teste para verificar se funciona

Método alternativo: Usar functions.php com hook do WooCommerce

Este método insere o widget automaticamente usando o sistema de hooks do WooCommerce, sem editar templates:

// Añadir en functions.php del tema hijo
add_action('woocommerce_after_single_product_summary', function() {
    $product_id = get_the_ID();
    echo '<div id="wazion-product-qa"></div>
    <script>
    (function(w,d,s,t,p){
      if(w.WazionProductQA)return;
      w.WazionProductQA={token:t,productId:p};
      var js=d.createElement(s);js.async=true;
      js.src="https://www.wazion.com/plugins/product-qa/embed.js";
      js.dataset.token=t;js.dataset.product=p;
      d.body.appendChild(js);
    })(window,document,"script","TU_TOKEN_AQUI","' . esc_attr($product_id) . '");
    </script>';
}, 25);

O número 25 indica a prioridade. Ajuste-o para mudar a posição do widget em relação a outros elementos (menor = mais acima).

Guia passo a passo: Instalação no PrestaShop Guia PrestaShop

Siga estes passos detalhados para adicionar o widget de Perguntas e Respostas sobre Produtos às páginas de produtos da sua loja PrestaShop.

1

Acesse o editor de temas ou edite por FTP

No seu painel de administração do PrestaShop:

  1. Vá em DesignEditor de temas
  2. Ou acesse os arquivos do tema diretamente por FTP para maior controle.

Conselho: Faça uma cópia de segurança do modelo antes de modificá-lo. No FTP, copie o arquivo antes de editá-lo.

2

Localize o modelo de produto

Busque o arquivo de modelo de produto em seu tema:

Localização habitual

  • • themes/TU_TEMA/templates/catalog/product.tpl
3

Busque a localização ideal para o widget

Recomendamos colocar o widget após a descrição do produto:

Referências comuns no Smarty:

  • • {block name='product_description'}
  • • {block name='product_footer'}
  • • No final do conteúdo do produto
4

Insira o código do widget

Cole o seguinte código na localização que você escolheu:

<!-- WAzion Product Q&A -->
<div id="wazion-product-qa"></div>
<script>
(function(w,d,s,t,p){
  if(w.WazionProductQA)return;
  w.WazionProductQA={token:t,productId:p};
  var js=d.createElement(s);js.async=true;
  js.src='https://www.wazion.com/plugins/product-qa/embed.js';
  js.dataset.token=t;js.dataset.product=p;
  d.body.appendChild(js);
})(window,document,'script','TU_TOKEN_AQUI','{$product.id}');
</script>

Nota: Use {$product.id} para obter o ID do produto. Em alguns temas, você também pode usar {$product.id_product} como alternativa.

Importante! Substitua SEU_TOKEN_AQUI pelo token que aparece no seu Dashboard da WAzion → Plugins → Product Q&A.

5

Guarde e limpe o cache

Depois de salvar as alterações no modelo:

  1. Vá para Parâmetros AvançadosDesempenho
  2. Clique em Limpar cache

Importante: PrestaShop armazena em cache os templates Smarty. Se você não limpar o cache, não verá as mudanças.

6

Verifique a instalação

  1. Abra sua loja em uma janela anônima
  2. Vá a qualquer página de produto
  3. Você deveria ver o widget de Perguntas e Respostas do Produto
  4. Faça uma pergunta de teste para verificar se funciona

Método alternativo: Usar um módulo de código personalizado

Se você preferir não editar o modelo diretamente, pode usar um módulo do PrestaShop que permita inserir código HTML/JS em hooks específicos. Procure módulos como “Custom HTML/JS“ no marketplace do PrestaShop e atribua-o ao hook displayProductAdditionalInfo ou displayFooterProduct.

Guia passo a passo: Instalação no VTEX Guia VTEX

Siga estes passos detalhados para adicionar o widget de Perguntas e Respostas sobre Produtos às páginas de produtos da sua loja VTEX.

1

Acesse o CMS da VTEX

No seu Admin do VTEX:

VTEX IO (Framework de Loja)

Vá para StorefrontTema da Loja. Edite o arquivo store/blocks/product.jsonc no seu repositório do tema.

CMS legado

Vá para StorefrontCMSLayout. Localize o template de produto e edite o placeholder de conteúdo.

2

Adicione o script do widget (VTEX IO)

Para VTEX IO, a forma mais confiável de inserir scripts é através do Admin:

Opção recomendada: Scripts personalizados do Admin

  1. Vá para StorefrontCMSPáginas
  2. Selecione a página do produto e acesse Configuração avançadaScripts personalizados
  3. Cole o código do widget da etapa 4

Opção alternativa: Tema da loja com bloco HTML

Se o seu Store Theme tem habilitado allowScripts: true em blocos HTML, você pode usar um bloco html#wazion-qa em product.jsonc. Tenha em mente que o VTEX IO não executa scripts inline em blocos HTML por padrão.

3

Localize o template de produto (Legacy CMS)

Se você usa o CMS Legacy, localize o placeholder de conteúdo do produto no template e procure uma localização adequada após a descrição.

4

Insira o código do widget

Use o seguinte código que lê o ID do produto a partir de um atributo data:

<!-- WAzion Product Q&A -->
<div id="wazion-product-qa" data-product-id="VTEX_PRODUCT_ID_VARIABLE"></div>
<script>
(function(w,d,s,t){
  if(w.WazionProductQA)return;
  var el = d.getElementById('wazion-product-qa');
  var pid = el ? el.dataset.productId : '';
  w.WazionProductQA={token:t,productId:pid};
  var js=d.createElement(s);js.async=true;
  js.src='https://www.wazion.com/plugins/product-qa/embed.js';
  js.dataset.token=t;js.dataset.product=pid;
  d.body.appendChild(js);
})(window,document,'script','TU_TOKEN_AQUI');
</script>

Nota: Substitua VTEX_PRODUCT_ID_VARIABLE pela variável que corresponde ao seu ambiente. Para VTEX IO (Store Theme): use {productContext.product.productId}. Para Legacy CMS: use o controle $product.Id da VTEX.

Importante! Substitua SEU_TOKEN_AQUI pelo token que aparece no seu Dashboard da WAzion → Plugins → Product Q&A.

5

Publique as mudanças

VTEX IO

Publique seu tema com vtex publish a partir do terminal.

CMS legado

Guarde as alterações diretamente no CMS. Elas são aplicadas imediatamente.

6

Verifique a instalação

  1. Abra sua loja em uma janela anônima
  2. Vá a qualquer página de produto
  3. Você deveria ver o widget de Perguntas e Respostas do Produto
  4. Faça uma pergunta de teste para verificar se funciona

Detecção de produto na VTEX

Se o widget não detectar corretamente o ID do produto, verifique se o atributo data-product-id do div contém o ID numérico correto do produto. Para VTEX IO use {productContext.product.productId} no seu Store Theme. Para Legacy CMS use o controle $product.Id.

Solução de problemas

O widget não aparece na página do produto

  • Verifique se o plugin está ativado em Dashboard → Plugins → Product Q&A
  • Verifique se seu domínio está na lista de domínios autorizados
  • Verifique se sua loja online está conectada ao WAzion
  • Abra o console do navegador (F12 → Console) e procure por erros em vermelho
  • Faça o teste em janela anônima para descartar problemas de cache

Erro “Token inválido“ ou “Domínio não autorizado

  • Copie o token diretamente do Painel, sem espaços
  • Adicione seu domínio exato aos autorizados: mitienda.myshopify.com E mitienda.com
  • Espere alguns segundos após salvar as alterações no Painel

O widget aparece, mas diz “Erro ao carregar produto

  • Verifique se sua loja online está conectada em Dashboard → Integrações
  • Certifique-se de não ter modificado a variável do ID do produto no código.
  • O produto deve estar publicado e visível na loja

O widget aparece no lugar errado

  • Mova o código para outro local na template de produto da sua plataforma
  • Procure referências como “product__description“ para colocá-las abaixo
  • Use o estilo margin no div para ajustar o espaçamento: style=“margin: 30px 0;

Não sei qual arquivo editar no meu tema

Arquivos comuns por tema:

  • Dawn, Craft, Sense: sections/main-product.liquid
  • Debut: sections/product-template.liquid
  • Brooklyn: templates/product.liquid
  • Minimal: sections/product-template.liquid

Se o seu tema não estiver na lista, procure arquivos que contenham “product“ em Sections ou Templates.

Opções de configuração

Domínios Autorizados

Lista de domínios onde o widget pode funcionar. Por segurança, somente é permitido o uso a partir de domínios autorizados.

  • • mitienda.myshopify.com
  • • mitienda.com (dominio personalizado)
  • • * (qualquer domínio - apenas para desenvolvimento)

Temas de Design

10 temas pré-projetados para adaptar o widget à sua loja:

Minimal Modern Classic Dark Ocean Sunset Forest Rose Slate Neon

Textos do Widget

Personalize os textos que o visitante vê:

  • Título do widget (ex: “Perguntas sobre este produto“)
  • Espaço reservado para o campo de texto
  • Texto do botão de perguntar

Os textos são traduzidos automaticamente para o idioma do visitante.

Instruções para a IA (opcional)

Você pode adicionar informações adicionais que a IA levará em consideração ao responder:

  • Políticas de envio e devolução
  • Promoções ativas
  • Instruções especiais (ex: “Não mencionar produtos da concorrência“)
  • Informações de contato

Este campo é opcional. Sem instruções adicionais, a IA responderá usando apenas as informações do produto da sua loja online.

Configuração de Idioma

Auto-detectar

Detecta automaticamente o idioma do navegador do visitante.

Idioma fixo

Sempre mostrar em um idioma específico.

Com seletor

Detecta automaticamente, mas permite que o visitante mude o idioma manualmente.

Proteção Anti-Abuso

Limite o número de perguntas por visitante para proteger sua conta:

  • Máximo de perguntas por período (ex: 20 perguntas)
  • Janela de tempo em minutos (ex: 60 minutos)

Estatísticas e Visualizador de Perguntas

Métricas de uso

  • Perguntas totais
  • Perguntas nos últimos 7 dias
  • Perguntas de hoje
  • Visitantes únicos (24h)

Produtos mais consultados

Visualize um ranking dos 5 produtos com mais perguntas. Útil para identificar quais produtos geram mais dúvidas.

Visualizador de Perguntas

Revise todas as perguntas feitas pelos visitantes:

  • Filtro por período: Hoje, 7 dias, 30 dias, 90 dias, 1 ano, todos, ou intervalo personalizado
  • Lista paginada: Navegue por todas as perguntas (10 por página)
  • Detalhe completo: Ver pergunta, resposta da IA, produto, idioma e URL
  • Estado FAQ: Cada pergunta mostra se já está publicada como FAQ
  • Publicar manualmente: Publique qualquer pergunta como FAQ com um clique

Novo: A coluna “FAQ“ mostra o estado de cada pergunta: um check verde se está sincronizada com sua loja, um badge amarelo se está pendente de sincronização, ou um botão + para publicá-la manualmente.

FAQ Pública na sua loja Novo

Publique automaticamente as perguntas frequentes de seus clientes como FAQs nos produtos de sua loja online. Melhore seu SEO com Schema.org FAQPage e reduza as perguntas repetidas.

O que é a FAQ Pública?

Quando um cliente faz uma pergunta genérica sobre um produto (por exemplo: “É resistente à água?“ ou “Qual é o tempo de envio?“), a IA avalia se essa pergunta e resposta seriam úteis para outros clientes.

Se a IA decidir que é uma boa FAQ, ela é publicada automaticamente. No Shopify, é sincronizada diretamente no metafield do produto para ser exibida no seu tema. Para WooCommerce, PrestaShop e VTEX, as FAQs são geradas automaticamente no painel e ficam disponíveis para consulta.

🔍

Melhor SEO

O Google exibe suas FAQs como rich snippets

⏱️

Menos perguntas

Os clientes veem respostas antes de perguntar

🤖

100% automático

Sem moderação manual necessária

Como funciona

  1. 1

    Avaliação IA

    Quando um cliente faz uma pergunta, a IA avalia se é genérica (útil para outros) e não contém dados pessoais.

  2. 2

    Tradução automática

    Se o cliente perguntar em outro idioma, a FAQ é traduzida automaticamente para o idioma principal da sua loja.

  3. 3

    Anti-duplicados

    Verifica-se que não exista já um FAQ semelhante (80% de semelhança) antes de publicar.

  4. 4

    Publicação na sua loja

    A FAQ é publicada na sua loja. No Shopify, é armazenada no metafield wazion.faqs do produto. Em outras plataformas, as FAQs ficam disponíveis no painel para consulta.

Como ativar a FAQ Pública

  1. Vá para Dashboard → Plugins → Product Q&A
  2. Procure a seção “FAQ Pública
  3. Ative o interruptor “Ativar FAQ pública
  4. Se aparecer um aviso de permissão, clique em “Verificar permissão
  5. Configura o máximo de FAQs por produto (1-20)
  6. Guarda as alterações

Sobre a permissão (Shopify): Para escrever FAQs no Shopify você precisa da permissão “write_products“. Se não a tiver, vá ao seu painel do Shopify → Apps → WAzion → Permissões para adicioná-la.

Gestão de FAQs publicadas

Embora as FAQs sejam publicadas automaticamente, você tem controle total a partir do Painel de Controle:

  • Ver FAQs: Lista de todas as FAQs publicadas, filtradas por produto ou estado
  • Publicar manualmente: Desde “Últimas Perguntas“ você pode publicar qualquer pergunta como FAQ com um clique.
  • Despublicar Remova uma FAQ da sua loja, mas mantenha-a no seu histórico.
  • Republicar: Voltar a publicar uma FAQ previamente despublicada
  • Eliminar: Apaga permanentemente uma FAQ

Mostrar FAQs no seu tema Shopify Integração Shopify

Você precisa adicionar dois códigos no seu arquivo main-product.liquid:

1. Código visual (HTML)

Mostre as FAQs aos seus clientes. Adicione onde quiser que apareçam:

<!-- WAzion Product FAQs -->
{% assign faqs_data = product.metafields.wazion.faqs.value %}
{% if faqs_data.faqs.size > 0 %}
<div class="product-faqs">
  <h3 class="product-faqs__title">Preguntas Frecuentes</h3>
  {% for faq in faqs_data.faqs %}
  <details class="product-faqs__item">
    <summary class="product-faqs__question">{{ faq.q }}</summary>
    <div class="product-faqs__answer">{{ faq.a | newline_to_br }}</div>
  </details>
  {% endfor %}
</div>
{% endif %}

2. JSON-LD para SEO (Google Rich Snippets)

Invisível para usuários, mas o Google o usa para mostrar FAQs nos resultados de busca. Adicione-o ao final do arquivo:

<!-- WAzion FAQs JSON-LD for SEO -->
{% assign faqs_data = product.metafields.wazion.faqs.value %}
{% if faqs_data.faqs.size > 0 %}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {% for faq in faqs_data.faqs %}
    {
      "@type": "Question",
      "name": {{ faq.q | json }},
      "acceptedAnswer": {
        "@type": "Answer",
        "text": {{ faq.a | json }}
      }
    }{% unless forloop.last %},{% endunless %}
    {% endfor %}
  ]
}
</script>
{% endif %}

Código 1: Sem estilos para que herde do seu tema. Personalize com CSS.

Código 2: Google Rich Snippets nos resultados de busca.

Quais perguntas NÃO são publicadas?

A IA filtra automaticamente as perguntas que não são adequadas para FAQ pública:

  • Perguntas com dados pessoais (nomes, emails, telefones)
  • Consultas sobre pedidos específicos (números de pedido, rastreamento)
  • Reclamações ou problemas individuais
  • Perguntas muito específicas que não se aplicariam a outros clientes
  • Perguntas duplicadas (semelhantes às FAQs já publicadas)

Perguntas e Respostas do Produto vs Chat na Web

Característica Product Q&A Chat Web
Propósito Perguntas sobre um produto específico Assistente geral para todo o site
Contexto da IA Informação do produto da sua loja online Seu prompt personalizado
Localização Página do produto Qualquer página (flutuante ou embutida)
Requer loja online Sim Não
Configuração de prompt Opcional (instruções adicionais) Recomendado

Perguntas frequentes

Artigos relacionados

Assistente WAzion

Informações comerciais e suporte técnico

Olá! Sou o assistente da WAzion. Posso ajudá-lo com informações sobre preços e planos, dúvidas técnicas, configuração ou qualquer pergunta sobre o nosso produto. Como posso ajudá-lo?
Desenvolvido com WAzion AI