Menú de la documentación

Shopify

Conecta una tienda Shopify para sincronizar sus clientes en una lista de contactos de MailInApp, disparar recorridos a partir de eventos reales de la tienda, y ver cómo los ingresos se atribuyen a una campaña o variante.

Vídeo en inglés

Conecta tu tienda

Conectas una tienda creando una pequeña app para ella en tu propio administrador de Shopify y pegando las dos claves de esa app en MailInApp. Lleva unos cinco minutos. No necesitas una cuenta de Shopify Partner ni código, y la app sigue siendo privada para tu tienda.

Debes ser el propietario de la tienda en Shopify (o un miembro del personal con permiso para desarrollar apps) y el propietario de tu cuenta de MailInApp.

Paso 1: abre el Dev Dashboard

En tu administrador de Shopify, ve a Configuración → Aplicaciones y haz clic en Develop apps, arriba a la derecha.

La página Configuración → Aplicaciones del administrador de Shopify, con el botón Develop apps resaltado

En la página de desarrollo de apps, haz clic en Build apps in Dev Dashboard. La primera vez, Shopify te pide que confirmes tu correo y vuelvas a iniciar sesión, y luego crea una organización de desarrollo con el nombre de tu tienda. Si la página Stores del Dev Dashboard dice "No stores yet", no pasa nada: tu tienda no necesita aparecer ahí.

La página de desarrollo de apps, con el botón Build apps in Dev Dashboard resaltado

Paso 2: crea la app

En el Dev Dashboard, abre Apps y haz clic en Create app y luego en Create app manually. Todo está en un solo formulario:

  • App name: cualquier nombre que reconozcas, por ejemplo MailInApp.
  • App URL: https://mailinapp.com/dashboard/settings/integrations. Shopify abre esta página después de instalar la app, así llegas al formulario de conexión de MailInApp con la dirección de tu tienda ya rellenada.
  • Embed app in Shopify admin: desmárcala. Tu app no tiene ninguna página dentro de Shopify.
  • Scopes: read_customers,read_orders,read_products,write_discounts. Permiten que MailInApp lea tus clientes, pedidos y productos, y cree los códigos de descuento de un solo uso descritos más abajo. MailInApp nunca cambia tus productos, pedidos ni clientes. Para llegar a pedidos de hace más de unos 60 días, añade también read_all_orders: Shopify lo concede automáticamente a tu propia app.
  • Webhooks API version: deja el valor predeterminado.

El formulario Create an app, con la App URL, la casilla Embed app in Shopify admin desmarcada, los scopes y el botón Create app resaltados

Haz clic en Create app. Shopify te pide publicar la primera versión: haz clic en Release.

El diálogo Release version, con el botón Release resaltado

Paso 3: instala la app en tu tienda

En la página Overview de la app, haz clic en Test app en la tarjeta Installs y elige tu tienda.

La página Overview de la app, con el botón Test app resaltado

Shopify muestra su pantalla de instalación con los accesos que necesita la app. También dice que la app no ha sido revisada. Es lo esperado, porque la app es tuya y nunca pasa por la App Store. Haz clic en Install.

La pantalla Install app de Shopify, con el botón Install resaltado

Tu tienda ahora muestra la app en Configuración → Aplicaciones.

Paso 4: pega las claves en MailInApp

De vuelta en la página Overview de la app en el Dev Dashboard, la tarjeta Credentials tiene el Client ID y el Client secret. El secreto está oculto; su botón de copiar lo copia.

La tarjeta Credentials de la página Overview de la app, con los campos Client ID y Client secret

En MailInApp, abre Configuración → Integraciones. En la tarjeta de Shopify, escribe la dirección de tu tienda (tu-tienda.myshopify.com), pega el Client ID y el Client secret, y haz clic en Conectar Shopify. Puede que MailInApp te pida volver a iniciar sesión primero, ya que las claves dan acceso completo a los datos de tu tienda.

La tarjeta de Shopify en Configuración → Integraciones, con la dirección de la tienda rellenada y el botón Conectar Shopify resaltado

MailInApp comprueba las claves con Shopify, cifra el Client secret y no lo vuelve a mostrar. Después crea una lista de contactos para la tienda y, en segundo plano, sincroniza tus clientes (hasta 5,000 en esta primera pasada; los posteriores llegan a medida que se crean) y tu catálogo de productos.

Deja desactivada la IP allowlist en la configuración de tu app. Si está activada, Shopify rechaza las solicitudes de MailInApp.

