Shopify: Guía de autenticación

Para generar consultas desde la plataforma Shopify, primero debes conectar Dataslayer a Shopify. Esto requiere crear y configurar las credenciales de Shopify a través del DEV Dashboard de Shopify. Este proceso garantiza una autenticación segura y un acceso correcto a los datos de tu tienda.

Guía de autenticación: paso a paso

Esta guía explica cómo crear y autenticar una aplicación de Shopify usando el DEV Dashboard de Shopify, configurar los permisos correctamente y obtener las credenciales necesarias para el acceso a la API.

Paso 1: Accede al DEV Dashboard de Shopify

1. Ve a https://accounts.shopify.com/store-login y continua con su inicio de sesión.
2. En el menú de navegación, localiza y haz clic en la sección App and sales channel settings. Luego, haz clic en el botón Develop App.
   
   
3. Una vez en la sección App Development, haz clic en el botón Build Apps in Dev Dashboard.
   
   

Paso 2: Crear una nueva aplicación

De forma predeterminada, verás una lista de tus aplicaciones actuales. Para crear una nueva, haz clic en Create app.

Paso 3: Definir el nombre de la aplicación

Introduce un nombre para tu aplicación. Este nombre es interno y puede ser cualquier nombre que te ayude a identificar la integración.

Paso 4: Selecciona el método de distribución (Importante)

Una vez creada la aplicación:

1. Ve a la sección Home de la app (menú izquierdo). A la derecha, busca la sección Distribution y haz clic en Select distribution method.
   
   

2. Seleccione Custom distribution, ya que esta aplicación no se publicará en la tienda de aplicaciones de Shopify.
   
   
3. Aparecerá una ventana para confirmar la selección, haga clic en el botón verde Select custom distribution.
   
   
4. Introduce el store name donde quieres instalar la aplicación y haz clic en Generate Link.
   También hay una casilla de verificación. Su activación depende de cada cliente, pero dejarla marcada no afecta la funcionalidad.
   
   
5. Aparecerá una nueva ventana emergente para confirmar la acción, haga clic en el botón verde Generate Link.
   
   

Paso 5: Crea una nueva versión de la aplicación para solicitar permisos

1. De regreso al DEV Dashboard, ve a Versions en el menú de la izquierda y luego haga clic en Create a version para la aplicación.
   
   

2. Copia la URL detallada debajo y pégala en la casilla de URLs
   
   https://query-manager.dataslayer.ai/shopify/init
   
   
   Revisa que la opción Embed app in Shopify Admin no está seleccionada.
   
   
3. Baja un poco hasta encontrar la casilla de Redirect URLs y pega las siguientes 2 URLs:
   
   https://query-manager.dataslayer.ai/shopify/init, https://query-manager.dataslayer.ai/shopify/save_token_subscriptions
   
   
4. Ahora, necesitaremos solicitar acceso a todos los pedidos. La mayoría de los clientes requieren al menos un año de historial de datos, por lo que este paso es muy recomendable.
   

   1. Ve a la  sección Access y haga clic en “Request access” en la descripción.
      
      

   2. En el siguiente sitio, en la sección Read all orders scope, haga clic en el  botón Request access.
      
      

   3. Se pedirá que proporciones una justificación.

      Por ejemplo: “60 días no son útiles para análisis”.

      

   4. Una vez enviada, el estado de la solicitud debe mostrar un mensaje como Su aplicación puede acceder al historial de pedidos completo de una tienda (Your app can access the full order history for a store).

      

Paso 6: Configurar permisos (Scopes)

1. Ahora, de vuelta en la página actualizada del Panel de Desarrollo, puede definir los ámbitos necesarios navegando a la sección Access y haciendo clic en Select Scopes. 
   
   
   
   Estos son los permisos necesarios para el análisis completo y la extracción de datos:
   1. read_analytics
   2. read_customers
   3. read_fulfillments
   4. read_inventory
   5. read_orders
   6. read_products (Necesario para recuperar información del producto)
   7. read_all_orders (Solo visible después de solicitar acceso en el paso anterior)
   8. read_marketing_events (Obligatorio para la categoría Eventos de Marketing)
2. Una vez seleccionados todos los ámbitos mencionados, pulsamos en Done.
   
   
   
   

Paso 7: Publicar la versión de la aplicación

Una vez configurados los permisos:

1. Haga clic en Release en la parte superior de la página.

   
2. En la ventana emergente que aparecerá, puede dejar los campos en blanco o indicar el nombre de la versión. Luego, haga clic en Release.
   
   

Esto hace que la versión esté disponible para su instalación.

Paso 8: Instalar la aplicación en la tienda

