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
- Abra o Painel de Controle do WAzion
- Vá para “Plugins“ → “Product Q&A
- Ativa o interruptor “Plugin ativo
- Adicione seu domínio em “Domínios Autorizados“ (ex: mitienda.myshopify.com)
- Copie o código de integração
- 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.
Acesse o editor de código do tema
No seu painel de administração do Shopify:
- Clique em Loja online no menu lateral esquerdo
- Seleciona Temas
- No seu tema atual (aquele que diz “Atual“), clique nos três pontos (...)
- 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“.
Procure o arquivo da página do produto
No painel lateral esquerdo do editor de código:
Temas Loja Online 2.0 (Dawn, etc.)
- Expanda a pasta Seções
- Procure e clique em main-product.liquid
Temas antigos (Vintage, Debut, etc.)
- Expanda a pasta Templates
- 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“.
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.
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.
Guarda as alterações
Clique no botão Salvar no canto superior direito do editor de código.
Verifique a instalação
- Abra sua loja em uma janela anônima
- Vá a qualquer página de produto
- Você deveria ver o widget de Perguntas e Respostas do Produto
- 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:
- No editor de código, vá para a pasta Snippets
- Clique em Adicionar um novo snippet
- Nomeie-o wazion-product-qa (será criado como wazion-product-qa.liquid)
- Cole o código do widget e salve
- 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.
Acesse o editor de temas ou use um plugin de snippets
No seu painel de administração do WordPress:
- Vá em Aparência → Editor de temas
- 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.
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.
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
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.
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.
Verifique a instalação
- Abra sua loja em uma janela anônima
- Vá a qualquer página de produto
- Você deveria ver o widget de Perguntas e Respostas do Produto
- 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.
Acesse o editor de temas ou edite por FTP
No seu painel de administração do PrestaShop:
- Vá em Design → Editor de temas
- 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.
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
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
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.
Guarde e limpe o cache
Depois de salvar as alterações no modelo:
- Vá para Parâmetros Avançados → Desempenho
- 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.
Verifique a instalação
- Abra sua loja em uma janela anônima
- Vá a qualquer página de produto
- Você deveria ver o widget de Perguntas e Respostas do Produto
- 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.
Acesse o CMS da VTEX
No seu Admin do VTEX:
VTEX IO (Framework de Loja)
Vá para Storefront → Tema da Loja. Edite o arquivo store/blocks/product.jsonc no seu repositório do tema.
CMS legado
Vá para Storefront → CMS → Layout. Localize o template de produto e edite o placeholder de conteúdo.
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
- Vá para Storefront → CMS → Páginas
- Selecione a página do produto e acesse Configuração avançada → Scripts personalizados
- 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.
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.
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.
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.
Verifique a instalação
- Abra sua loja em uma janela anônima
- Vá a qualquer página de produto
- Você deveria ver o widget de Perguntas e Respostas do Produto
- 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:
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
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
Tradução automática
Se o cliente perguntar em outro idioma, a FAQ é traduzida automaticamente para o idioma principal da sua loja.
-
3
Anti-duplicados
Verifica-se que não exista já um FAQ semelhante (80% de semelhança) antes de publicar.
-
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
- Vá para Dashboard → Plugins → Product Q&A
- Procure a seção “FAQ Pública
- Ative o interruptor “Ativar FAQ pública
- Se aparecer um aviso de permissão, clique em “Verificar permissão
- Configura o máximo de FAQs por produto (1-20)
- 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 |