Conectar Shopify es gratis en todos los planes, incluido Free. Tu plan de MailInApp lo factura MailInApp como siempre, desde Configuración → Plan. Todo tu catálogo de productos se sincroniza en todos los planes, y cada plan incluye un cupo mensual de códigos de descuento de la tienda.

Si la conexión falla

La tarjeta de Shopify dice qué salió mal:

  • Shopify no aceptó ese Client ID y Client secret: vuelve a copiar ambos desde la tarjeta Credentials. Si generaste un secreto nuevo, usa el nuevo.
  • La app no está instalada en esta tienda: repite el paso 3 (Test app y luego Install).
  • A tu app le faltan estos scopes de acceso: en el Dev Dashboard, abre las Versions de la app, crea una versión nueva con los scopes del paso 2, publícala y vuelve a conectar.
  • Esta app pertenece a otra organización de Shopify: crea la app desde el administrador de tu propia tienda, como en el paso 1, y no desde otra cuenta de Partner o de desarrollador.
  • Esa no es una dirección de tienda de Shopify: usa la dirección myshopify.com que aparece bajo el nombre de tu tienda en Configuración, no tu propio dominio.

Qué hace

  • Sincronización de clientes: los clientes de Shopify llegan a una lista de contactos ligada a esta integración, mantenida al día después mediante los propios webhooks de Shopify (customers/create, además de checkouts/create y orders/paid para los disparadores de abajo) en lugar de un sondeo periódico.
  • Disparadores de recorrido: una tienda conectada puede disparar el disparador carrito abandonado de un recorrido (un checkout iniciado pero no completado) y su disparador compra (un pedido pagado), así una automatización de serie de bienvenida o carrito abandonado puede ejecutarse a partir de actividad real de Shopify en lugar de solo el pago del bloque de producto propio de MailInApp. Mira Recorridos.
  • Atribución de ingresos: la campaña/variante propia de un pedido, cuando es identificable, se suma a los mismos números de ingresos de respuesta y de prueba A/B que ya produce un pedido de checkout nativo.
  • Segmentos de historial de compras y ofertas de descuento: los artículos de línea de los pedidos se sincronizan junto con los clientes, así un filtro de audiencia puede coincidir con "compró el producto X entre la fecha A y B" (mira Historial de compras), y un proyecto puede generar un código de descuento de Shopify de un solo uso por destinatario coincidente, canjeado en el checkout de tu propia tienda (mira Oferta de descuento). Los pedidos nuevos se sincronizan automáticamente desde el webhook orders/paid. Para los pedidos anteriores a la conexión, ejecuta una vez Cargar historial de pedidos desde Configuración → Integraciones; Shopify lo limita a aproximadamente los últimos 60 días. Un bloque de Producto importado de tu catálogo puede generar independientemente su propio Descuento por producto, restringido solo a ese artículo y sin necesidad de filtro de audiencia: mira Descuentos nativos de tienda y Códigos de descuento de producto de Shopify.
  • Catálogo de productos para el estudio: los propios listados activos de tu tienda también se sincronizan en MailInApp, actualizados automáticamente con la misma frecuencia que los clientes (sin botón separado). El selector Importar desde la tienda del bloque de Producto busca en este catálogo sincronizado y completa el nombre, descripción, imagen y precio de un bloque a partir de un producto real. Es una copia de una sola vez, no un enlace en vivo, así nada de un correo enviado puede desviarse de lo que revisaste. También sincroniza la página propia de cada producto (a partir de su handle de Shopify) y, cuando está disponible, configura el bloque a Enlazar al checkout externo de la tienda apuntando directamente a ella, así un producto importado está listo para venderse en tu tienda Shopify sin nada más que configurar. Vuelve a cambiarlo a Checkout de MailInApp manualmente si prefieres cobrar a través de tu cuenta de Stripe conectada.

Reseñas de la tienda

Shopify no guarda reseñas propias, así que MailInApp las lee de Judge.me, la app de reseñas de tu tienda:

  1. En Judge.me, abre Settings → Integrations y haz clic en View API token. Copia el token privado.
  2. En MailInApp, abre Configuración → Integraciones. En la tarjeta de tu tienda, bajo Judge.me, pega el token y haz clic en Conectar Judge.me.

MailInApp comprueba el token con Judge.me y luego sincroniza tus reseñas, y de nuevo en cada sincronización de la tienda. Solo guarda las reseñas publicadas en tu tienda (ni ocultas ni pendientes de aprobación en Judge.me), como máximo las 5.000 más recientes. Una reseña que ocultes o borres en Judge.me desaparece tras la siguiente sincronización. MailInApp nunca guarda la dirección de correo de quien escribe la reseña y muestra el nombre como nombre de pila e inicial del apellido. La tarjeta muestra cuántas reseñas hay sincronizadas, y Sincronizar reseñas ahora las sincroniza al momento.

