Editor de FAQ + widget de embed
Planes: Growth · Pro · Agency (el editor de FAQs no está incluido en Starter)
Clione te deja escribir FAQs para un producto, una variante, una categoría (BigCommerce) / colección (Shopify), una marca o una página, además de una Biblioteca compartida de respuestas que escribes una vez y enlazas donde hagan falta. Las FAQs aprobadas llegan a tu storefront como un acordeón visible y como datos estructurados FAQPage para crawlers y asistentes de IA.
Esta página cubre c ómo escribir, generar, importar y exportar FAQs, y el script de embed. Para instalar el widget en cada plataforma, mira Instalar el widget de FAQ. Para las reglas de longitud y formato que aplica Clione a preguntas y respuestas, mira Estándares de redacción de FAQs.
Dónde está
En dos sitios:
- Barra lateral de la tienda → Preguntas frecuentes: todas las FAQs de la tienda. Cinco pestañas:
- Explorar: busca en preguntas y respuestas, filtra por tipo y por origen (Generada por IA, Manual, Importada, Tienda), marca favoritas, selecciona y elimina, exporta.
- Biblioteca: respuestas compartidas que escribes una vez y enlazas a muchas entidades.
- Importar CSV: subida masiva.
- Script de inserción: la instalación guiada del widget de FAQ.
- Avanzado: Añadir entrada de FAQ, Generar FAQ con IA para una entidad o para toda la tienda, y el panel de embed manual.
- La pestaña Preguntas frecuentes de cualquier producto, categoría, colección o página: las FAQs de esa entidad, con Generar con IA, Editar y Desde la biblioteca.
↧ Descargar todas las FAQ (CSV), arriba en la página de FAQs, exporta la tienda entera.
Disponibilidad por plan y cuota de enriquecimiento
El editor de FAQs está incluido en Growth, Pro y Agency. Generar FAQs con IA gasta tus créditos mensuales de enriquecimiento:
- Cada generación cuesta un crédito, pidas las FAQs que pidas. 1 producto × 5 FAQs = 1 crédito; 1 producto × 15 FAQs = 1 crédito; 50 productos = 50 créditos.
- Una generación que no crea nada es gratis: por ejemplo, cuando todas las propuestas repetían una pregunta que ya existía.
- Eliminar una FAQ con "Generar una nueva FAQ que reemplace a esta" marcado es una generación y cuesta un crédito.
- Escribir FAQs a mano, importar un CSV y usar la Biblioteca no cuestan nada.
Antes de generar, el dashboard te enseña el coste y los créditos que te quedan. Si no te queda ninguno, te lo dice y la generación no arranca. Para seguir antes de que acabe el mes, compra Expand credits en Facturación y plan → Complementos: mira Facturación.
A qué puedes asociar FAQs
| Tipo de entidad | BigCommerce | Shopify |
|---|---|---|
| Producto | ✓ | ✓ |
| Variante | ✓ | ✓ |
| Categoría | ✓ | — |
| Colección | — | ✓ |
| Marca | ✓ | ✓ |
| Página | ✓ | ✓ |
| Todos los productos, categorías, colecciones o páginas de una tienda | ✓ | ✓ — con una respuesta de la Biblioteca, mira abajo |
Las FAQs de variantes y de marcas solo llegan a tu storefront con el script de embed, poniendo data-entity-type y data-entity-id en la etiqueta.
Los dos tipos de FAQ
La diferencia está en de quién es la respuesta:
| FAQ de entidad | Respuesta de biblioteca | |
|---|---|---|
| Dónde la escribes | en la pestaña Preguntas frecuentes de un producto, categoría, colección o página | en Preguntas frecuentes → Biblioteca |
| De quién es | de esa entidad | de la biblioteca: no está en ninguna página hasta que la enlazas |
| Al editarla | cambia esa página | cambia todas las entidades donde está enlazada, a la vez |
| La IA | las escribe, las reescribe y las completa | nunca reescribe una respuesta de la biblioteca |
| Para qué | algo que solo es verdad de ese artículo: una especificación, una nota de compatibilidad | algo que es verdad de toda tu tienda: envíos, devoluciones, garantía |
Las dos aparecen en el mismo acordeón y en los mismos datos estructurados FAQPage.
Una respuesta de la biblioteca es de la tienda donde la escribiste
Una respuesta escrita en la Tienda A se ofrece en la Tienda A y en ninguna otra. En Quién puede usar esta respuesta, la opción por defecto es Solo seguido del nombre de tu tienda. Si tienes varios storefronts y una respuesta vale para todos, elige Todas las tiendas de esta organización al crearla.
Una respuesta privada de una tienda no se puede enlazar en las páginas de otra. Compártela o escríbele a la otra tienda la suya.
Enlazar una respuesta
En la pestaña Preguntas frecuentes de una entidad, Desde la biblioteca abre la biblioteca. Añadir enlaza una respuesta a esa entidad; + Todo en esta tienda la enlaza a todas las entidades de ese tipo de la tienda con un único enlace. Nunca llega a otra tienda.
Desde la biblioteca, En uso en … entidades abre Entidades enlazadas, donde puedes Desenlazar seleccionadas o Desenlazar todas. Desenlazar de una entidad conserva la entrada de la biblioteca.
Preguntas sugeridas
Añadir preguntas sugeridas mete en la biblioteca un juego de preguntas habituales (envíos, devoluciones, garantía, tallas, pago, contacto) sin responder, marcadas como Falta la respuesta.
Clione nunca escribe esas respuestas. Un plazo de envío o una política de devoluciones inventados serían una afirmación falsa en tu tienda, así que una pregunta sugerida no enseña nada en tus páginas hasta que la respondes. Responde las que te apliquen, cambia el texto para que suene a ti y borra el resto.
1. Añadir FAQs a mano
En la pestaña Preguntas frecuentes de una entidad, pulsa + Añadir FAQ, escribe la Pregunta y la Respuesta y pulsa Crear.
Desde Preguntas frecuentes → Avanzado → Añadir entrada de FAQ:
- Elige el Tipo de entidad: Producto, Variante, Categoría o Colección, Marca o Página.
- Busca la entidad por su nombre.
- Elige el Idioma: EN, ES, FR, DE, IT o PT.
- Escribe la Pregunta y la Respuesta (el editor de la respuesta admite formato básico).
- Haz clic en Crear entrada de FAQ.
Una respuesta pensada para muchas entidades va en la Biblioteca, no aquí.
2. Generar FAQs con IA
En dos sitios:
- Pestaña Preguntas frecuentes de la entidad → Generar con IA. Elige 3, 5, 10 o 15 FAQs (10 por defecto). Clione usa el contenido y el enriquecimiento de la entidad para escribirlas.
- Preguntas frecuentes → Avanzado → Generar FAQ con IA. Elige el Tipo de entidad, después una entidad o Toda la tienda, una Cantidad de 3, 5 o 10 (10 por defecto) y el Idioma (inglés, español, francés o alemán). Toda la tienda es una sola generación: escribe preguntas generales sobre tu tienda y las asocia a la primera entidad de ese tipo. Para cubrir todas las entidades, genera entidad por entidad.
Las FAQs generadas se guardan como aprobadas. Revísalas en la pestaña Preguntas frecuentes de la entidad o en Explorar, y edita o borra las que no te convenzan.
3. Importación masiva (CSV)
Preguntas frecuentes → Importar CSV acepta un CSV con esta cabecera:
entityType,entityId,question,answer,locale,sortOrder
product,112,What is the warranty?,2-year manufacturer warranty,en,0
collection,298,When does the sale end?,Sunday at midnight CET,en,0
entityTypeaceptaproduct,variant,category,collection,brand,page.entityIdes el ID numérico de la entidad en la plataforma, no su handle ni su URL.localees una etiqueta de idioma (en,es,es-ES,fr-FR).sortOrderes un número entero, en orden ascendente. Por defecto, 0.- La fila de cabecera es obligatoria. Guárdalo en UTF-8 (en Excel, "CSV UTF-8").
- No hay columna de tienda, a propósito: un fichero es una tienda, la que tienes abierta en la página de FAQs. El panel te la nombra antes de importar. Las filas importadas se guardan como aprobadas.
Una fila cuya pregunta ya existe en esa entidad en esta tienda se salta, así que volver a importar un fichero no cambia nada. Para cambiar una respuesta, edítala.
4. Exportar
- Por tipo: en Explorar, haz clic en ↓ Exportar CSV. Exporta las FAQs del Tipo de entidad seleccionado; la búsqueda y el filtro de Origen no se aplican.
- Toda la tienda: ↧ Descargar todas las FAQ (CSV), arriba en la página de FAQs.
La exportación añade dos columnas al principio, storeId y storeName, para que un fichero en tu disco no se confunda con el de otra tienda, y dos al final, status y source. Ninguna de las cuatro se lee al importar; las columnas de en medio son las de la importación, así que exportar y volver a importar en la misma tienda no crea nada.
5. El script de embed
Cómo llegan las FAQs a tu storefront depende de la plataforma:
- BigCommerce Stencil: el script del Schema Injector pinta el acordeón.
- Shopify Online Store: lo pinta el app embed Clione FAQ de la app de Shopify de Clione.
- Storefronts headless, WordPress y a medida: el script de embed,
embed.js.
En BigCommerce Stencil y en Shopify Online Store no necesitas el snippet: el Schema Injector o el app embed Clione FAQ ya pintan el acordeón, y si añades también el snippet las FAQs salen dos veces. El paso a paso de cada uno: Instalar el widget de FAQ.
La pestaña Script de inserción
Preguntas frecuentes → Script de inserción prepara el snippet de embed en cuatro pasos:
- Confirmar plataforma: Clione detecta tu storefront; cámbiala si no ha acertado.
- Crear clave de API: un clic crea una clave de solo lectura para el widget, restringida al dominio de tu storefront. Una sola clave sirve las FAQs de todos los tipos de entidad.
- Dar estilo al widget: los colores, la tipografía, el espaciado y el tema se convierten en atributos
data-style-*del script. El ancho máximo, las clases CSS adicionales y el CSS personalizado los aplica el propio snippet. Este paso es opcional. - Instalar en la tienda: el snippet para tu plataforma, con tu clave y tus estilos ya puestos, y dónde pegarlo.
También puedes gestionar las claves tú mismo en Ajustes de la tienda → Claves API. Ponle a la clave del widget al menos un dominio permitido: una clave sin dominios acepta peticiones de cualquier sitio, y en cuanto pones dominios, cualquier otro recibe un 403.
Qué hace el script
<div id="clione-faq"></div>
<script
src="https://api.clione.ai/embed.js"
data-api-key="sk_live_…"
data-platform="generic"
async
></script>
El script averigua de qué entidad trata la página (con data-entity-type + data-entity-id si los pones; si no, a partir del marcado y la URL de la página) y después:
- pinta el acordeón visible con las FAQs aprobadas de esa entidad;
- añade el
@graphde JSON-LD de Clione a la página en el navegador, salvo que la página ya lo traiga del servidor.
Como funciona en el navegador, los crawlers que no ejecutan JavaScript no ven lo que añade. Si eso te importa, renderiza en el servidor con la API de FAQs o el SDK @clione/seo.
Insignia "Powered by Clione"
El acordeón que pinta el script de embed muestra una pequeña insignia Powered by Clione. Viene activada; la desactivas con Mostrar «Powered by Clione» en el widget de FAQ, en Ajustes de la tienda → General → Marca. Durante la prueba siempre aparece.
Referencia de atributos
| Atributo | Obligatorio | Qué hace |
|---|---|---|
data-api-key | Sí | La clave de API del widget. |
data-platform | No | bigcommerce, shopify o generic. Si no lo pones, se detecta. |
data-target | No | Selector CSS donde se pinta el acordeón. Sin él, va dentro de un elemento con data-clione-faq o justo antes del pie de página. |
data-entity-type | No | Fuerza el tipo: product, variant, category, collection, brand, page. |
data-entity-id | No | Fuerza el ID de la entidad. Úsalo junto con data-entity-type. |
data-locale | No | Enseña las FAQs en ese idioma. |
data-heading | No | Título propio encima del acordeón. |
data-style-* | No | Aspecto: mira Personaliza el aspecto. |
Problemas frecuentes
No aparece el acordeón: la entidad no tiene FAQs aprobadas, o la página se ha asociado a otra entidad. Pon data-entity-type y data-entity-id explícitamente y mira la consola del navegador: el script dice qué ha detectado.
403 Forbidden en la consola del navegador: el dominio de la página no está entre los dominios permitidos de la clave. Añádelo en Ajustes de la tienda → Claves API.
Las FAQs salen dos veces: el script se carga dos veces, o has añadido el script de embed además del Schema Injector (BigCommerce) o del app embed Clione FAQ (Shopify). Deja solo uno.
Generar con IA no arranca: si la confirmación dice que no te quedan créditos, compra Expand credits en Facturación y plan → Complementos o espera a que se renueve la cuota del mes. Si la pestaña Preguntas frecuentes muestra un candado de plan, tu plan no incluye el editor de FAQs. Mira Facturación.