El plugin de Shopify conecta tu configurador de configento.app directamente con las páginas de producto de tu tienda Shopify. Los compradores configuran, ven el precio actualizado en tiempo real y finalizan la compra a través del checkout nativo de Shopify — sin abandonar tu tienda.
Requisitos
- Tienda Shopify con un tema Online Store 2.0 (p. ej. Dawn, Sense, Refresh, Origin o temas premium actuales). Los temas legacy sin plantillas JSON no son compatibles.
- Cuenta activa de configento.app
- Al menos un componente configurador en el backend de configento.app (
admin.configento.app)
No se requiere Shopify Plus — el plugin funciona en todos los planes de Shopify.
Instalación
- Buscar «Configento Configurator» en el Shopify App Store.
- Hacer clic en Agregar aplicación.
- Confirmar la pantalla de permisos.
- Shopify redirige automáticamente al Admin Integrado del plugin.
Configuración inicial
Tras la instalación, el Admin Integrado se abre directamente dentro del backend de Shopify.
Paso 1 — Vincular tu cuenta de configento.app
- Iniciar sesión en el Portal de servicio (
service.configento.app). - Hacer clic en «Crear conexión con Shopify» → configento.app genera un código de incorporación de 6 dígitos (válido durante 15 minutos).
- Introducir el código en el Admin Integrado de Shopify → Conectar.
- El estado cambia a «Conectado a: \<tu cuenta>».
Nota: La conexión es 1 a 1 (una tienda Shopify ↔ una cuenta configento.app). Para vincular la tienda a otra cuenta, desinstala y reinstala la aplicación.
Paso 2 — Vincular un producto a un componente configurador
En el Admin Integrado → pestaña «Productos»:
- Se muestra una lista de todos los productos de Shopify con su asignación de configurador actual.
- Por producto: seleccionar un componente de configento.app en el menú desplegable.
- La selección se guarda inmediatamente como un metafield en el producto.
Alternativa: El metafield también puede configurarse directamente en el Admin de Shopify: abrir un producto → Metafields → Espacio de nombres configento, Clave component_id, Tipo single_line_text_field, Valor = ID del componente (numérico, p. ej. 10244).
Paso 3 — Colocar el bloque de aplicación del tema
El bloque del configurador debe activarse una vez por tema:
- En el Admin Integrado, hacer clic en «Agregar bloque de tema».
- Shopify abre el editor de temas y añade automáticamente el bloque de Configento a la plantilla de la página de producto.
- Importante: Arrastrar y soltar el bloque entre la descripción del producto y el elemento de precio.
- Guardar.
Configuración del bloque en el editor de temas:
| Configuración | Por defecto | Descripción |
|---|---|---|
| URL del backend de Configento | https://admin.configento.app |
Cambiar solo si justSelling indica explícitamente otro host |
| Selector CSS del precio del tema | vacío | La detección automática funciona para la mayoría de los temas |
| Colocar automáticamente el configurador sobre el precio | activado | Mueve el bloque antes del elemento de precio al cargar |
| Mostrar resumen de la configuración | desactivado | Muestra un resumen textual bajo el configurador |
| Texto de carga | vacío | Selección automática de idioma (DE/EN/ES/FR) |
¿Qué ocurre al comprar?
- El comprador abre la página del producto — el configurador se carga automáticamente.
- El comprador realiza su selección — el precio en el tema se actualiza en tiempo real.
- El comprador hace clic en «Agregar al carrito» — la configuración se guarda y los atributos elegidos aparecen en el carrito como un bundle.
- El checkout se realiza a través del checkout nativo de Shopify — todos los métodos de pago, códigos de descuento y funcionalidades de Shopify siguen disponibles.
Soporte multilingüe
El plugin es compatible con alemán, inglés, español y francés. El configurador del storefront sigue automáticamente el idioma de la tienda Shopify. Los demás idiomas utilizan el inglés como alternativa.
Editar una configuración guardada
El plugin activa automáticamente un enlace «Editar» en la página del carrito. Los compradores pueden volver a la página del producto y ajustar su configuración — mientras no se haya completado el checkout. Este comportamiento puede desactivarse en el editor de temas bajo «Integraciones de aplicaciones».
Resolución de problemas
El configurador no se muestra:
| Síntoma | Causa | Solución |
|---|---|---|
| Área completamente vacía | Bloque de aplicación del tema no activado | Admin Integrado → «Agregar bloque de tema» |
| El texto de carga permanece | ID de componente faltante o inválido | Admin Integrado → «Productos» → asignar componente |
| Mensaje de error tras 8 segundos | Nube de configento.app no accesible | Verificar status.configento.app |
Precio incorrecto en el carrito:
| Síntoma | Causa | Solución |
|---|---|---|
| Sin recargo en el carrito | Cart Transform Function inactiva | Reabrir el Admin Integrado |
| Diferencia de precio entre la página del producto y el carrito | Puente de divisa/impuesto mal configurado | Verificar la pestaña de precios en el Admin Integrado |
La conexión falla:
| Síntoma | Causa | Solución |
|---|---|---|
| «Código inválido o expirado» | Código de más de 15 minutos | Generar un nuevo código en el Portal de servicio |
| «Tienda ya conectada» | Conexión existente con otra cuenta | Desinstalar y reinstalar la aplicación |