Saltar al contenido principal

Primeros pasos

Planes: Starter ✓ · Growth ✓ · Pro ✓ · Agency ✓ (todas las funcionalidades de esta página están disponibles en todos los planes de pago; algunas tienen límites por créditos — consulta Planes)

Clione lleva unos 10 minutos de punta a punta la primera vez: alta, conectar una tienda, sincronizar, enriquecer un pequeño lote y verificar que aterrizó en tu storefront. Esta página es el camino lineal.

Si quieres el contexto más amplio del producto antes de empezar, lee primero Qué es Clione.

El flujo de abajo aplica tanto a BigCommerce como a Shopify. Donde los dos divergen (principalmente en el Paso 2 y el Paso 5), esta página marca la diferencia en línea y enlaza al deep dive por plataforma.

1. Crear una cuenta (1 min)​

Clione es por invitación durante la research preview. Dos caminos:

  • Te invitaron — abre el email de invitación y sigue el enlace para poner una contraseña.
  • Aún no te invitaron — escribe a admin@takefortytwo.com o a tu account manager de T42.

Una vez tu tenant está aprovisionado, entra en app.clione.ai.

Si vas a usar una app de 2FA (recomendado), configúrala en Account → Security antes de conectar nada más — consulta Seguridad de la cuenta.

2. Conecta tu tienda (2–5 min)​

Desde el resumen, pulsa Add Store.

BigCommerce​

Pegarás un token de Store API account (Client ID + Access Token + Store Hash). Clione nunca usa BC OAuth — el camino Store API es más rápido, permite definir scopes por integración y se revoca desde tu admin de BigCommerce con un clic.

El paso a paso completo (scopes, dónde pulsar, resolución de problemas) está en Onboarding — token de API BigCommerce.

Shopify​

Pegarás un Custom App Admin API access token desde tu admin de Shopify. Aunque la capa de rutas expone OAuth, el dashboard conecta el onboarding a través del flujo de pegado de Custom App porque es inmediato y no requiere revisión de app pública.

El paso a paso completo está en Conectar Shopify.

Cuando el formulario acepta las credenciales, la tienda aparece en tu sidebar. Púlsala para entrar en su scope.

3. Sincroniza tu catálogo (3–10 min según tamaño)​

Dentro de la tienda, sidebar → Sync.

La página Sync tiene una pestaña por tipo de entidad:

  • Products — requerido.
  • Categories (BC) / Collections (Shopify).
  • Pages — pages de contenido, About, Shipping, FAQ landing, etc.
  • FAQ — informativo, las FAQs son agnósticas de plataforma y se gestionan bajo FAQs.

Pulsa Run sync en Products primero. Por debajo de 500 productos: menos de un minuto. Catálogos más grandes escalan aproximadamente de forma lineal. El chip en la barra superior sigue el progreso; puedes irte y volver.

Una vez termina Products, ejecuta lo mismo en Categories/Collections y Pages. Consulta Sincroniza el catálogo para la referencia completa.

Aún no hay nada enriquecido. El sync solo descarga el catálogo. El siguiente paso es el que lo convierte en señales.

4. Enriquece tu primer lote (2–5 min)​

Abre Products (sidebar). Elige 5–10 productos para empezar — las primeras impresiones importan, y un lote pequeño es más fácil de inspeccionar.

Tres formas de enriquecer:

  • Producto individual — abre uno → Enrich. Mejor para inspección.
  • Selección bulk — marca un rango con checkbox → barra superior → Bulk enrich. Hasta 5 a la vez sin el wizard.
  • Enrichment Wizard — cuestionario guiado que pasa pistas (tu tono de marca, posicionamiento, audiencia) al LLM. Úsalo si el LLM no tiene suficiente contexto para escribir buenas señales por sí solo.

Clione siempre pedirá confirmación antes de gastar créditos de enriquecimiento. No hay auto-enrich con el sync.

Repite para categorías/colecciones y pages. Cada tipo de entidad tiene su propio listado y las mismas acciones Enrich. Consulta Enriquece entidades para la referencia completa entre los cuatro tipos de entidad y las dos plataformas.

Tras el enriquecimiento, el auto-propagator empuja las señales al storefront en segundo plano. No necesitas pulsar nada para esto.

