Saltar al contenido principal

Ajustes de tienda

Planes: Starter ✓ · Growth ✓ · Pro ✓ · Agency ✓ (algunas tarjetas son específicas de plataforma — Schema Injector solo BC, guía del theme app solo Shopify)

Cada tienda conectada tiene su propia página de Settings. Abre la tienda desde el sidebar y luego pulsa Settings.

La página se divide en tarjetas:

  • General settings — display name, store URL, tipo de storefront, storefront URL.
  • Credentials — ver + actualizar API token, store hash de BC, etc.
  • Schema Injector (solo BigCommerce) — instalar / desinstalar / previsualizar el script del storefront.
  • Branding — toggle del badge "Powered by Clione" por tienda.
  • Danger zone — programar el borrado de la tienda.
  • API Keys (debajo de las tarjetas) — generar/gestionar API keys del widget de embed para esta tienda.

General settings​

CampoQué es
NameDisplay name en el sidebar de tu dashboard. Elige algo que te ayude a distinguir tiendas (p. ej. EgoShoes EU, EgoShoes US).
Store URLLa URL canónica del admin / API de tu tienda. Para Shopify es your-store.myshopify.com; para BigCommerce es el API path de la plataforma.
Storefront typeClassic (tema Stencil / Liquid) o Headless. El dashboard usa esto para bifurcar flujos (p. ej. la tarjeta del Schema Injector se oculta en headless porque no hay tema en el que inyectar).
Storefront URLLa URL pública que ven los compradores (p. ej. https://shop.example.com). Esto es lo que Clione obtiene durante Verification y lo que la extensión Pulse puntúa.

Pulsa Save para aplicar cambios. Los cambios tienen efecto inmediato para nuevas operaciones.

Credentials​

La tarjeta Credentials te permite rotar o reemplazar el API token de plataforma sin volver a crear la tienda.

BigCommerce​

  • Access token — el access token de la API de BC (de tu BC API Account).
  • Store hash — el hash alfanumérico del API Path de BC (p. ej. abc123xyz de https://api.bigcommerce.com/stores/abc123xyz/v3/).

Cuando guardas, Clione fusiona con las credenciales existentes — aportar solo el access token no borrará el store hash. Esto fue un bug arreglado en #28 — versiones anteriores machacaban campos no relacionados en un guardado parcial.

Shopify​

  • Access token — el Admin API access token de tu Shopify custom app (shpat_...).

La store URL se configura por tienda, así que esta tarjeta solo coge el token.

Validación de credenciales​

Las credenciales guardadas se validan de forma diferida en la siguiente operación que las necesite (siguiente sync, siguiente propagación). Si la validación falla, la operación ofensora muestra el error y la tarjeta de credenciales muestra un chip amarillo de aviso — puedes volver a pegar y guardar sin perder tu trabajo.

Schema Injector (solo BigCommerce)​

Consulta Instala el Schema Injector. Esta tarjeta se oculta en tiendas Shopify.

Tarjeta Branding​

Override por tienda para el badge "Powered by Clione" que aparece en widgets (acordeón FAQ, páginas públicas Pulse, footers de resúmenes branded).

El toggle:

  • Está activado en Growth, Pro y Agency.
  • Está desactivado y forzado on para Starter y durante el trial. El estado desactivado muestra un tooltip explicando por qué.

El badge se refuerza vía la propia API, no solo la UI — cambiar el toggle directamente en la BD no lo saltará en Starter. Esto es un refuerzo deliberado de los Términos de Servicio.

También hay un setting de marca a nivel org en Org → Brand que cubre logo, color de acento y dominio personalizado. El toggle por tienda es lo único que vive en la página Settings a nivel tienda.

Danger zone​

Programar borrado​

Pulsar Schedule deletion arranca un periodo de gracia de 7 días durante el cual:

  1. La tienda sigue utilizable.
  2. Se manda un email de confirmación al owner de la org.
  3. La tarjeta Danger zone muestra un banner con la fecha de purga programada y un botón Cancel deletion.

Si no cancelas, la tienda y todos sus datos enriquecidos se borran permanentemente en la fecha de purga programada.

Cancelar borrado​

Pulsa Cancel deletion en cualquier momento antes de la fecha de purga para abortar. La tienda vuelve a su estado normal inmediatamente.

Reenviar email de borrado​

Si el owner no recibió el email de confirmación, pulsa Resend email en el banner para reenviar.

Panel API Keys​

Bajo las tarjetas de settings está la sección API Keys, usada para integraciones del widget de embed.

  • + Generate key — crea una nueva key con un scope (products:read por defecto), un filtro opcional de tienda y una whitelist de dominios permitidos.
  • Cada key muestra: nombre, timestamp de último uso, scopes, dominios permitidos, estado activo.
  • Acciones por fila: editar dominios, revocar (desactiva sin borrar), reactivar, borrar (permanente).

Cuando generas una key nueva, el secret se muestra una sola vez en un modal — cópialo inmediatamente. Clione solo guarda un hash SHA-256 y no puede volver a mostrar el secret. Si lo pierdes, genera una key nueva.

Consulta Editor de FAQ y Instalación del widget de FAQ para qué poner en data-api-key=.

Claves internas (auto-aprovisionadas)​

Verás keys con prefijo __ (doble underscore) que no puedes editar ni borrar. Son auto-aprovisionadas para uso interno del Schema Injector — se ocultan de la lista orientada a usuario. Si las necesitas ver, puedes ver el conteo en el footer de la página o vía la API de admin.

Notas por plataforma​

La mayoría de settings son agnósticos a la plataforma. Las dos excepciones:

  • Tarjeta Schema Injector — solo BigCommerce. Shopify usa en su lugar el theme app block, configurado en tu theme editor de Shopify.
  • Campos de credenciales — BC necesita access token + store hash; Shopify necesita solo el access token.

Configuración multi-divisa​

Si tu tienda es multi-divisa (Channels de BC con price books separados, o Markets de Shopify con precios por país), la página Settings expone la Divisa por defecto que el propagator debe usar para priceCurrency del JSON-LD. Hoy es un único valor — el JSON-LD multi-divisa consciente de request (offers como array) está en el roadmap.

BigCommerce​

  • Pulsa Channels para ver los canales que Clione ha detectado. Elige el canal por defecto para la propagación.
  • El price book asociado a la divisa del canal por defecto es lo que se propaga al price del JSON-LD.
  • Si tienes varios canales con divisas distintas, solo se propagan los precios del canal por defecto. Otros canales muestran sus propios meta tags vía el soporte nativo multi-divisa de tema de BC — Clione no los sobrescribe.

Shopify​

  • Pulsa Markets para ver los Markets que Clione ha detectado vía la Markets API.
  • Elige el Market primario.
  • La divisa del Market primario es la que se usa en el JSON-LD.
  • Los markets secundarios (p. ej. Alemania, Japón) obtienen sus tags de precio apropiados por divisa de la funcionalidad nativa Markets de Shopify.

Schedule de sync​

El sync actualmente corre solo bajo demanda — no hay sync automatizado diario construido en la página Settings. El roadmap incluye un schedule de sync por tienda (diario / semanal / cada hora). Por ahora, lanza un sync manual desde Store → Sync tras cualquier cambio de catálogo que quieras que Clione recoja.

Salud de webhooks​

Clione se suscribe a webhooks de plataforma durante el flujo de conexión:

  • BigCommerce — store/product/updated, store/category/updated, store/cart/converted, store/order/created.
  • Shopify — products/update, collections/update, orders/create, app/uninstalled.

La página Settings tiene un pequeño chip Webhook health mostrando el timestamp del último webhook recibido por tipo. Si un chip está viejo (sin webhook en >24h), ábrelo para detalles — normalmente la suscripción al webhook se deregistró en el admin de la plataforma y necesitas reconectar para volver a registrarla.

Resolución de problemas​

"Failed to save: no changes" — Pulsaste Save sin cambiar ningún campo. El dashboard rastrea el dirty state para evitar peticiones PATCH vacías.

La tarjeta Schema Injector muestra "checking" eternamente — Problema de red o timeout de la API de BC. Hard refresh. Si persiste, tu token de API de BC puede haber perdido el scope Content (consulta Conectar BigCommerce).

No llegó el email de borrado — Revisa spam. Pulsa Resend email en el banner de borrado. Si sigue sin nada, escribe a soporte — la deliverability de Resend es un punto de vigilancia conocido (tarea #76).

Credenciales guardadas pero el siguiente sync sigue diciendo "no credentials" — Hard refresh y reintenta. Las credenciales se cachean en la API durante 60 segundos.

Toast "Storefront unreachable" al validar una nueva Storefront URL — La URL que pusiste devuelve 4xx / 5xx. Prueba a abrirla en una pestaña privada del navegador; si carga para ti pero no para Clione, tu storefront puede bloquear la IP de nuestro datacenter — contacta a soporte para whitelist.

Tiendas fantasma re-apareciendo tras borrado — Bug conocido (#79). Tiendas llamadas "Starter Shopify Store" o "Store to Delete" a veces se regeneran tras el borrado. Workaround: borrar vía el path de Superadmin (si eres superadmin) o contactar a soporte.

El campo store hash de BC muestra el hash incorrecto tras editar el access token — Arreglo de bug conocido de #28. Actualiza limpiando ambos campos y pegando ambos frescos. Si el hash incorrecto persiste tras refrescar, cierra sesión y vuelve a entrar para forzar un re-fetch de sesión.

Access token de Shopify rechazado con "Invalid API key" — El formato del token debe empezar con shpat_ para Admin API. Si por error pegaste el token de la Storefront API (shpsa_), no funcionará — Clione necesita scope Admin. Vuelve a emitir el token de la Custom App.

Audit log por tienda​

Cada acción de tienda se registra. Visible en Store → Audit:

  • Actualizaciones de credenciales (paste de token, cambio de store hash).
  • Ejecuciones de sync (start, finish, error).
  • Ejecuciones de enrichment.
  • Ejecuciones de propagation.
  • Install / uninstall del Schema Injector.
  • Toggle del badge de branding.
  • Cambios de settings a nivel tienda.
  • Asignación de miembro a / quitar de la tienda (Agency).

La retención sigue el setting de retención a nivel org — 90d en Growth, 180d en Pro, 365d en Agency.

Reconectar tras una rotación de token​

Si rotas tu token de BC o el token de la Custom App de Shopify del lado de la plataforma, la siguiente operación de Clione fallará con 401. Para reconectar:

  1. Genera el nuevo token en la plataforma (mismo procedimiento que el setup inicial).
  2. Abre la tienda en Clione → Settings → Credentials.
  3. Pega el nuevo token.
  4. Pulsa Save and validate. Clione hace una llamada de test rápida para confirmar que el token funciona.
  5. Si la validación tiene éxito, el siguiente sync recogerá el nuevo token automáticamente. Los webhooks siguen suscritos.

Si la validación falla con el nuevo token, se restaura el token previo. Verás un mensaje de error claro.