Sync Data

Sincroniza tus productos de Shopify, meta-campos y suscriptores con Clerk. Esta guía cubre 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, necesitas crear una app personalizada en Shopify y configurarla en Clerk.

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, luego haz clic nuevamente en Create app.

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

4. Bajo Admin API access scopes, concede acceso de lectura (scopes 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 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 y pega estos valores en el formulario. Elige un tamaño de imagen predeterminado si se solicita y luego haz clic en Start Sync.

Personalización de datos de productos #

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.

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

No necesitas incluir el namespace - Clerk lo encontrará automáticamente basado 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 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 Email suscrita en Shopify.

Esto luego se puede usar para Auto-Email.

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

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

La versión del Webhook API de Shopify debe estar configurada al menos en 2022-04, donde se añadió este soporte. Puedes verificar esto en la app creada para Clerk > Configuration > Admin API integration > Edit > Webhook subscriptions