Product Q&A para Shopify

El widget no aparece en la página de producto

• → Verifica que el plugin está activado en Dashboard → Plugins → Product Q&A
• → Comprueba que tu dominio está en la lista de dominios autorizados
• → Verifica que Shopify está conectado a WAzion
• → Abre la consola del navegador (F12 → Console) y busca errores en rojo
• → Prueba en ventana de incógnito para descartar problemas de caché

Error “Token inválido“ o “Dominio no autorizado“

• → Copia el token directamente desde el Dashboard, sin espacios
• → Añade tu dominio exacto a los autorizados: mitienda.myshopify.com Y mitienda.com
• → Espera unos segundos después de guardar cambios en el Dashboard

El widget aparece pero dice “Error al cargar producto“

• → Verifica que Shopify está conectado en Dashboard → Integraciones
• → Asegúrate de no haber modificado {{ product.id }} en el código
• → El producto debe estar publicado y visible en la tienda

El widget aparece en el lugar incorrecto

• → Mueve el código a otra ubicación en main-product.liquid
• → Busca referencias como “product__description“ para colocarlo debajo
• → Usa el estilo margin en el div para ajustar espaciado: style=“margin: 30px 0;“

No sé qué archivo editar en mi tema

Archivos comunes según el tema:

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

Si tu tema no está en la lista, busca archivos que contengan “product“ en Sections o Templates.

Dominios Autorizados

Lista de dominios donde el widget puede funcionar. Por seguridad, solo se permite el uso desde dominios autorizados.

• • mitienda.myshopify.com
• • mitienda.com (dominio personalizado)
• • * (cualquier dominio - solo para desarrollo)

Temas de Diseño

10 temas prediseñados para adaptar el widget a tu tienda:

Textos del Widget

Personaliza los textos que ve el visitante:

• • Título del widget (ej: “Preguntas sobre este producto“)
• • Placeholder del campo de texto
• • Texto del botón de preguntar

Los textos se traducen automáticamente al idioma del visitante.

Instrucciones para la IA (opcional)

Puedes añadir información adicional que la IA tendrá en cuenta al responder:

• • Políticas de envío y devolución
• • Promociones activas
• • Instrucciones especiales (ej: “No mencionar productos de la competencia“)
• • Información de contacto

Configuración de Idioma

Protección Anti-Abuso

Limita el número de preguntas por visitante para proteger tu cuenta:

• • Máximo de preguntas por período (ej: 20 preguntas)
• • Ventana de tiempo en minutos (ej: 60 minutos)

Métricas de uso

• • Preguntas totales
• • Preguntas en los últimos 7 días
• • Preguntas de hoy
• • Visitantes únicos (24h)

Productos más consultados

Visualiza un ranking de los 5 productos con más preguntas. Útil para identificar qué productos generan más dudas.

Visor de Preguntas

Revisa todas las preguntas realizadas por los visitantes:

• • Filtro por período: Hoy, 7 días, 30 días, 90 días, 1 año, todas, o rango personalizado
• • Lista paginada: Navega por todas las preguntas (10 por página)
• • Detalle completo: Ver pregunta, respuesta de la IA, producto, idioma y URL
• • Estado FAQ: Cada pregunta muestra si ya esta publicada como FAQ
• • Publicar manualmente: Publica cualquier pregunta como FAQ con un clic

¿Que es la FAQ Publica?

Cuando un cliente hace una pregunta generica sobre un producto (por ejemplo: “¿Es resistente al agua?“ o “¿Cual es el tiempo de envio?“), la IA evalua si esa pregunta y respuesta serian utiles para otros clientes.

Si la IA decide que es una buena FAQ, se publica automaticamente en el metafield del producto en Shopify. Luego puedes mostrar estas FAQs en tu tema con el codigo Liquid que te proporcionamos.

Como funciona

1. 1

   Evaluacion IA

   Cuando un cliente hace una pregunta, la IA evalua si es generica (util para otros) y no contiene datos personales.

2. 2

   Traduccion automatica

   Si el cliente pregunta en otro idioma, la FAQ se traduce automaticamente al idioma principal de tu tienda.

3. 3

   Anti-duplicados

   Se verifica que no exista ya una FAQ similar (80% similitud) antes de publicar.

4. 4

   Publicacion en Shopify

   La FAQ se guarda en el metafield wazion.faqs del producto, lista para mostrar en tu tema.

Como activar la FAQ Publica

1. Ve a Dashboard → Plugins → Product Q&A
2. Busca la seccion “FAQ Publica en Shopify“
3. Activa el interruptor “Activar FAQ publica“
4. Si aparece un aviso de permiso, haz clic en “Verificar permiso“
5. Configura el maximo de FAQs por producto (1-20)
6. Guarda los cambios

Gestion de FAQs publicadas

Aunque las FAQs se publican automaticamente, tienes control total desde el Dashboard:

• • Ver FAQs: Lista de todas las FAQs publicadas, filtradas por producto o estado
• • Publicar manualmente: Desde “Ultimas Preguntas“ puedes publicar cualquier pregunta como FAQ con un clic
• • Despublicar: Quita una FAQ de Shopify pero la mantiene en tu historial
• • Republicar: Vuelve a publicar una FAQ previamente despublicada
• • Eliminar: Borra permanentemente una FAQ

Mostrar FAQs en tu tema Shopify

Necesitas añadir dos codigos en tu archivo 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 preguntas NO se publican?

La IA filtra automaticamente las preguntas que no son aptas para FAQ publica:

• ✗ Preguntas con datos personales (nombres, emails, telefonos)
• ✗ Consultas sobre pedidos especificos (numeros de pedido, tracking)
• ✗ Quejas o problemas individuales
• ✗ Preguntas muy especificas que no aplicarian a otros clientes
• ✗ Preguntas duplicadas (similares a FAQs ya publicadas)