5. Verifica que aterrizó (1–2 min)​

Sidebar → Verification.

La página Verification coge una muestra de tus entidades enriquecidas y compara lo que Clione produjo con lo que realmente está en vivo en el storefront — meta title, meta description, presencia de JSON-LD, OG tags. Un check verde significa que la página en vivo coincide con lo que enriquecimos. Una discrepancia roja significa que el storefront no recogió el cambio.

Las razones más habituales para una discrepancia el primer día:

  • JSON-LD de Shopify no visible — la Theme App Extension no se ha activado en el tema en vivo. Consulta Schema injector.
  • Caché de Stencil de BigCommerce — purga la caché del storefront desde el admin de BC, o espera ~5 min.
  • Storefront headless — el storefront usa datos viejos del build-time. Lanza un rebuild o conecta el cliente @clione/seo. Consulta guías headless.

Referencia completa: Verification. Para cobertura de señales más profunda en muchas URLs en el tiempo, consulta Pulse dashboard.

6. Instala el Schema Injector (una sola vez, 1 min)​

El propagator empuja los metafields enriquecidos a tu storefront, pero para que el <script> tag de JSON-LD realmente se renderice en la página, necesitas activar el Schema Injector por tienda.

BigCommerce​

Sidebar → Settings → Schema Injector → Install.

Esto usa la BC Scripts API para registrar un único script global en tu storefront Stencil. El script lee el ID de entidad por página, obtiene el JSON-LD correspondiente desde el endpoint público de embed de Clione, y escribe el bloque <script type="application/ld+json"> en la página. No se modifican archivos del tema.

Para crawlers sin JS (Googlebot, Bingbot), consulta Stencil — crawlers sin JS.

Shopify​

Abre el admin de Shopify → Online Store → Themes → Customize en tu tema en vivo → Theme settings → App embeds → activa Clione JSON-LD → Save.

Esto activa la Theme App Extension que viene con la conexión de Clione. La extensión renderiza el JSON-LD inline al final de cada product / collection / page del storefront, server-rendered, así los crawlers lo ven sin ejecutar JS.

Referencia completa: Schema Injector.

7. Añade FAQs (opcional pero de alto impacto, 5 min)​

Sidebar → FAQs.

Cinco scopes de FAQ:

  • Global — aplican a cada producto (p. ej. política de envíos).
  • Product — específicas de un producto.
  • Variant — específicas de una variante (talla, color).
  • Category / Collection — aplican a todos los productos de esa categoría.
  • Page — aplican a una sola page de contenido.

Añade 3-5 FAQs de alto valor para empezar (envíos, devoluciones, materiales, fit). El editor de FAQ tiene un botón Generate from enrichment de un clic que convierte la descripción enriquecida del LLM en FAQs en borrador — revisa, edita, guarda.

Una vez existan las FAQs, instala el widget de FAQ para que se rendericen como un acordeón expandible en tu storefront. Consulta Instalación del widget de FAQ — el camino de instalación difiere por plataforma.

Tropezones habituales del primer día​

  • Saltarse el paso Sync y saltar a Enrich. Enrich opera sobre lo que ya está en la BD de Clione — primero hay que sincronizar.
  • Enriquecer todo el catálogo el primer día. Empieza con 5-10 productos. Lee lo que produce el LLM. Ajusta el Enrichment Wizard si el tono no encaja. Luego expande.
  • Olvidarse de activar la Theme App Extension de Shopify. La propagación tiene éxito, pero el storefront nunca renderiza el JSON-LD. La Verification sale en rojo. La solución es un clic en el Theme Editor — consulta el Paso 6.
  • Pegar el token Storefront API de Shopify en lugar del Admin API. Parecen similares pero los prefijos difieren (shpat_ para Admin, shpsa_ para Storefront). Solo Admin funciona.
  • Pegar el token Store API de BigCommerce en el campo OAuth. El formulario es claro, pero merece la pena destacarlo — Clione actualmente no usa OAuth en BC. Consulta Onboarding del token API de BC.
  • Tratar los Quality Scores como verdad absoluta el primer día. Son opiniones del LLM hasta que aportas evidencia vía el Wizard — consulta Entendiendo los scores.

