Saltar al contenido principal

Editor de FAQ + widget de embed

Clione te permite añadir FAQs por producto, por categoría, por página o globales — y luego inyectarlas en tu storefront con una sola etiqueta <script>.

Añadir FAQs manualmente

En FAQs → Add:

  1. Elige el Entity Type (Product, Variant, Category, Page o 🌐 Global)
  2. Busca la entidad por nombre (el input muestra el nombre, no el ID)
  3. Escribe la pregunta y la respuesta
  4. Guarda

Las FAQs globales aplican a todas las páginas de tu tienda — perfectas para envíos, devoluciones, garantía, guías de tallas. Aparecen junto a las FAQs específicas de cada entidad en cada renderizado.

Generar FAQs automáticamente

En FAQs → Generate, el sistema redacta preguntas + respuestas usando el LLM con los datos del producto como contexto. Revisa y aprueba.

Importación masiva

En FAQs → Import, pega o sube un CSV:

entityType,entityId,question,answer,locale,sortOrder
product,SKU-001,¿Cuál es la garantía?,Garantía de fabricante de 2 años,es,0
global,,¿Cuáles son los tiempos de envío?,2-5 días laborables dentro de la UE,es,0

Exportar

  • Por entidad: en el panel Browse, filtra por entidad y pulsa ↓ Export CSV
  • Tienda completa: pulsa ↓ Download all FAQs (CSV) arriba en la página de FAQ → un único fichero con todas las FAQs de todas las entidades

Embeber en tu storefront

En FAQs → Embed Script:

  1. Genera una API key
  2. Configura la lista blanca de Allowed Domains (p. ej. shop.example.com, *.example.com) — necesario para bloquear scraping y abuso
  3. Copia el snippet auto-detect:
<div id="clione-faq"></div>
<script
src="https://api.clione.ai/embed.js"
data-api-key="sk_live_…"
data-target="#clione-faq"
async
></script>

El loader detecta la entidad actual a partir de:

  1. Atributos data-entity-type + data-entity-id que pongas en la etiqueta <script> (si quieres forzar)
  2. Meta tags OpenGraph (og:type="product", product:retailer_item_id)
  3. Patrones de URL: Shopify /products/, BigCommerce /product/, clase de body en WooCommerce, etc.

Después recupera las FAQs correspondientes (fusionando específicas + globales) e inyecta tanto un acordeón visible como un schema JSON-LD FAQPage para SEO.