Sync Data

Sincroniza tus productos, meta-campos y suscriptores de Shopify con Clerk. Esta guía cubre la creación de una app en el Panel de Desarrolladores de Shopify, la personalización de los datos de productos y la sincronización de la información de suscriptores.

Configurar sincronización de datos #

Para sincronizar los datos de tu tienda Shopify con Clerk, debes crear una app en el Panel de Desarrolladores de Shopify y configurarla en Clerk. El usuario que configura la sincronización debe tener acceso al Panel de Desarrolladores y permisos para desarrollar apps en la tienda de Shopify.

Requisitos de acceso: Solo los propietarios de la tienda o el personal con permisos en el Panel de Desarrolladores pueden crear la app (no a través de acceso colaborativo). Si estás configurando para un cliente, necesitas acceso como personal o las credenciales de la app que ellos te provean.

Crear la app #

1. En Shopify, haz clic en Settings.

2. Haz clic en Apps and sales channels.

3. Haz clic en Develop apps.

4. Haz clic en Build apps in Dev Dashboard.

   • Si no ves esta opción, haz clic en Learn more.
   • En la nueva ventana que se abre, haz clic en Go to Dev Dashboard.
   • Alternativamente, puedes abrir el Dev Dashboard directamente después de iniciar sesión.

5. En el Panel de Desarrolladores, haz clic en Create App.

6. Ingresa Clerk.io como nombre de la app.

7. En App URL, añade el placeholder estándar de Shopify para apps: https://shopify.dev/docs/apps/default-app-home

8. En Embed App in Shopify Admin, desmarca la casilla. La app solo necesita instalarse una vez y no es necesario que aparezca en el menú lateral de Shopify.

9. En Webhooks API Version, selecciona la versión más reciente (al menos 2025-07).

Configurar permisos #

10. En Access scopes, otorga acceso de solo lectura (permisos que comienzan con read_) a lo siguiente:

• Customers

• Inventory

• Locales

• Markets

• Metaobjects

• Online Store Pages

• Orders

• Products

• Store Content

• Translations

11. Al final de la pantalla, haz clic en Release.

Instalar la app #

12. Haz clic en Home, luego haz clic en Install app en la esquina superior derecha.

13. Shopify te redirigirá a una página donde seleccionas la tienda de Shopify donde instalar la app. Elige tu tienda de la lista.

14. En la página siguiente, revisa el resumen de los detalles de la app y haz clic en Install en la esquina inferior derecha.

Conectar con Clerk #

15. Regresa al Panel de Desarrolladores y haz clic en Settings dentro de la app Clerk.io. Aquí encontrarás el Client ID y el Client Secret.

16. Ve a my.clerk.io > Data > Configuration. En Sync Method, selecciona Shopify.

17. Pega el Client ID y el Client Secret en el formulario. Luego haz clic en Start Sync.

Problema conocido: Shopify puede fallar al generar un token en la primera sincronización, causando un error de autenticación. Este es un problema intermitente conocido en Shopify. Simplemente espera 1-2 minutos y vuelve a intentar la sincronización.

Personalizar los datos del producto #

En Shopify, los meta-campos y otros atributos que crees pueden sincronizarse a través de my.clerk.io > System status > Data sync.

Simplemente dirígete al campo de entrada llamado Custom Attributes y escribe los atributos de productos que deseas incluir.

Para añadir varios atributos, sepáralos con comas.

Los atributos siempre deben escribirse usando su key.

Normalmente será en minúscula. Por ejemplo, el atributo “Sizes” debe ser “sizes”.

No necesitas incluir el namespace - Clerk lo detectará automáticamente a partir del key.

En Shopify, usualmente puedes encontrar estos keys localizando tu atributo en Settings > Custom data > Products/Variants:

Sincronizar suscriptores #

Shopify permite gestionar suscriptores directamente en la plataforma.

Estos se pueden sincronizar fácilmente con Clerk.

Al activarse, importaremos el atributo “subscribed: true” para cualquier dirección de correo electrónico que esté suscrita en Shopify.

Esto se puede utilizar para Auto-Email.

Simplemente ve a tu tienda en my.clerk.io, luego a Data -> Configuration y establece Include Subscriber State en Yes. Luego haz clic en Save y comienza una nueva sincronización.

Si quieres utilizar un enlace de baja para los clientes, cada cliente que se extrae de un backend de Shopify tiene un atributo unsub_url que se puede utilizar para los diseños de auto email en el campo para darse de baja: {{customer.unsub_url}}

La versión del Webhooks API debe estar configurada al menos en 2022-04, que es cuando se añadió este soporte. Puedes comprobarlo en la app que creaste para Clerk en el Panel de Desarrolladores, bajo Settings.

App personalizada heredada #

Desde enero de 2026, Shopify ya no permite la creación de apps personalizadas directamente en el administrador de Shopify para las tiendas. Las apps personalizadas existentes seguirán funcionando, pero este método solo debe usarse si ya tienes una app personalizada creada. Para todas las demás configuraciones, utiliza el método del Panel de Desarrolladores anterior.

Si ya tienes una app personalizada y necesitas utilizarla o modificarla, selecciona Shopify (Legacy Custom App) como el Sync Method en my.clerk.io > Data > Configuration.

Estos pasos solo aplican si tu tienda Shopify aún tiene acceso para crear apps personalizadas en el administrador de Shopify.

1. En Shopify, ve a Apps > App and sales channel settings y haz clic en Develop apps.

2. Haz clic en Create app, nómbrala “Clerk.io”, elige al desarrollador de la app, luego haz clic de nuevo en Create app.

3. Haz clic en Configuration → Admin API integration → Configure.

4. En Admin API access scopes, otorga acceso de solo lectura (permisos que comienzan con read_) a lo siguiente:

   • Customers

   • Inventory

   • Locales

   • Markets

   • Metaobjects

   • Online Store Pages

   • Orders

   • Products

   • Store Content

   • Translations

5. Haz clic en Save, luego en Install App → Install.

6. Abre API Credentials y copia tu dominio de Shopify y la clave API de la app, Access Token y Secret Key.

7. Ve a my.clerk.io > Data > Configuration. En Sync Method, selecciona Shopify (Legacy Custom App).

8. Pega estos valores en el formulario. Elige un tamaño de imagen predeterminado si se solicita, luego haz clic en Start Sync.