El token solo se usa para leer reseñas. Desconectar Judge.me borra el token y las reseñas sincronizadas, igual que desconectar la tienda. Las estrellas de los productos importados no necesitan el token: vienen de la valoración que Judge.me ya guarda en cada producto de Shopify. Consulta Reseñas de la tienda para las estrellas, las reseñas en los correos y la publicación.

Estado de la conexión y actualización de claves

MailInApp cambia las claves de tu app por un token de acceso de Shopify de corta duración (dura aproximadamente un día) y obtiene uno nuevo por su cuenta antes de que caduque. En el uso normal no tienes que hacer nada.

Si las claves dejan de funcionar, MailInApp detiene la sincronización, y la tarjeta de Shopify en Configuración → Integraciones muestra Requiere atención y dice por qué:

  • Las claves de tu app de Shopify dejaron de funcionar: el secreto se revocó o la app se eliminó. Haz clic en Actualizar claves y pega el Client ID y el Client secret actuales de la app.
  • Tu app de Shopify ya no está instalada en la tienda: la app se desinstaló de tu tienda. Vuelve a instalarla desde su página Overview (Test app). Las claves siguen siendo las mismas, así que MailInApp se vuelve a conectar por su cuenta en un plazo de 6 horas y configura sus webhooks de nuevo. Para volver a conectarla al instante, haz clic en Actualizar claves y pégalas.

Para cambiar el Client secret (por ejemplo, como hábito de seguridad), hazlo por pasos para que la tienda nunca se desconecte:

  1. En el Dev Dashboard, abre Settings en la app y haz clic en Generate new secret. Los dos secretos funcionan hasta que revoques el anterior.
  2. En MailInApp, haz clic en Actualizar claves en la tarjeta de Shopify y pega el secreto nuevo.
  3. De vuelta en el Dev Dashboard, revoca el secreto anterior.

Shopify sigue firmando sus webhooks con el secreto anterior hasta que lo revoques, y mientras tanto MailInApp acepta cualquiera de los dos, el tiempo que haga falta. Actualizar claves también pasa una tienda a otra de tus apps: pega el Client ID y el secreto de esa app.

Desconexión

Desconectar en Configuración → Integraciones detiene la sincronización y cualquier procesamiento adicional de webhooks de inmediato. MailInApp quita sus webhooks de tu app y elimina las claves guardadas. Después puedes desinstalar la app de tu tienda o eliminarla en el Dev Dashboard.

Desinstalar la app sin desconectar antes solo pausa la tienda: la tarjeta indica que la app no está instalada, y al reinstalarla todo sigue donde se quedó. Si la app sigue desinstalada durante 30 días, MailInApp elimina las claves guardadas y desconecta la tienda. Para volver a conectar una tienda desconectada, rellena el formulario de la tarjeta de Shopify. Empieza con la dirección de la tienda, y la tienda conserva su lista de contactos.

Los códigos de descuento que MailInApp ya creó en tu tienda (empiezan por MIA-) se quedan en Shopify cuando desinstalas la app o la desconectas, y siguen funcionando hasta que caducan, así que los códigos de los emails ya enviados siguen valiendo. La pantalla de desinstalación de Shopify dice que se eliminarán los descuentos de la app; se refiere a los descuentos que ejecuta la propia app, y MailInApp no crea ese tipo. Para anular los códigos antes, elimínalos en el admin de Shopify, en Discounts.

Los clientes ya sincronizados permanecen en su lista de contactos: desconectar una integración nunca elimina contactos, ya que pueden ser ya una audiencia de envío para otros proyectos. Elimina la lista tú mismo si ya no la necesitas.

MailInApp guarda los clientes de tu tienda en tu nombre. Tu propia app no le pasa a MailInApp las solicitudes de eliminación de datos de clientes de Shopify, así que cuando un cliente te pida eliminar sus datos, bórralo también en MailInApp, desde su perfil de contacto (mira Exportar o borrar los datos de un Destinatario). Lo mismo pasa con una desinstalación: la pantalla de desinstalación de Shopify dice que se le pedirá al desarrollador de la app que elimine los datos de clientes en un plazo de 48 horas. En tu propia app, ese desarrollador eres tú, y Shopify no le pasa esa solicitud a MailInApp, así que elimina tú mismo la lista de contactos de la tienda si quieres que desaparezca.