Sync Data

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

Configurar sincronización de datos #

Para sincronizar los datos de tu tienda Shopify con Clerk, necesitas crear una aplicación en el panel de desarrolladores de Shopify y configurarla en Clerk. El usuario que configure la sincronización debe tener acceso al panel de desarrolladores y permisos para desarrollar aplicaciones en la tienda de Shopify.

Requisitos de acceso: Solo los propietarios de tiendas o el personal con permisos para el panel de desarrolladores pueden crear la aplicación (no mediante acceso colaborativo). Si la configuras para un cliente, necesitas acceso como miembro del personal o las credenciales de la aplicación proporcionadas por ellos.

Crear la aplicación #

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 Developer Dashboard, haz clic en Create App.

6. Ingresa Clerk.io como nombre de la aplicación.

7. En App URL, añade el marcador estándar de la aplicación de Shopify: https://shopify.dev/docs/apps/default-app-home

8. Bajo Embed App in Shopify Admin, quita la marca de verificación. La aplicación solo necesita ser instalada 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. Bajo Access scopes, concede acceso de solo lectura (permisos que comienzan con read_) a lo siguiente:

• Customers

• Inventory

• Locales

• Markets

• Online Store Pages

• Orders

• Products

• Store Content

• Translations

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

Instalar la aplicación #

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 en la que instalar la aplicación. Elige tu tienda de la lista.

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

Conectar con Clerk #

15. Regresa al Developer Dashboard y haz clic en Settings dentro de la app Clerk.io. Allí encontrarás el Client ID y el Client Secret.

16. Ve a my.clerk.io > Data > Configuration. Bajo 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, provocando 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 se pueden sincronizar a través de my.clerk.io > System status > Data sync.

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

Para agregar varios atributos, sepáralos con comas.

Los atributos siempre deben escribirse usando su key.

Esto normalmente estará en minúsculas. Por ejemplo, el atributo “Sizes” debe ser “sizes”.

No necesitas incluir el namespace - Clerk lo encontrará automáticamente basándose en el key.

En Shopify, a menudo puedes encontrar estas claves buscando tu atributo en Settings > Custom data > Products/Variants:

Sincronizar suscriptores #

Shopify permite gestionar a los suscriptores directamente en la plataforma.

Estos pueden sincronizarse fácilmente con Clerk.

Cuando esté activado, importaremos ese atributo “subscribed: true” para cualquier dirección de email que esté suscrita en Shopify.

Esto luego puede usarse para Auto-Email.

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

Si deseas usar un enlace de cancelación para los clientes, entonces cada cliente extraído desde un backend de Shopify tiene un atributo unsub_url que puede usarse en los diseños de auto email en el campo de cancelación de suscripción: {{customer.unsub_url}}

La versión de la API de Webhooks debe estar configurada en al menos 2022-04, donde se añadió este soporte. Puedes comprobar esto en la aplicación que creaste para Clerk en el Developer Dashboard bajo Settings.

Legacy Custom App #

A partir de enero de 2026, Shopify ya no permitirá crear aplicaciones personalizadas directamente en el panel de administración de Shopify para las tiendas. Las aplicaciones personalizadas existentes continúan funcionando, pero este método solo debe usarse si ya tienes una aplicación personalizada configurada. Para todas las demás configuraciones, utiliza el método del Developer Dashboard de arriba.

Si ya tienes una aplicación 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 de Shopify aún tiene acceso para crear aplicaciones personalizadas en el panel de administración 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, ponle como nombre “Clerk.io”, elige el desarrollador de la aplicación, luego haz clic en Create app nuevamente.

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

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

   • Customers

   • Inventory

   • Locales

   • Markets

   • Online Store Pages

   • Orders

   • Products

   • Store Content

   • Translations

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

6. Abre API Credentials y copia tu dominio de Shopify y la API Key, Access Token y Secret Key de la aplicación.

7. Ve a my.clerk.io > Data > Configuration. Bajo 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.