Perguntas e Respostas de Produto para Shopify

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 o Shopify está conectado 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 o Shopify está conectado em Dashboard → Integrações
• → Certifique-se de não ter modificado {{ product.id }} no código
• → O produto deve estar publicado e visível na loja

O widget aparece no lugar errado

• → Mova o código para outra localização em main-product.liquid
• → 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.

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

Configuração de Idioma

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)

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

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 metafield do produto no Shopify. Depois, você pode mostrar essas FAQs no seu tema com o código Liquid que fornecemos.

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 será 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 no Shopify

   A FAQ é armazenada no metafield wazion.faqs do produto, pronta para exibir no seu tema.

Como ativar a FAQ Pública

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

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 Preguntas“ você pode publicar qualquer pergunta como FAQ com um clique
• • Despublicar Remove uma FAQ do Shopify mas mantém-na no seu histórico
• • Republicar: Voltar a publicar uma FAQ previamente despublicada
• • Eliminar: Apaga permanentemente uma FAQ

Mostrar FAQs no seu tema Shopify

Necesitas adicionar dois códigos no seu arquivo main-product.liquid:

<!-- 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 %}

<!-- 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 %}

Que 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, e-mails, 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)