Sync Data

Sincroniza tus productos de Shopify, meta-campos 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 la información de suscriptores.

Configurar la sincronización #

Para sincronizar los datos de tu tienda Shopify con Clerk, necesitas crear una app en el Developer Dashboard de Shopify y configurarla en Clerk. El usuario que configure 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 de Administrador pueden crear la app (no vía acceso colaborativo). Si la configuración es para un cliente, necesitas acceso de staff o las credenciales de la app.

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 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 app.

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

8. Bajo Embed App in Shopify Admin, quita la marca de selección. La app solo necesita ser instalada una vez y no necesita aparecer en el menú lateral de Shopify.

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

Configurar scopes #

1. Bajo Access scopes, concede acceso a los siguientes scopes. Puedes pegar la siguiente cadena directamente en el campo de entrada para añadir todos los scopes de una vez:

   read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations
   

   O puedes seleccionarlos individualmente:

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

2. En la parte inferior 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 redirige a una página donde seleccionas la tienda Shopify en la que 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 a Clerk #

1. 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.

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. Esto es un problema intermitente conocido en Shopify. Simplemente espera 1-2 minutos y vuelve a intentar la sincronización.

Mercados e inventario #

Si gestionas múltiples mercados de Shopify, idiomas o ubicaciones de inventario, confirma estos campos antes de sincronizar:

• Shopify Market
• Shopify Locale
• Prefix URLs with Locale
• Force Relative URLs
• Ubicaciones de inventario

Estos valores deben coincidir con la configuración de mercado/dominio de tu Shopify. Para un mapeo completo campo por campo, consulta Shopify integration settings.

Datos de variantes #

Los datos de variantes en Shopify pueden comportarse de manera diferente según la configuración Import only stock variant data.

Los atributos típicos de variante de Shopify en Clerk.io incluyen:

• variant_inventory_policy (lista de string)
• variant_inventory_tracking (lista de boolean)
• variant_list_prices (lista de número)
• variant_names (lista de string)
• variant_option_size (lista de string)
• variant_prices (lista de número)
• variant_stocks (lista de número)
• variant_weight (lista de número)
• variant_weight_unit (lista de string)
• variants (lista de string, IDs de variantes)

Ejemplo:

{
  "variant_inventory_policy": ["deny", "deny"],
  "variant_inventory_tracking": [true, true],
  "variant_list_prices": [240, 240],
  "variant_names": ["Xs", "M"],
  "variant_option_size": ["Xs", "M"],
  "variant_prices": [120, 120],
  "variant_stocks": [1, 7],
  "variant_weight": [0.4, 0.4],
  "variant_weight_unit": ["KILOGRAMS", "KILOGRAMS"],
  "variants": ["55970989179259", "55970989244795"]
}

Cuando Import only stock variant data está habilitado, estas listas solo incluyen las variantes con stock.

Personalizar los datos de productos #

En Shopify, los meta-campos 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 e ingresa los atributos de productos que deseas incluir.

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

Los atributos siempre deben escribirse usando su key.

Esto usualmente se escribe todo en minúsculas. Por ejemplo, el atributo “Sizes” debe ser “sizes”.

No es necesario incluir el namespace; Clerk lo encontrará automáticamente basándose en el key.

En Shopify, normalmente puedes encontrar estas keys localizando 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 se activa, importaremos el atributo “subscribed: true” para cualquier dirección de correo electrónico 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 configura Include Subscriber State en Yes. Luego haz clic en Save e inicia una nueva sincronización.

Si deseas usar un enlace de baja para clientes, cada cliente recuperado desde un backend de Shopify tiene un atributo unsub_url que puedes usar en los diseños de auto email en el campo para cancelar la suscripción: {{customer.unsub_url}}

La versión de la Webhooks API debe estar establecida al menos en 2022-04, donde se agregó este soporte. Puedes comprobarlo en la app que creaste para Clerk en el Developer Dashboard bajo Settings.

Legacy Custom App #

A partir de enero de 2026, Shopify ya no permite crear apps personalizadas directamente en el admin de Shopify para tiendas. Las apps personalizadas existentes continúan funcionando, pero este método solo debe usarse si ya tienes una app personalizada configurada. Para todas las demás configuraciones, utiliza el Developer Dashboard method de arriba.

Si tienes una app personalizada existente y necesitas usarla 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, asígnale el nombre “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 solo lectura (scopes que comienzan con read_) a lo siguiente. Para Customers, configúralo como Read and write (incluye write_customers) ya que Shopify lo requiere para acceder a los campos de URL de marketing del cliente (por ejemplo, para customer.unsub_url).

   Puedes pegar la siguiente cadena directamente en el campo de entrada para añadir todos los scopes de una vez:

   read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations
   

   O puedes seleccionarlos individualmente:

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

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

6. Abre API Credentials y copia tu Shopify Domain y las claves 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 se solicita y luego haz clic en Start Sync.