Integraciones

Shopify con una app personalizada

Conecta una tienda Shopify a AmICited con tu propia app personalizada del Shopify Dev Dashboard en lugar de la app de la App Store: permisos, Client ID y secret, y limitaciones.

Abrir en ChatGPT Abrir en Claude

La forma habitual de conectar Shopify es la app de FlowHunt de la Shopify App Store (consulta tiendas online). Si no quieres una app pública en tu tienda, o la política de tu tienda bloquea las instalaciones desde la App Store, puedes conectarte con una app personalizada que creas tú mismo en el Shopify Dev Dashboard.

Una vez conectada, una app personalizada funciona igual que una instalación desde la App Store: el presupuesto de importación, la importación histórica de pedidos y productos, los informes Eshop, el link building y el CMS.

Las integraciones de ecommerce están disponibles desde el plan Pro, y solo los administradores del espacio de trabajo pueden conectarlas.

Antes de empezar#

Usa la organización de Shopify de la propia tienda. La app debe pertenecer a la misma organización de Shopify que la tienda. Una agencia no puede usar su propia app en la tienda de un cliente, así que es el cliente quien debe crear la app.
Facturación con tarjeta. Los espacios de trabajo facturados a través de Shopify no pueden usar una app personalizada. Cambia primero el plan a facturación con tarjeta.
Permisos en Shopify. Necesitas poder crear apps en el Dev Dashboard de la tienda (el propietario de la tienda o una cuenta de personal con permiso para desarrollar apps).

Crea la app en Shopify#

Abre el desarrollo de apps en la administración de Shopify
En la administración de Shopify, haz clic en Settings, luego en Apps, después en Develop apps, y haz clic en Build apps in Dev Dashboard. También puedes ir directamente al Shopify Dev Dashboard e iniciar sesión con la cuenta propietaria de la tienda.
Crea la app
En el Dev Dashboard, abre Apps y haz clic en Create app. Si tu organización ya tiene apps, haz clic en Create app arriba a la derecha y elige Create app manually.
Completa los datos de la app y sus permisos
- App name (1): cualquier nombre que reconozcas, por ejemplo “AmICited”.
- App URL (2): https://app.flowhunt.io/. Desmarca Embed app in Shopify admin; la app no tiene pantalla propia dentro de Shopify.
- Allowed redirection URL(s): déjalo vacío. AmICited inicia sesión con el Client ID y el Client secret de la app, así que Shopify nunca redirige de vuelta a AmICited. Deja Use legacy install flow sin marcar.
- Scopes (3, en API access): pega esta lista. Son los permisos que solicita la app de la App Store, así que la app personalizada obtiene todas las funciones de AmICited salvo el historial de pedidos de más de 60 días (ver más abajo):
text
```
read_orders,write_orders,read_products,write_products,read_customers,write_customers,read_inventory,write_inventory,read_locations,write_price_rules,read_content,write_content,read_themes,write_themes,read_locales
```
Deja Webhooks API version como está.
¿Prefieres marcar casillas en lugar de pegar? Haz clic en Select from list encima del campo Scopes, busca cada permiso de la lista anterior (1), márcalo y haz clic en Done (2).
Crea la app
Cuando hayas rellenado el nombre, la URL y los permisos, haz clic en Create app arriba a la derecha del formulario (4 en la captura del formulario de arriba). Shopify crea la app y publica su primera versión.
Comprueba que la versión está activa
Abre Versions en el menú de la app: la primera versión aparece marcada como Active. Si cambias los permisos más adelante, haz clic en Create version para que el cambio surta efecto.
Configura la distribución como personalizada
Una app personalizada tiene que limitarse a tu propia tienda antes de poder instalarla en ella.
1. En la página Overview de la app, haz clic en la tarjeta Distribution (Manage custom install link). Shopify abre el Partners Dashboard; si te lo pide, elige la cuenta que usas para la tienda.
2. Selecciona Custom distribution (1) y haz clic en Select (2). Shopify no permite cambiar el método de distribución después.
3. En Store domain, introduce la dirección your-store.myshopify.com de tu tienda (1; consulta Encuentra la dirección de tu tienda más abajo) y haz clic en Generate link (2). Allow multi-store install for one Plus organization solo importa si tu tienda pertenece a una organización de Shopify Plus con varias tiendas.
Instala la app en tu tienda
La app no puede leer nada hasta que esté instalada en la tienda.
1. Abre la página Overview de la app en el Dev Dashboard y haz clic en Install app en la parte superior de la tarjeta Installs. En algunos paneles este botón dice Test app, como en la captura de abajo. También puedes abrir el menú ⋯ en la fila de la app en la lista Apps y elegir Install app.
2. Elige la tienda que quieres conectar.
3. Revisa el acceso que solicita la app y haz clic en Install.
La pantalla avisa de que “This app hasn’t been reviewed”. Es lo esperado: es tu propia app, no una de la App Store.
Copia el Client ID y el Client secret
Abre Settings de la app en el Dev Dashboard. En Credentials, copia el Client ID y el Client secret (usa los botones de copiar junto a cada campo). Trata el secret como una contraseña.

