Integración con Shopify
Conecta tu tienda Shopify para sincronizar automáticamente productos, pedidos, clientes y carritos abandonados. Activa una segmentación de clientes eficaz y campañas de recuperación de carrito abandonado.
Funciones
- Sincronización automática - Productos, pedidos y clientes se sincronizan en tiempo real mediante webhooks
- Recuperación de carritos abandonados - Guarda las URL de checkout para campañas de recuperación
- Seguimiento de la tienda y del checkout - El píxel de Joryio sigue las visitas a páginas, productos y colecciones, las búsquedas, el carrito y cada paso del checkout, sin código en tu tema
- Mensajes en el sitio - El app embed de Joryio muestra los mensajes de Joryio en tu tienda
- Captura de email - Reconoce a los compradores desde el checkout, su cuenta en la tienda y los formularios de la tienda
- Atribución UTM - Captura y atribuye los parámetros UTM de marketing
- Varias tiendas - Conecta varias tiendas Shopify con eventos segmentados por tienda
Conectar tu tienda
Instalas Joryio desde Shopify y después vinculas la tienda a tu espacio de trabajo de Joryio desde la administración de Shopify. Necesitas una cuenta de Joryio: las cuentas las crea el equipo de Joryio (Reservar una demo).
- Instala Joryio desde Shopify: con el enlace de instalación que te dio Joryio o con Instalar Joryio desde Shopify en la página de Shopify de Joryio (Configuración → Integraciones → Shopify). Shopify muestra los permisos que pide Joryio - productos, pedidos, clientes, checkouts, descuentos (para los cupones), y customer events y pixels (
read_customer_events,write_pixels), con los que se añade el píxel de Joryio a tu tienda - y los apruebas en Shopify - Shopify abre Joryio dentro de la administración de Shopify. Una tienda que aún no está vinculada muestra Esta tienda aún no está vinculada a una cuenta de Joryio
- Haz clic en Ya tengo una cuenta - iniciar sesión. Joryio se abre en una pestaña nueva
- Inicia sesión en Joryio. Si Joryio pide Tu cuenta de Joryio, introduce el nombre de la cuenta que aparece en tu dirección de inicio de sesión (
.../a/your-account) - En Vincular una tienda de Shopify, elige el espacio de trabajo para esta tienda y haz clic en Vincular la tienda a este espacio de trabajo. Un espacio de trabajo en el que no puedes gestionar integraciones, o que ya tiene otra tienda de Shopify, aparece con el motivo pero no se puede elegir
- Vuelve a la pestaña de la administración de Shopify. En unos segundos pregunta ¿Vincular esta tienda a Joryio? y muestra los nombres del espacio de trabajo y de la cuenta. Compruébalos y haz clic en Vincular esta tienda
- La página muestra la conexión. Joryio importa tus productos, pedidos y clientes, se suscribe a las actualizaciones de Shopify y añade el píxel automáticamente
- Activa las ventanas emergentes: haz clic en Activar Joryio en tu tema y después pulsa Guardar en Shopify - consulta Activar las ventanas emergentes
Solo el miembro del personal de Shopify que empezó la vinculación puede terminarla, y no se conecta nada hasta que hace clic en Vincular esta tienda. Un enlace que no se usa en 15 minutos caduca: vuelve a empezar desde la página de Joryio en la administración de Shopify.
Joryio nunca te pide que escribas la dirección de tu tienda. Si abres la página de Shopify en Joryio antes de instalar Joryio en tu tienda, aparece Instalar Joryio desde Shopify - instala desde ahí y continúa en el paso 2. ¿Ya lo instalaste? Abre Joryio desde Apps en el panel de administración de Shopify y haz clic en Ya tengo una cuenta - iniciar sesión.
Dónde se guardan los datos de tu tienda
Los datos de tu tienda se guardan en la misma región de Joryio que tu cuenta, la región en la que se creó la cuenta. Nunca eliges una región al instalar: la decide el inicio de sesión, así que una tienda no puede acabar en una región distinta de la de su cuenta. No se guarda nada de la tienda en ningún sitio hasta que la vinculas.
Abrir Joryio desde Shopify
Abre Joryio desde Apps en la administración de Shopify cuando quieras. Dentro de la administración muestra:
- Conexión y Última sincronización - el mismo estado que la página de Shopify en Joryio
- Píxel de Joryio y Ventanas emergentes en tu tienda, con Activar Joryio en tu tema mientras las ventanas emergentes no estén activadas
- Abrir Joryio - la página de Shopify en Joryio, en una pestaña nueva
Una tienda desconectada muestra Volver a conectar - iniciar sesión, que sigue los mismos pasos de vinculación.
Tiendas conectadas antes de que Joryio se abriera dentro de Shopify
Una tienda conectada antes desde Joryio (introduciendo el dominio de la tienda) sigue conectada: los productos, los pedidos, las actualizaciones en tiempo real y el píxel siguen funcionando. La primera vez que alguien abre Joryio desde Apps en la administración de Shopify de la tienda, Joryio renueva en segundo plano su acceso a la tienda - Shopify exige este tipo de acceso a todas las aplicaciones a partir del 1 de enero de 2027. No cambia nada más y no hay nada que aprobar en Joryio. Abre Joryio desde Shopify una vez antes de esa fecha.
Ajustes de sincronización
Después de conectarla, configura qué datos se sincronizan:
| Ajuste | Descripción | Predeterminado |
|---|---|---|
| Sincronizar productos | Importa productos desde Shopify | Activado |
| Sincronizar pedidos | Importa pedidos y actualiza estados | Activado |
| Sincronizar clientes | Importa datos de clientes | Activado |
| Sincronizar carritos | Registra checkouts abandonados | Activado |
| Días históricos | Días de historial de pedidos que se importarán | 60 (90 cuando la tienda ha concedido acceso a todos los pedidos) |
Shopify solo devuelve los pedidos de los últimos 60 días, salvo que la tienda haya concedido a Joryio acceso a todos los pedidos. Hasta entonces, un periodo más largo se reduce a 60 días y la pestaña Configuración lo indica.
Accede a estos ajustes en Configuración → Integraciones → Shopify → pestaña Configuración.
Seguimiento de la tienda
Al conectar la tienda, Joryio le añade el píxel de Joryio: no hay nada que instalar. Shopify ejecuta el píxel en todas las páginas de la tienda y dentro del checkout, así que también se siguen los pasos del checkout. Lo verás en el admin de Shopify, en Settings → Customer events. Cada evento se guarda con su nombre estándar (columna Se guarda como), el mismo que usan las integraciones de WooCommerce y Magento y los SDK:
| Evento | Se guarda como | Cuándo se envía |
|---|---|---|
| Vista de página | Page Viewed | Cada visita a una página, incluidas las del checkout |
| Vista de producto | Product Viewed | Una página de producto, con la variante mostrada, su precio y el estado del stock: in_stock (true o false) y stock_status (in_stock o out_of_stock) |
| Vista de colección | Product List Viewed | Una página de colección, con category_id (el id de la colección) y category_name |
| Búsqueda | Products Searched | Una búsqueda en la tienda, con las palabras en query |
| Añadir al carrito | Product Added | Cada añadido al carrito, con la cantidad |
| Quitar del carrito | Product Removed | Un producto quitado del carrito |
| Vista del carrito | Cart Viewed | La página del carrito, con el total y los artículos |
| Inicio del checkout | Checkout Started | El comprador entra en el checkout, con el total y los artículos |
| Paso del checkout | Checkout Step Completed | El comprador completa un paso del checkout: step es contact, address o shipping |
| Datos de pago | Payment Info Entered | El comprador envía los datos de pago |
| Identificación | $identify | El email del comprador, desde el checkout, una cuenta con sesión iniciada en la tienda o un formulario de la tienda |
Los eventos de producto incluyen product_id, variant_id, quantity, price y currency. Los pedidos no son un evento del píxel: cada pedido llega una sola vez por los webhooks de pedidos de Shopify y se guarda como Order Completed, así que los ingresos nunca se cuentan dos veces.
Mensajes en el sitio y registros: el app embed
Algunas funciones necesitan ejecutarse en la propia página de la tienda, algo que el píxel no puede hacer. El app embed de Joryio carga el SDK web de Joryio en tu tienda para que:
- aparezcan en la tienda los mensajes de Joryio en el sitio (in-app)
- se reconozca al comprador que ha iniciado sesión en su cuenta de la tienda, y su navegación, su carrito y los mensajes en el sitio de antes de iniciar sesión se unan a su contacto. Joryio se basa solo en la confirmación de la propia Shopify de que el comprador ha iniciado sesión
- un email escrito en cualquier formulario de la tienda (newsletter, contacto, cuenta) identifique al comprador. Un email escrito nunca une al visitante con un contacto existente - cualquiera puede escribir la dirección de otra persona
En Shopify solo el propietario de la tienda puede activar un app embed - consulta Activar las ventanas emergentes. En los ajustes del embed puedes desactivar los mensajes en el sitio o la captura de email de formularios.
Activar las ventanas emergentes
Las ventanas emergentes de Joryio (mensajes in-app) aparecen en tu tienda solo cuando el app embed de Joryio está activado en tu tema. En Shopify solo el propietario de la tienda puede activarlo:
- En Integraciones → Shopify → Conexión, busca Ventanas emergentes en tu tienda
- Haz clic en Activar Joryio en tu tema. Shopify abre el editor de temas con Joryio ya activado en App embeds
- Pulsa Guardar
A mano: en Shopify, ve a Online Store → Themes → Customize → App embeds, activa Joryio y pulsa Guardar. Se hace una vez por cada tema que publiques.
La etiqueta junto a Ventanas emergentes en tu tienda muestra Activado cuando tu tienda ha cargado Joryio para algún visitante en los últimos 7 días, y Aún no activado hasta entonces, así que después de guardar puede hacer falta una visita a tu tienda. Mientras muestra Activado, el botón se sustituye por un pequeño enlace Abrir el editor de temas.
Ajustes de mensajes in-app
El embed carga el SDK desde https://sdk.joryio.com/web/1/joryio.min.js (la última versión 1.x, el mismo archivo que cargan el plugin de WooCommerce y la extensión de Magento); sus llamadas de datos van al servidor de Joryio de tu tienda. En el editor de temas, el embed de Joryio tiene estos ajustes:
| Ajuste | Por defecto | Qué hace |
|---|---|---|
| In-app messages | Activado | Muestra tus mensajes in-app de Joryio en la tienda |
| Allow HTML in-app messages | Activado | Muestra también los mensajes creados con el editor HTML. Se muestran en un marco protegido en tu tienda: los scripts que contengan no se ejecutan, y el mensaje no puede acceder a las páginas de tu tienda ni hacer sus propias peticiones de red |
Nada se cuenta dos veces: el SDK comparte con el píxel el id anónimo de visitante y no envía vistas de página ni inicios de sesión propios - los eventos de página y de carrito vienen del píxel.
El push web no está disponible en Shopify
Las notificaciones del navegador necesitan un service worker servido desde la propia dirección de la tienda, en su raíz (/joryio-sw.js). Shopify no deja que una app ponga un archivo ahí: los archivos del app embed se sirven desde el CDN de Shopify, que es otra dirección, y los app proxies solo responden bajo /apps/... (o /a, /community, /tools) y quitan la cabecera que permitiría a un worker cubrir toda la tienda. Por eso el embed no tiene un interruptor de push web. El push web funciona en tiendas WooCommerce y Magento.
Privacidad y consentimiento
El píxel y el app embed siguen el banner de cookies de tu tienda (ajustes de Customer Privacy de Shopify). Solo se ejecutan para visitantes que han permitido tanto analytics como marketing, y dejan de enviar cuando un visitante retira el consentimiento. En las regiones donde tu tienda no pide consentimiento, se ejecutan para todos los visitantes.
Shopify comparte el email del comprador con los píxeles de apps solo cuando la app está aprobada para datos protegidos de clientes. Hasta entonces, los emails del checkout llegan a Joryio por los webhooks de checkout y de pedidos, no por el píxel.
Tiendas conectadas antes de octubre de 2026
Estas tiendas se configuraron con un script de seguimiento que Shopify deja de cargar el 1 de marzo de 2027 y que nunca se ejecutó dentro del checkout. Sigue funcionando hasta que hagas el cambio:
- En Integraciones → Shopify → Conexión, haz clic en Aprobar nuevos permisos
- Aprueba en Shopify los nuevos permisos de customer events y pixels
- De vuelta en Joryio, el píxel se añade y el script antiguo deja de enviar eventos automáticamente, así nada se cuenta dos veces
- Haz clic en Activar Joryio en tu tema para activar el app embed
Si Shopify te pide aprobar permisos nuevos al abrir Joryio desde Apps en la administración de Shopify, apruébalos allí - Joryio añade entonces el píxel y desactiva el script antiguo.
El script antiguo sigue registrado en tu tienda hasta que Shopify lo quite: Shopify lo elimina cuando desinstalas la app y deja de cargarlo el 1 de marzo de 2027. Joryio no lo elimina - solo deja de enviar eventos desde él.
Atribución UTM
Los parámetros de marketing se capturan automáticamente:
utm_source,utm_medium,utm_campaignutm_term,utm_content
Los parámetros UTM se guardan durante la visita y se añaden a sus eventos.
Compatibilidad con varias tiendas
Al conectar varias tiendas Shopify al mismo espacio de trabajo:
- Cada tienda recibe su propia entidad de aplicación con una clave SDK única.
- Todos los eventos se etiquetan con el
$app_idde la tienda. - Filtra eventos por
$platform = 'shopify'o por un$app_idconcreto. - Las personas se pueden vincular entre tiendas mediante el email.
Reconocer a los visitantes por el email que escriben
Recognise visitors by the email they type se configura en Joryio, en Integraciones → Shopify → Configuración. Está activado por defecto.
- Activado (por defecto) - un email que el visitante escribe en el checkout o en un formulario identifica su navegador como el contacto con ese email: el contacto existente (el de actividad más reciente, cuando varios contactos comparten el email - consulta más abajo) o uno nuevo. La navegación anterior del visitante se une a ese contacto, y no se crea un segundo contacto con el mismo email. Es lo que esperan la mayoría de las tiendas. La contrapartida: quien escribe el email de otra persona es reconocido como esa persona en ese navegador - por ejemplo, podría ver los mensajes in-app y el contenido personalizado de esa persona.
- Desactivado (identidad estricta) - un email escrito nunca identifica el navegador. El email de un invitado llega a Joryio con el pedido, y el pedido va al contacto con ese email. Solo un cliente que ha iniciado sesión en la tienda es reconocido en el navegador.
Un cambio se aplica en pocos minutos.
Un email corregido. Cuando un visitante corrige un email mal escrito, la dirección errónea se quita de nuevo de su navegador y la corregida se busca como cualquier otra, así que el visitante pasa al contacto correcto. Shopify envía el carrito con cada actualización del checkout, así que el carrito ya sigue al email. Una dirección escrita solo se quita mientras nada más en ese contacto identifique a una persona: un pedido, un número de teléfono, una elección de consentimiento, una cuenta en la tienda o una dirección escrita hace más de un día la conservan.
Cuando varios contactos comparten un email
Un email puede pertenecer a más de un contacto en Joryio (por ejemplo una pareja, o una persona importada dos veces). Cuando el email que un visitante escribe en el checkout coincide con varios contactos, el carrito, el checkout y el pedido van al contacto con actividad más reciente - la misma regla que usan las importaciones, la API y los formularios, para que el historial de una persona no se divida entre dos contactos. Una vez que un checkout ha elegido un contacto, se queda con él: las siguientes actualizaciones del carrito, el consentimiento, el carrito abandonado, el pedido y sus cambios de estado van todos al mismo contacto, aunque el otro contacto cambie mientras tanto. Un cliente con sesión iniciada en la tienda siempre va al contacto que tiene su cuenta de cliente de la tienda. Los contactos nunca se fusionan, y una baja sigue aplicándose a todos los contactos con ese email.
Cómo los datos de la tienda actualizan un contacto
Los pedidos, los checkouts y las actualizaciones de clientes de tu tienda actualizan el contacto correspondiente en Joryio:
- Teléfono - pedidos y checkouts: el teléfono que un comprador escribe en el checkout nunca reemplaza el teléfono que ya tiene un contacto, aunque Shopify vincule el pedido a un cliente - Shopify asocia un checkout de invitado al cliente existente con el email escrito, así que el vínculo no prueba quién es el comprador. Solo lo rellena cuando el contacto no tiene teléfono.
- Teléfono - registro de cliente de Shopify: las actualizaciones de clientes de Shopify (y la importación de clientes) actualizan el teléfono del contacto.
- Los nombres vienen del registro de cliente de Shopify.
- Número de cliente de la tienda: el número de cliente de Shopify de un contacto viene del registro de cliente de Shopify (actualizaciones de clientes e importación de clientes), nunca de un pedido o checkout. Cuando el registro de cliente tiene otro email, el número pasa al contacto con ese email.
- El pedido conserva el teléfono escrito en el checkout en su dirección de facturación y envío, pase lo que pase con el contacto.
- El consentimiento de SMS dado en el checkout con un número distinto al del contacto no suscribe el número del contacto.
- Otras formas de cambiar el teléfono de un contacto: la cuenta del cliente en la tienda, el SDK o la API desde tu propio sitio o app (por ejemplo, después de que la persona inicie sesión), una importación, o editar el contacto en Joryio.
Webhooks
La integración registra automáticamente webhooks para actualizaciones en tiempo real:
- Pedido creado, actualizado, cancelado o completado.
- Checkout creado o actualizado (carritos abandonados).
- Producto creado, actualizado o eliminado.
- Cliente creado o actualizado.
Consulta los webhooks registrados en Configuración → Integraciones → Shopify → pestaña Webhooks.
Conciliación programada
Las actualizaciones en tiempo real (webhooks) pueden perderse - por ejemplo, mientras la tienda no está disponible o cuando un envío falla demasiadas veces. Cada 6 horas Joryio revisa la tienda en busca de lo que cambió desde la revisión anterior y completa lo que las actualizaciones en tiempo real no recibieron: pedidos (con sus reembolsos y cancelaciones), clientes, productos y checkouts abandonados de las últimas 24 horas.
Nada se cuenta dos veces: un elemento que Joryio ya tiene en la misma versión o en una más reciente no se modifica, y una copia más antigua nunca sobrescribe una más reciente.
- Un pedido que falta y se realizó en las últimas 24 horas se registra como si hubiera llegado en tiempo real, así que los journeys posteriores a la compra empiezan igualmente. Un pedido que falta más antiguo, y un reembolso o cancelación de un pedido que Joryio ya tenía, se registran sin iniciar journeys;
Order RefundedyOrder Cancelledse siguen registrando una sola vez cada uno. - Cada tienda se revisa a su propia hora, así que no se leen todas a la vez, y una revisión lee un número limitado de cambios; una tienda con más cambios continúa en menos de media hora.
- Las tiendas desconectadas, con error o aún sincronizando se omiten hasta que vuelvan a estar conectadas.
El resultado se muestra en Configuración → Integraciones → Shopify: Última conciliación: 22/10/2026 12:00 - elementos completados: 3. Si las revisiones siguen encontrando cambios que nunca llegaron en tiempo real, Joryio muestra la alerta Live updates from Shopify may be failing (campana, Registros y monitoreo y un correo a los administradores del workspace). Los datos que faltan se completan de todos modos, pero revisa la conexión de la tienda: los journeys que reaccionan a esos cambios empiezan tarde.
La misma página muestra Último evento recibido - cuándo llegó a Joryio la última actualización en vivo de la tienda (con un minuto de retraso como máximo) - y Última sincronización, la más reciente entre la última sincronización completa y la última conciliación. En una tienda que envía actualizaciones en vivo, Último evento recibido avanza aunque no se haya ejecutado ninguna sincronización.
Reembolsos y cancelaciones
Cada reembolso de Shopify se convierte en un evento Order Refunded (con el importe reembolsado, los artículos y la nota) y cada cancelación en un Order Cancelled, para que un journey pueda reaccionar. Consulta Eventos de reembolso y cancelación.
Solicitudes de privacidad de Shopify
Shopify reenvía las solicitudes de privacidad de sus clientes a todas las aplicaciones que usa la tienda. Joryio gestiona cada una en todos los espacios de trabajo conectados a la tienda y avisa a los propietarios, administradores y miembros que pueden gestionar la configuración del espacio de trabajo (por email y en la campana):
| Solicitud de Shopify | Qué hace Joryio | Qué haces tú |
|---|---|---|
| Un cliente pidió sus datos | Encuentra el contacto por su ID de cliente de Shopify o su email e inicia una exportación de datos en la página Solicitudes de interesados | Cuando la exportación esté lista, descárgala y envíasela al cliente a través de Shopify, en un plazo de 30 días. Si Joryio no tiene nada sobre el cliente, el aviso lo indica |
| Un cliente pidió que se suprimieran sus datos | Inicia una supresión del contacto (perfil, eventos, mensajes; los pedidos conservan los importes pero pierden el nombre, las direcciones, el ID de cliente de Shopify, la nota del pedido, el enlace de estado del pedido, el número de seguimiento y el vínculo con el contacto) y elimina los datos personales de los pedidos que indica Shopify | Nada |
| Datos de la tienda suprimidos (48 horas después de desinstalar la aplicación) | Quita la conexión de la tienda - consulta Desinstalar Joryio de Shopify | Nada. Si reinstalaste la aplicación dentro de esas 48 horas, Joryio deja la tienda conectada |
Desinstalar Joryio de Shopify
Cuando desinstalas la aplicación, Joryio deja de recibir datos de Shopify y quita la conexión. Tus contactos y tu historial de pedidos se quedan en tu espacio de trabajo de Joryio hasta que los elimines o un cliente pida que se borren sus datos; los productos se archivan.
En detalle, 48 horas después de la desinstalación (cuando Shopify pide a Joryio que quite los datos de la tienda):
- Se quita: la conexión de la tienda y su acceso, y los carritos y checkouts abandonados de la tienda.
- Se conserva: los contactos y los pedidos - siguen vinculados a sus contactos y marcados como procedentes de una tienda desconectada - para que el valor de vida del cliente, RFM, los segmentos y la atribución sigan funcionando, por ejemplo si te pasas a WooCommerce o Magento.
- Se archiva: los productos de la tienda. Los pedidos anteriores siguen mostrando lo que se compró; los productos archivados nunca se recomiendan, no se ofrecen en selecciones de productos ni se usan en mensajes de vuelta a stock o bajada de precio.
Volver a instalar: instala Joryio desde el enlace de instalación y ábrelo desde Apps. La página vuelve a ofrecer los pasos de vinculación - consulta Conectar tu tienda. Vincula la tienda al espacio de trabajo en el que estaba, para que sus contactos y su historial de pedidos sigan juntos.
Estado de la conexión
Una vez conectada Shopify, el panel de estado - en Integraciones → Shopify → Conexión - es lo primero que debes consultar si los datos de la tienda dejan de sincronizarse:
- Datos de la tienda: nombre, plan, moneda y dominio actuales obtenidos de Shopify. Verlos confirma que el token de acceso sigue funcionando.
- Estado de webhooks: en la pestaña Webhooks, cada tema necesario aparece como registrado o ausente. El botón Volver a registrar vuelve a crear los webhooks que falten para reanudar las actualizaciones en tiempo real.
- Seguimiento de la tienda: si el píxel de Joryio está activo, con Aprobar nuevos permisos o Volver a registrar el seguimiento cuando no lo está, y el botón Activar Joryio en tu tema para el app embed. Consulta Seguimiento de la tienda.
Si los datos difieren, vuelve a registrar los webhooks que falten en la pestaña Webhooks y ejecuta después Sincronizar todo manualmente para rellenarlos.
Consentimiento de marketing
Joryio lee el consentimiento de marketing que Shopify guarda en cada cliente - el consentimiento de email y SMS que tu tienda recoge en el checkout, en formularios y en el admin de Shopify - y lo aplica a la suscripción del contacto en Joryio:
| En Shopify | En Joryio |
|---|---|
| Subscribed (email o SMS) | El contacto queda suscrito a ese canal. Quien se dio de baja no se vuelve a suscribir - consulta la tabla de abajo; puede volver a suscribirse por sí mismo desde el centro de preferencias. |
| Unsubscribed | El contacto se da de baja de ese canal - salvo que Joryio haya registrado un cambio posterior para ese contacto (por ejemplo, se suscribió en un formulario de Joryio después de darse de baja en Shopify). |
| Not subscribed, pending (doble opt-in aún pendiente de confirmación) o sin consentimiento | Sin cambios. |
- Se aplica a la importación histórica, a cada actualización de cliente y pedido, y a las notificaciones específicas de cambio de consentimiento de Shopify.
- En un pedido cuyo cliente no trae consentimiento, cuenta la casilla de marketing del checkout: marcarla suscribe, dejarla sin marcar no cambia nada.
- Cada cambio queda registrado en el historial de suscripción del contacto con su origen (
shopify_customeroshopify_checkout), el nivel de opt-in de Shopify (simple o confirmado) y la hora en que Shopify registró el cambio. - Un cambio de consentimiento que llega con un pedido nuevo o actualizado también registra la dirección IP del comprador que Shopify guardó en el pedido (la IP del navegador), que solo ven los miembros del equipo que pueden ver datos personales. La importación histórica y las notificaciones de consentimiento de clientes de Shopify no traen dirección IP - Shopify no la proporciona.
- Una dirección de tu lista de supresión (un rebote, o una baja registrada en otro contacto) no se suscribe.
- Joryio no devuelve el consentimiento a Shopify: una baja en Joryio no cambia tu lista de clientes de Shopify.
Qué hace un alta o una baja en la tienda
| Qué envía la tienda | Qué hace Joryio |
|---|---|
| Una casilla de consentimiento marcada en un checkout de invitado | Suscribe a un contacto que aún no tiene suscripción en ese canal. Salvo que el ajuste de la tienda de abajo esté activado, nunca vuelve a suscribir a quien se dio de baja: en un checkout de invitado cualquiera puede escribir el email de cualquiera. |
| Cualquier otro consentimiento de Shopify, incluido el de un cliente que tiene cuenta en la tienda | Igual que una casilla de invitado: salvo que el ajuste de abajo esté activado, nunca vuelve a suscribir a quien se dio de baja. Shopify asocia un checkout de invitado al cliente existente con ese email y no indica a Joryio si el comprador había iniciado sesión, así que Joryio no puede distinguir al titular de la cuenta de alguien que escribió su email. (WooCommerce y Magento sí lo indican - consulta sus páginas.) |
| Un consentimiento en el checkout o en el registro del cliente, con Permitir que las suscripciones en el pago vuelvan a suscribir a quien se dio de baja activado (desactivado por defecto) | Vuelve a suscribir a un contacto que se dio de baja - también después de un checkout de invitado - cuando la hora del consentimiento en la tienda es posterior a su última baja. El riesgo: Shopify no indica a Joryio si el comprador había iniciado sesión, así que alguien que escriba el email de otra persona en el checkout podría volver a suscribirla; siempre puede volver a darse de baja con un clic. Los casos de abajo que nunca se deshacen siguen valiendo. |
| Una casilla sin marcar | Ningún cambio: nunca es una baja. |
| Una baja en la tienda | Da de baja, salvo que Joryio haya registrado un cambio posterior para ese contacto. |
| Lo que ningún consentimiento de la tienda deshace, con el ajuste activado o no | Una queja de spam, un rebote duro, un bloqueo de toda la organización, otro espacio de trabajo, una baja registrada en otro contacto con el mismo email o teléfono, y un STOP de SMS. |
- El ajuste está en Integraciones → Shopify → Configuración, uno por conexión de tienda, desactivado por defecto. Solo los administradores pueden cambiarlo, y cada cambio queda en el registro de auditoría.
- El consentimiento de la tienda suscribe al canal, no a una lista: una lista que exige doble opt-in sigue enviando su email de confirmación cuando la persona se une a ella.
Las notificaciones de cambio de consentimiento se registran en el siguiente Sync All o Re-register. Hasta entonces, el consentimiento sigue llegando con cada actualización de cliente y pedido.
Recuperación de carrito abandonado
Cuando un cliente abandona su carrito:
- Se captura la URL del checkout.
- Se guardan el valor y los artículos del carrito.
- Se vincula el email del cliente, si se ha capturado.
Usa estos datos para crear campañas de recuperación de carrito abandonado en el canvas con la URL real del checkout.
Solución de problemas
Los productos o pedidos no se sincronizan
- Comprueba que la sincronización esté activada en la pestaña Configuración
- Verifica que los webhooks estén registrados en la pestaña Webhooks
- Prueba una sincronización manual con el botón "Sincronizar todo"
"Shopify has not approved this app's access to protected customer data"
- Shopify solo entrega datos de clientes (los clientes y los datos del cliente en los pedidos) a apps aprobadas para datos protegidos de clientes. Hasta entonces Shopify rechaza esas lecturas, y el Last Error de la página de la integración nombra el objeto rechazado
- La aprobación la solicita el desarrollador de la app en el Shopify Dev Dashboard (o el Partner Dashboard): la app -> API access -> Protected customer data. Cuando se apruebe, haz clic en Sync All
- Una entidad rechazada no detiene las demás: productos, pedidos y checkouts abandonados se siguen sincronizando, y los webhooks (pedidos y carritos en tiempo real) se registran antes de que empiece la sincronización. El estado sigue en Error hasta que una sincronización termine sin errores, y Last Sync muestra la última que terminó así
- La página de Joryio dentro de tu administración de Shopify muestra el mismo estado con un motivo breve
El píxel no está activo
- Aparece Aprobar nuevos permisos: la tienda aún no ha aprobado los permisos del píxel; consulta Tiendas conectadas antes de octubre de 2026
- Aparece un error: haz clic en Volver a registrar el seguimiento. Si persiste, el mensaje de Shopify indica el motivo
- Comprueba en el admin de Shopify, en Settings → Customer events, que el píxel de Joryio aparece como conectado
No se captura el email
- Los emails del checkout llegan por los webhooks de checkout y de pedidos
- Los formularios de la tienda y las cuentas con sesión iniciada necesitan el app embed activado; consulta el app embed
- Un visitante que no ha permitido analytics y marketing no se sigue
Problemas de conexión
- Verifica que tu app de Shopify tenga los permisos necesarios
- Abre Joryio desde Apps en el panel de administración de Shopify. Una tienda desconectada muestra Volver a conectar - iniciar sesión, que la vincula de nuevo - consulta Abrir Joryio desde Shopify
Faltan vistas de producto o añadidos al carrito
- El píxel se ejecuta en los temas de Online Store y en el checkout de Shopify. Una tienda headless (Hydrogen u otro front end personalizado) puede no ejecutar píxeles de apps: envía los eventos con el Web SDK
- Los visitantes que rechazaron las cookies de analytics o marketing no se siguen
- Las vistas de producto leen el estado del stock de la dirección
/products/<handle>.jsde tu tienda. Si un tema o una app bloquea esa dirección, las vistas de producto llegan sin el estado del stock