Sync Data

Sincroniza tus productos de Shopify, metacampos y suscriptores con Clerk. Esta guía cubre la creación de una app en el Developer Dashboard de Shopify, la personalización de los datos de productos y la sincronización de información de suscriptores.

Configurar Sincronización de Datos #

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

Requisitos de acceso: Solo los propietarios de la tienda o el personal con permisos para el Developer Dashboard pueden crear la app (no mediante acceso colaborativo). Si estás configurando para un cliente, necesitas acceso de personal o las credenciales de la app de su parte.

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

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

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

8. Bajo Embed App in Shopify Admin, quita la marca de verificación. 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 #

1. Bajo Access scopes, otorga acceso a lo siguiente:

   • Customers (read_ y write_)
   • Inventory (read_)
   • Locales (read_)
   • Markets (read_)
   • Metaobjects (read_)
   • Online Store Pages (read_)
   • Orders (read_)
   • All Orders (read_)
   • Products (read_)
   • Store Content (read_)
   • Translations (read_)

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

Instalar la app #

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

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

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

Conectar con Clerk #

1. Vuelve al Developer Dashboard y haz clic en Settings dentro de la app Clerk.io. Aquí encontrarás el Client ID y el Client Secret.

2. Ve a my.clerk.io > Data > Configuration. Bajo Sync Method, selecciona Shopify.

3. 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 luego intenta sincronizar de nuevo.

Personalización de datos de producto #

En Shopify, los metacampos y otros atributos que crees pueden sincronizarse 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 quieres incluir.

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

Los atributos siempre deben escribirse usando su key.

Por lo general, esto será todo en minúsculas. Por ejemplo, el atributo “Sizes” debe ser “sizes”.

No necesitas incluir el namespace - Clerk lo encontrará automáticamente usando el key.

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

Sincronizar suscriptores #

Shopify permite gestionar suscriptores directamente en la plataforma.

Estos pueden sincronizarse fácilmente con Clerk.

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

Esto puede usarse luego para Auto-Email.

Simplemente ve a tu tienda de my.clerk.io, luego a 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 para desuscribirse para los clientes, entonces cada cliente que se importa desde un backend de Shopify tiene un atributo unsub_url que se puede usar para los diseños de auto email en el campo de baja: {{customer.unsub_url}}

La versión del Webhooks API debe estar configurada por lo menos en 2022-04, que es cuando se añadió este soporte. Puedes comprobar esto en la app que creaste para Clerk en el Developer Dashboard bajo Settings.

App Personalizada Legada #

Desde enero de 2026, Shopify ya no permite crear apps personalizadas directamente en el admin de Shopify para tiendas. Las apps ya existentes siguen funcionando, pero este método solo debe usarse si ya cuentas con una app personalizada configurada. Para todas las demás configuraciones, utiliza el método de Developer Dashboard mencionado arriba.

Si tienes una app personalizada existente 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 apps personalizadas en el admin 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 el desarrollador de la App y luego haz clic en Create app nuevamente.

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

4. Bajo Admin API access scopes, otorga acceso de lectura (permisos que comienzan con read_) a lo siguiente. Para Customers, configúralo en Lectura y escritura (incluye write_customers) ya que Shopify lo requiere para acceder a los campos de URL de marketing de clientes (por ejemplo, para customer.unsub_url).

   • Customers (read_ y write_)
   • Inventory (read_)
   • Locales (read_)
   • Markets (read_)
   • Metaobjects (read_)
   • Online Store Pages (read_)
   • Orders (read_)
   • All Orders (read_)
   • Products (read_)
   • Store Content (read_)
   • Translations (read_)

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

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

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 es necesario y luego haz clic en Start Sync.