Sync Data

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

Configurar la sincronización #

La configuración cuenta con dos partes: crear e instalar una aplicación en Shopify, y luego ingresar sus credenciales en my.clerk.io. Completa ambas partes antes de iniciar la primera sincronización.

Antes de configurar la sincronización, asegúrate de tener el dominio actual .myshopify.com de la tienda. Si es necesario, sigue los pasos para el dominio de Shopify.

En Shopify #

Completa estos pasos en el Panel de desarrolladores de Shopify. Consulta la guía actual de aplicaciones del Panel de desarrolladores de Shopify si cambian las etiquetas.

Crear aplicación #

1. Abre el Panel de desarrolladores de Shopify e inicia sesión.
2. En la navegación izquierda, abre Apps y haz clic en Create app.
3. Selecciona Start from Dev Dashboard, ingresa Clerk.io como nombre de la aplicación y haz clic en Create.

Configurar aplicación #

1. Abre la pestaña Versions para la nueva aplicación.
2. En App URL, ingresa https://shopify.dev/apps/default-app-home. La aplicación solo proporciona acceso API y no necesita una interfaz administrativa incrustada.
3. En Webhooks API Version, selecciona la versión más reciente disponible.
4. Agrega los ámbitos de acceso listados en la siguiente sección.

Configurar ámbitos #

Otorga los siguientes ámbitos. Permiten a Clerk.io importar el catálogo, pedidos, clientes, páginas, mercados, ubicaciones y datos relacionados necesarios para la integración de Shopify. Puedes pegar la lista completa en el campo de ámbito de acceso:

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

¿Por qué necesitamos acceso de escritura? Clerk.io solo lee datos, pero Shopify requiere el ámbito write_customers para acceder a campos de URL de marketing de clientes, como customer.unsub_url.

También puedes elegir los ámbitos individualmente:

• Clientes (read_ y write_)
• Inventario (read_)
• Locales (read_)
• Ubicaciones (read_)
• Mercados (read_)
• Markets Home (read_)
• Metaobjetos (read_)
• Páginas de tienda online (read_)
• Pedidos (read_)
• Todos los pedidos (read_)
• Productos (read_)
• Publicaciones (read_)
• Contenido de tienda (read_)
• Traducciones (read_)

Vuelve a la pestaña Versions de la aplicación y haz clic en Release después de agregar los ámbitos.

Instalar aplicación #

Instala la aplicación liberada en la tienda de Shopify que se sincronizará con Clerk.io.

1. En la aplicación, abre Home y haz clic en Install app.
2. Selecciona o crea la tienda Shopify.
3. Revisa el acceso solicitado y haz clic en Install.

En Clerk.io #

Completa estos pasos en my.clerk.io usando las credenciales de Shopify. El equipo de la tienda puede realizar esto directamente, o compartir de forma segura las credenciales con un tercero que esté configurando la sincronización de Clerk.io.

Configurar sincronización #

1. En el Panel de desarrolladores de Shopify, abre los Settings de la aplicación Clerk.io y copia el Client ID y el Client Secret, o obténlos a través de una entrega segura aprobada por el equipo de la tienda de Shopify.
2. En my.clerk.io, abre la Tienda relevante y ve a Data > Configuration.
3. Establece Sync Method en Shopify.
4. Ingresa el dominio actual .myshopify.com de la tienda Shopify en Shopify Domain. No ingreses el dominio personalizado público, https:// ni ninguna ruta.
5. Pega el Client ID y el Client Secret en los campos correspondientes.
6. Haz clic en Save, luego haz clic en Start Sync.

Mantén el Client Secret en privado. Compártelo solo a través de un canal seguro aprobado y nunca lo agregues a un documento público, ticket de soporte o chat.

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

Mercados e inventario #

Si operas con múltiples mercados, locales o ubicaciones de inventario en Shopify, 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 en Shopify. Para un mapeo completo por campo, consulta configuración de integración de Shopify.

Datos de variantes #

Los datos de variantes de Shopify pueden comportarse diferente dependiendo de la configuración Import only stock variant data.

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

• variant_inventory_policy (lista de cadenas)
• variant_inventory_tracking (lista booleana)
• variant_list_prices (lista numérica)
• variant_names (lista de cadenas)
• variant_option_size (lista de cadenas)
• variant_prices (lista numérica)
• variant_stocks (lista numérica)
• variant_weight (lista numérica)
• variant_weight_unit (lista de cadenas)
• variants (lista de cadenas, 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 la opción Import only stock variant data está habilitada, estas listas solo incluyen variantes con stock disponible.

Personalizar los datos del producto #

En Shopify, los campos meta 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 a incluir.

Para agregar varios atributos, sepáralos con comas.

Los atributos deben escribirse siempre usando su key.

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

No necesitas incluir el namespace; Clerk.io lo encontrará automáticamente en base a la key.

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

Sincronizar suscriptores #

Shopify admite la gestión de suscriptores directamente en la plataforma.

Estos pueden sincronizarse fácilmente con Clerk.io.

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

Luego esto puede usarse para Auto-Email.

Simplemente ve a tu tienda 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 deseas usar un enlace para darse de baja para los clientes, cada cliente extraído de un backend de Shopify tiene un atributo unsub_url que puede usarse para los diseños de auto email en el campo de baja: {{customer.unsub_url}}

La versión de la API de Webhooks debe estar configurada al menos en 2022-04, donde se agregó este soporte. Puedes comprobarlo en la aplicación creada para Clerk.io en el Panel de desarrolladores bajo Settings.

Aplicación personalizada heredada #

A partir de enero de 2026, Shopify ya no permite crear aplicaciones personalizadas directamente en el administrador de Shopify para las tiendas. Las aplicaciones personalizadas existentes siguen 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 Panel de desarrolladores anterior.

Si tienes una aplicación 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 aplicaciones personalizadas en el administrador de Shopify.

1. En Shopify, ve a Settings > Apps > Develop Apps.

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

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

4. Bajo Admin API access scopes, otorga acceso de lectura (ámbitos que comienzan con read_) a los siguientes. Para Customers, configúralo en Lectura y escritura (incluye write_customers).

   ¿Por qué necesitamos acceso de escritura? Clerk.io solo lee datos, pero Shopify requiere el alcance write_customers para acceder a campos de URL de marketing de clientes (por ejemplo, para sincronizar customer.unsub_url).

   Puedes pegar la siguiente cadena directamente en el campo de entrada para agregar todos los ámbitos a la 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 elegirlos individualmente:

   • Clientes (read_ y write_)
   • Inventario (read_)
   • Locales (read_)
   • Ubicaciones (read_)
   • Mercados (read_)
   • Markets Home (read_)
   • Metaobjetos (read_)
   • Páginas de tienda online (read_)
   • Pedidos (read_)
   • Todos los pedidos (read_)
   • Productos (read_)
   • Publicaciones (read_)
   • Contenido de tienda (read_)
   • Traducciones (read_)

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

6. Abre API Credentials y copia tu dominio Shopify y el 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.