Integración con Shopify
Epinium se conecta con tu tienda de Shopify a través de una app que creas tú mismo, en tu propia cuenta de Shopify. Ya no existe una app compartida de Epinium: cada tienda tiene la suya, con sus propias credenciales, y solo tú tienes acceso a ellas.
El alta empieza en Shopify, no en Epinium: configuras tu app en el panel de desarrolladores de Shopify y, al final, vuelves aquí para pegar tres datos y terminar la conexión.
Las capturas están en español
Las capturas de esta guía se tomaron con el panel de Shopify en español. El tuyo aparecerá en el idioma de tu cuenta de Shopify, y algunos nombres de botones o campos pueden variar ligeramente entre versiones. Sigue el orden y la posición de cada captura: son iguales en todos los idiomas.
Antes de empezar
- Acceso de administrador a tu tienda de Shopify.
- Una cuenta de Shopify Partners: es donde se crea la app. Si no tienes una, la creas en el paso 2.
- Unos 10-15 minutos: el proceso tiene bastantes pasos, pero cada uno es sencillo.
- Dos pestañas abiertas: esta guía y, en Epinium, Configuración → Conexiones. Vas a copiar datos de una pantalla a la otra varias veces.
Paso 1: localiza la dirección de tu tienda
Antes de tocar nada en Shopify, necesitas un dato: la dirección interna de tu tienda, la que termina en .myshopify.com (por ejemplo, mi-tienda.myshopify.com). La encontrarás en el panel de administración de tu tienda, en Configuración → Dominios, listada como el dominio de Shopify de la tienda. Apunta el trozo antes de .myshopify.com: lo necesitarás dos veces más adelante.
No es el dominio que ven tus clientes. Aunque tengas un dominio propio conectado, Shopify asigna a toda tienda una dirección .myshopify.com interna, y es esa la que hace falta aquí: confundir las dos es el error más habitual de todo el proceso.
Paso 2: entra en el Dev Dashboard de Shopify
Entra en partners.shopify.com con tu cuenta de Shopify Partners, o crea una si todavía no la tienes.
Haz clic en el nombre de tu cuenta, arriba a la derecha, y selecciona "Panel de control del desarrollador".
Paso 3: crea la app
En el Dev Dashboard, ve a la sección Apps y haz clic en "Crear app", arriba a la derecha.
Shopify te ofrece dos formas de crear la app. Usa la de la derecha, "Empezar desde el Dev Dashboard": escribe un nombre para tu app (por ejemplo, el nombre de tu tienda) y haz clic en "Crear app".
Paso 4: configura los permisos que necesita Epinium
Shopify te lleva a la pantalla de configuración de la nueva versión de tu app. Baja hasta la sección "Acceso a la API" y busca el campo "Alcances".
Ahora abre, en otra pestaña, Configuración → Conexiones en Epinium y busca la tarjeta de Shopify (la misma pantalla de la captura del paso 13). Ahí verás la lista completa de permisos que tu app necesita declarar, con un botón para copiarla entera - cópiala siempre desde ahí, nunca de un documento, y pégala en el campo "Alcances" de Shopify.
Mientras estás en esta pantalla, rellena también el campo "URL de la app" con https://app.epinium.com/settings/connections: es la pantalla de Epinium a la que Shopify te devuelve después de dar tu consentimiento. Puedes dejar el resto de campos de esta sección tal y como están.
Paso 5: indica la URL de redirección y publica la versión
Más abajo, en la misma pantalla, busca el campo "URL de redireccionamiento permitidas". Vuelve a la pantalla de Shopify en Epinium (la misma del paso 13) y copia la URL de redirección con su propio botón de copiar - es el otro dato que verás junto a la lista de permisos. Pégala aquí.
Cuando termines, haz clic en "Lanzar", arriba a la derecha, para publicar esta versión de tu app.
Paso 6: copia el ID de cliente y el secreto
En el menú de la izquierda de tu app, entra en "Configuración de la app". En la sección "Credenciales" verás el "ID de cliente" y el "Secreto" (haz clic en el icono del ojo para revelarlo). Copia los dos con el icono de copiar que tienen al lado: los necesitarás al final de esta guía.
No pulses "Rotar"
El botón rojo "Rotar" genera un secreto nuevo e invalida el actual. Si más adelante ya tienes una conexión funcionando en Epinium con este secreto, rotarlo la rompe: tendrás que volver a conectar con el secreto nuevo.
Guarda estos dos datos con cuidado: Shopify solo te muestra el secreto en esta pantalla.
Paso 7: busca tu app en el panel de distribución
Vuelve a la página principal de Shopify Partners (no al Dev Dashboard). En el menú de la izquierda, entra en "Distribución de la aplicación" → "Todas las aplicaciones" y haz clic en el nombre de tu app.
Paso 8: elige cómo se distribuye la app
En la página de tu app, haz clic en "Elegir la distribución".
Paso 9: selecciona distribución personalizada
Shopify te ofrece dos opciones. Elige "Distribución personalizada" - "Distribución pública" es para publicar en la Shopify App Store, y no es lo que necesitas - y haz clic en "Seleccionar".
Paso 10: indica el dominio de tu tienda
Escribe la dirección .myshopify.com que localizaste en el paso 1 y haz clic en "Generar enlace". Deja la casilla de instalación en varias tiendas tal y como está, salvo que sepas que tu organización tiene más de una tienda Plus.
Paso 11: copia el enlace de instalación
Shopify genera un enlace único para tu tienda. Cópialo con el botón "Copiar".
Paso 12: instala la app en tu tienda
Abre el enlace que acabas de copiar en una pestaña nueva, con la sesión iniciada como administrador de tu tienda. Shopify te muestra a qué necesita acceder la app, agrupado por tipo de dato, y un botón "Instalar".
Esta es la pantalla donde apruebas de una vez todos los permisos de la lista que pegaste en el paso 4. Revísalos y haz clic en "Instalar".
Paso 13: vuelve a Epinium y termina la conexión
Con la app instalada, ve a Configuración → Conexiones en Epinium y busca la tarjeta de Shopify:
- Introduce el dominio de tu tienda (el mismo del paso 1).
- Pega el ID de cliente y el Client secret que copiaste en el paso 6.
- Haz clic en "Conectar".
Se abre una ventana de Shopify para terminar de autorizar el acceso. Cuando se cierre, tu tienda queda conectada y disponible para las herramientas de Epinium que la usen.
Tus datos y el modelo de IA
Epinium no retiene los datos de tu tienda de Shopify ni los envía a ningún modelo de IA propio. Si usas funciones de IA sobre tu catálogo, eres tú quien elige y paga el modelo que prefieras, conectándolo por tu cuenta.
Problemas frecuentes
Epinium no reconoce mi tienda tras instalar la app
Causa más común: el dominio introducido en Epinium no coincide exactamente con la dirección .myshopify.com de tu tienda (paso 1).
Solución: revisa que el dominio no lleve mayúsculas, espacios ni tu dominio propio - por ejemplo, mitienda.com en vez de mitienda.myshopify.com.
La conexión se queda a medias o Shopify nunca completa la autorización
Causa más común: la "URL de la app" y la "URL de redireccionamiento permitidas" de tu app en Shopify no son exactamente las indicadas en los pasos 4 y 5. Shopify no avisa cuando una de las dos está mal escrita: el proceso simplemente no llega a completarse.
Solución: entra de nuevo en la configuración de tu app en el Dev Dashboard y comprueba las dos URL con calma, comparándolas con lo que copiaste de Epinium.
He rotado el secreto de mi app y la conexión ha dejado de funcionar
Causa: cada conexión de Epinium usa el secreto que le diste al conectar. Si lo rotas en Shopify, o creas una app nueva, el secreto antiguo deja de servir.
Solución: ve a Configuración → Conexiones, abre de nuevo la conexión de esa tienda y pega el nuevo ID de cliente y Client secret.
¿Necesitas ayuda adicional?
Si el problema persiste tras seguir estos pasos, contacta con el equipo de soporte de Epinium desde el chat de la plataforma o en support@epinium.com.