Resolución de problemas​

La tienda no aparece en el sidebar tras aceptar el formulario de credenciales — Haz hard refresh de la página. Si sigue sin aparecer, la caché de la lista de tiendas puede estar vieja; cierra sesión y vuelve a entrar.

El sync corre pero el conteo de entidades es cero — Scopes incorrectos en el token de API. Vuelve a comprobar los scopes BC o los scopes Shopify. Vuelve a emitir el token si hace falta; no tienes que quitar la tienda en Clione, solo pega el nuevo token en Store → Settings.

La Verification sale roja para cada entidad justo después de enriquecer — La propagación corre asíncrona. Espera 60 segundos y vuelve a comprobar. Si sigue roja, el propagator se topó con un rate limit o error de autenticación — abre el modal de detalle de la fila fallida para ver el error exacto de la plataforma.

Se topa con los límites del plan durante el primer sync — Starter tiene un cap de cuenta de productos. Si tu catálogo lo supera, el sync solo importa hasta el cap y aparece un banner. Sube de plan o contacta a soporte para un alza temporal.

No encuentro la opción "Develop apps" en el admin de Shopify — Problema de permisos de staff. Pide al propietario de la tienda que la active en Settings → Users → [tu nombre] → Permissions → Develop apps.

Qué sigue​

Referencia rápida — qué cambia cada paso en tu storefront​

PasoQué se crea/modifica en tu storefront
1. CuentaNada en el storefront.
2. Conectar tiendaWebhooks suscritos; ningún cambio de UI en el storefront.
3. SyncNada en el storefront — se rellena la BD de Clione.
4. EnrichTras ~30s, el meta title y la meta description se escriben en la plataforma vía API. Al refrescar el storefront aparecen los nuevos tags.
5. VerifySolo lectura; sin cambios.
6. Schema InjectorBC: se añade un script tag vía Scripts API (carga desde el CDN de Clione). Shopify: se activa un Theme App Embed (renderiza JSON-LD server-side).
7. Widget de FAQInstalación una sola vez de un snippet JS en la(s) página(s) relevante(s).

El único paso que en algún momento modifica el markup del storefront es el Paso 6 (Schema Injector). Todos los demás pasos o bien obtienen datos de la plataforma o bien empujan datos vía la API de la plataforma a campos existentes que la plataforma expone (meta title, meta description, metafields). Clione no modifica los temas.

Si decides dejar de usar Clione, quitar el Schema Injector y el snippet del widget de FAQ devuelve tu storefront al estado pre-Clione. Los meta tags del lado de la plataforma que Clione escribió se quedan (ya son parte de tu catálogo) pero pueden sobrescribirse manualmente.

Criterios de éxito del onboarding (la checklist "ya estás listo")​

Has terminado el onboarding cuando:

  • Tu(s) tienda(s) están conectadas y visibles en el sidebar.
  • El sync ha corrido para Products, Categories/Collections y Pages — los conteos de entidades en la tarjeta Store Overview son no-cero.
  • Al menos 5 productos están enriquecidos y la pestaña Enrichment está en verde para cada uno.
  • La Verification muestra ≥80% Pass para los productos enriquecidos.
  • El Schema Injector está instalado (BC) o la Theme App Extension está activada (Shopify).
  • Has mirado el código fuente en una página de producto en vivo y confirmado que el JSON-LD está presente.
  • Has añadido al menos una FAQ (Product, Variant, Category, Page o Global).
  • Has instalado la extensión de Chrome Pulse y has corrido un scan contra tu propio storefront.
  • Has invitado a tu equipo (si aplica) y asignado roles.
  • Has revisado la página Plans y confirmado que tu tier coincide con tu uso.

Dónde acudir para obtener ayuda​

  • En la app — cada sección tiene un icono de ayuda en la cabecera de página que abre el doc relevante.
  • Sitio de docs — lo estás leyendo.
  • Email — support@clione.ai para problemas técnicos, admin@takefortytwo.com para preguntas de facturación o cuenta.
  • Comunidad — invitación a Slack en tu email de bienvenida (Pro y Agency).
  • Office hours trimestrales — plan Agency; calendario en tu dashboard de sub-tenant.