1. Regresa a la página de inicio (Home) en el menú del DEV Dashboard.
   
   

2. En la sección Distribution, haz clic en Manage custom install link. 
   
   

3. Copia y pega en una nueva pestaña el enlace de instalación para abrirlo.

   

4. Serás redirigido al selector de cuentas de Shopify y deberás seleccionar la tienda Shopify. Elige el nombre de la tienda que definiste anteriormente.
   
   
   
   Luego, haz clic en Install.

   
   
   Una vez instalado, ya podremos obtener las credenciales que necesitaremos para iniciar sesión en la cuenta de Shopify en Dataslayer.

Paso 9: Recuperar credenciales

Después de la instalación, finalmente podrás recuperar las credenciales necesarias para la autenticación:

Ve a Settings en el menú del DEV Dashboard y busque los siguientes valores:

• Client ID → Este es el ID de cliente necesario para iniciar sesión.

• Client Secret → Este es el Client Secret requerido para la autenticación.

¡Ahora tienes la información necesaria para realizar la conexión entre Shopify y Dataslayer!

Paso 10: Registrar credenciales en Dataslayer

1. Inicia sesión en Dataslayer.ai y busca la sección del Hub.
   
   
2. Una vez allí, busca el conector de Shopify.
   
   
3. Haz clic en + Agregar nueva cuenta.
   
   
4. Copia y pega tu Client ID y Client Secret en el campo designado e ingresa el nombre de tu tienda Shopify.
   
   
5. Haga clic en Conectar una vez que se hayan completado todos los campos.
   
   

¡Listo! Se ha establecido la conexión y la cuenta se puede seleccionar en la sección "Hub Account" al crear un informe.

Troubleshooting

Issue 1: ¿No aparece la sección Método de distribución?

Si no encuentras la opción Método de distribución en el Dev Dashboard de Shopify, sigue este proceso de configuración alternativo:

Paso 1: Configura manualmente la versión de la aplicación

Crea tu aplicación como se describe en la guía principal. Al crear la versión de la aplicación, asegúrate de que los siguientes campos estén configurados exactamente:

Redirect URLs (sección Acceso):

• https://query-manager.dataslayer.ai/shopify/save_token, https://query-manager.dataslayer.ai/shopify/save_token_subscriptions

App URLs (sección URLs):

• https://query-manager.dataslayer.ai/shopify/init

Paso 2: Utiliza el campo Custom Install URL

Después de crear la versión de la aplicación:

• NO instales aún la aplicación de Shopify
• Ve a la sección Hub de Dataslayer, busca la fuente de datos de Shopify
  
  
  
  
• Localiza el campo Custom Install URL
  
  
  

Entonces:

1. Copia la URL de instalación de la sección Installs de tu Dev Dashboard de Shopify (usa el botón de copiar).
   
   
   
   
2. Pegalo en el campo Custom Install URL en Dataslayer
   
   
3. Completa:
   • Shop Name (solo el nombre de la tienda, sin https:// ni .myshopify.com )
   • Client ID y Client secret
     Esta información se muestra en la sección Settings del Dev Dashboard
     
     
     
4. Haz clic en Connect
   
   
5. Serás redirigido a la página de inicio de sesión de Shopify:
   
   • Selecciona tu tienda
   • Instala la aplicación
     
     
     
     

¡Listo! Una vez instalada, la conexión aparecerá en el Hub.

Issue 2: Error interno del servidor durante la conexión

Si encuentras un Internal Server Error, verifica lo siguiente:

• App URL y Redirect URLs correctamente configuradas
  Asegúrate de que coincidan exactamente con:
  • App URL:
    https://query-manager.dataslayer.ai/shopify/init
  • Redirect URLs:
    https://query-manager.dataslayer.ai/shopify/save_toke, https://query-manager.dataslayer.ai/shopify/save_token_subscriptions
    
    
• “Embed app in Shopify Admin” NO debe estar habilitado
  Esta opción puede interferir con el flujo de autenticación
• Usar el nombre original de la tienda (importante)
  
  

  Usar el nombre actualizado o de visualización puede causar errores de autenticación. Esto aplica específicamente al campo Shop Name.

  Asegúrate de ingresar el nombre original de la tienda en Shopify, no uno renombrado o actualizado. 

Esto completa la configuración de autenticación de Shopify. Siguiendo cada paso y verificando que todos los campos estén correctamente definidos, deberías poder establecer una conexión estable entre Shopify y Dataslayer.

Como siempre, no dudes en ponerte en contacto con nosotros a través del chat en vivo en nuestro sitio web  o por  correo electrónico  si aún tienes dudas o preguntas ¡Estaremos encantados de ayudarte!