Las apps personalizadas importan los pedidos de los últimos 60 días

Shopify solo devuelve pedidos de más de 60 días a las apps que tienen el permiso read_all_orders, y el Dev Dashboard lo rechaza en una app personalizada (“Contains invalid scopes: read_all_orders”). Por eso una conexión con app personalizada importa los pedidos de los últimos 60 días, y los informes Eshop empiezan ahí. El presupuesto de importación puede seguir ofreciendo un historial más largo; la importación en sí se detiene en 60 días. Si necesitas el historial completo de pedidos, conéctate con la app de la App Store.

Conéctala en AmICited#

Encuentra la dirección de tu tienda
En la administración de Shopify, abre Settings. La dirección de la tienda (your-store.myshopify.com) aparece bajo el nombre de la tienda, en la parte superior del menú.
Abre el diálogo de Shopify
Ve a Fuentes de datos, en Eshops haz clic en Connect Shopify Store y después en Use a custom app instead (1 en la captura de abajo).
Introduce la tienda y las credenciales
Introduce la Store address, el Client ID y el Client secret (2), y haz clic en Connect store (3).
Elige el dominio y confirma la importación
Asigna la tienda a un dominio y elige cuánto historial de pedidos importar, igual que con una instalación desde la App Store. Cada opción muestra sus filas estimadas y su coste único antes de confirmar.

Después, configura los datos de clientes y los ajustes de la tienda igual que para cualquier tienda.

En qué se diferencia una app personalizada#

¿Por qué los enlaces no se vuelven a aplicar en cuanto edito un producto?

Las apps personalizadas no reciben webhooks de Shopify, así que editar un producto o una página en Shopify no hace que el link building vuelva a aplicar sus enlaces de inmediato. Se aplican de nuevo la próxima vez que se ejecuta la regla.

¿Qué pasa si la app se elimina o se desinstala?

La conexión se detiene en aproximadamente un día y el espacio de trabajo recibe una notificación. Para volver a conectar, abre el mismo diálogo, elige Update credentials e introduce el Client ID y el Client secret actuales de la app.

¿Por qué la importación solo se remonta a 60 días?

Los pedidos más antiguos requieren el permiso read_all_orders de Shopify, y el Dev Dashboard no lo acepta en una app personalizada. Por eso una conexión con app personalizada importa los pedidos de los últimos 60 días, y los pedidos nuevos siguen llegando a partir de entonces. Para el historial completo, usa la app de la App Store.

¿Puede una agencia usar una sola app para todos sus clientes?

No. La app debe pertenecer a la misma organización de Shopify que la tienda, así que cada cliente crea su propia app.

Relacionado#

Tiendas online La vía de la App Store, los datos de clientes, los ajustes de la tienda y lo que desbloquea la tienda. Planes y límites Qué planes incluyen las integraciones de ecommerce.