Configurar Shopify

Descripción general de la integración

Pushwoosh se integra a la perfección con Shopify, una plataforma líder de comercio electrónico que permite a las empresas crear, gestionar y escalar tiendas en línea. Esta guía le explica cómo instalar y configurar la app de Pushwoosh en su tienda Shopify, configurar la identificación de usuarios y usar notificaciones y herramientas de automatización para interactuar con los clientes a través de canales como push, email, SMS y WhatsApp.

Tipo de integración

• Destino: Shopify envía datos de clientes a Pushwoosh, donde se usan para segmentación y mensajería.

Requisitos previos

• Una cuenta de Pushwoosh
• Acceso a su panel de administración de Shopify
• Token de API de dispositivo de Pushwoosh y Application Code
• Una tienda Shopify con datos de clientes y pedidos disponibles
• Aprobación del alcance de acceso read_orders para eventos de pedidos/carrito, y write_pixels más read_customer_events para el seguimiento de los pasos del checkout

¿Ya está conectado? Se le pedirá que vuelva a aprobar el acceso

Si conectó la app de Pushwoosh antes de que existiera el seguimiento de pedidos, carritos y checkout, Shopify le pedirá que apruebe los nuevos alcances la próxima vez que abra la app — así es como Shopify introduce permisos adicionales, no es un error. Apruébelos para empezar a recibir eventos de pedidos, carritos y checkout.

Entidades sincronizadas

• Clientes: se usan para asignar e identificar los User ID de Pushwoosh mediante metacampos de Shopify

Nota

Enfoques de sincronización de clientes en Pushwoosh

Debido a limitaciones técnicas, Pushwoosh ofrece varios métodos de sincronización de clientes, según el canal de comunicación usado para las notificaciones:

• Email, Web, SMS y WhatsApp: los dispositivos/usuarios se registran automáticamente en la app de Pushwoosh.
• Apps móviles y de escritorio: los dispositivos/usuarios se pueden sincronizar manualmente a través de los paneles de administración de Pushwoosh y Shopify.
• Plataformas web (Chrome, Firefox, Safari): los dispositivos/usuarios son gestionados por el propio embed del tema de Shopify.

¿Cómo funciona?

El proceso de sincronización funciona de la siguiente manera:

1. El sistema intenta recuperar la sesión actual del usuario para obtener un email o número de teléfono (identificadores que funcionan sin configuración adicional).
2. Si tiene éxito, el email o número de teléfono se establece como el identificador userID tanto para Pushwoosh como para la propiedad pushwoosh_userid en los datos del cliente.
3. Si esto no es posible, se asigna el userID predeterminado del SDK de Pushwoosh como identificador tanto para Pushwoosh como para la propiedad pushwoosh_userid.
4. En cualquier caso, se asignará un userID en ambos lados, lo que garantiza una sincronización consistente.

• Segmentos de clientes: se usan para segmentación y mensajería basada en grupos
• Eventos y disparadores (por ejemplo, pedidos realizados, etiquetas aplicadas): se usan en Shopify Flow para automatizar la mensajería en distintos canales
• Storefront: se usa para capturar suscripciones a web push mediante scripts incrustados
• Feed de productos: el feed del storefront de su tienda (products.json) se conecta automáticamente al Catálogo de productos de Pushwoosh al conectar la app, y se desconecta automáticamente si la desinstala.
• Pedidos y carritos: eventos servidor a servidor de los webhooks orders/paid, checkouts/create y checkouts/update de Shopify. Consulte Eventos y campañas de Shopify.
• Comportamiento de navegación en el storefront: vistas de productos y acciones de añadir al carrito, recopiladas por el mismo embed del tema usado para las suscripciones a web push.
• Pasos del checkout: información de contacto introducida y datos de pago enviados, recopilados mediante un Shopify Web Pixel.

Glosario (equivalencia de nombres de entidades cuando difieren)

Shopify	Pushwoosh
Customer	User ID
Webhook orders/paid	Evento PW_OrderCreated — compartido con otras integraciones de comercio electrónico (por ejemplo, Magento)
Webhook checkouts/create	Evento PW_AbandonedCart — el mismo evento compartido, también usado por la fuente Cart del bloque Products
Webhook checkouts/update	Evento PW_AbandonedCartUpdate — se dispara mientras el comprador sigue editando el mismo checkout, sobrescribiendo el carrito almacenado desde PW_AbandonedCart
Vista de página de producto	Evento PW_ProductViewed
Añadir al carrito (sin recargar la página)	Evento PW_AddToCart
Web Pixel checkout_contact_info_submitted	Evento PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Evento PW_PaymentInfoSubmitted

Cómo funciona la integración

Pushwoosh actúa como destino de mensajería para Shopify. Una vez integrado, Shopify envía datos de clientes y de comportamiento a Pushwoosh, donde impulsan notificaciones en tiempo real, segmentación de clientes y mensajería personalizada en distintos canales.

Componentes clave de la integración

1. Identificación de clientes mediante metacampos A cada cliente de Shopify se le asigna un User ID único, almacenado en un metacampo (custom.pushwoosh_userid). Este ID permite a Pushwoosh reconocer y enviar mensajes a los usuarios de forma coherente en todas las plataformas.

2. Automatización basada en eventos mediante Shopify Flow Pushwoosh proporciona acciones de Flow que le permiten automatizar la mensajería (push, email, SMS, WhatsApp) según eventos de Shopify, como:

   • Nuevo pedido realizado
   • Etiqueta aplicada al cliente
   • Abandono de carrito

3. Segmentación basada en segmentos Los segmentos de clientes de Shopify se pueden usar para enviar notificaciones específicas por grupo en distintos canales, como promociones para compradores primerizos o campañas de reactivación para usuarios inactivos.

4. Mensajería manual en tiempo real Desde la vista de cliente o segmento de Shopify, puede activar notificaciones manualmente usando las extensiones de Pushwoosh:

   • Notification by Customer: para seguimientos personales o pruebas
   • Notification by Segment: para mensajes basados en campañas

Notificaciones web push mediante el embed del storefront

Al activar el embed de Pushwoosh en su tema de Shopify, puede invitar a los visitantes del sitio web a suscribirse a las notificaciones push del navegador, sin necesidad de una app móvil.

Descripción general del flujo de datos

Datos de clientes y eventos de Shopify
         ↓
API de Pushwoosh (a través de la app)
         ↓
User ID → Segmentación → Notificaciones activadas o manuales

Esta integración le permite enviar mensajes oportunos y relevantes que mejoran la retención de usuarios, aumentan las conversiones y mejoran la experiencia del cliente, de forma automática o bajo demanda.

Parte 1. Instalación

Inicie sesión en Shopify

1. Vaya a Shopify Admin
2. Seleccione su tienda en el panel

Nota

Esta guía asume que ya tiene una cuenta de Pushwoosh. Si no, cree una

Instale la app de Pushwoosh

1. Visite la página de Pushwoosh en la App Store de Shopify
2. Haga clic en Install
3. Confirme la instalación en el diálogo de Shopify

Conecte su app de Pushwoosh

Después de la instalación, será redirigido a la app de Pushwoosh dentro de Shopify.

1. Haga clic en Connect.

2. Introduzca el Application Code y la API Key, que puede encontrar en Pushwoosh Control Panel → Settings → API Access. La API Key aquí es su Token de API de dispositivo.

Al conectarse, aparecerá un mensaje de éxito: «Pushwoosh app connected.»

Cuando Shopify solicite permisos (pedidos, pixels, eventos de clientes), apruébelos. Esos alcances son necesarios para el seguimiento de Eventos y campañas de Shopify. Si conectó la app anteriormente, consulte ¿Ya está conectado? Se le pedirá que vuelva a aprobar el acceso.

Conexión automática del catálogo de productos

Conectar la app también conecta automáticamente el feed del storefront de su tienda al Catálogo de productos de Pushwoosh. No se necesita una configuración de feed independiente. La moneda de su tienda se captura al mismo tiempo, y se actualiza automáticamente si cambia la moneda de su tienda más adelante.

Suscríbase a un plan

1. Haga clic en Upgrade Subscription
2. Se mostrará un único plan basado en uso.
3. Confirme la facturación.

Nota

Se requiere facturación para usar las funciones de entrega de mensajes y segmentación.

Parte 2. Configuración: User ID del cliente mediante metacampos

Para entregar notificaciones a usuarios identificados a través de distintos canales (push, email, SMS, WhatsApp), Pushwoosh usa un User ID único por cliente. Shopify almacena este valor dentro de los metacampos de cliente de Shopify.

1. Vaya a Settings → Metafields and metaobjects → Customers

2. Haga clic en Add definition y use estos valores:

Campo	Valor
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

Configure Customer accounts access y Storefront API access como en la tabla anterior.

Por qué es importante

Este metacampo es un identificador de usuario persistente en dispositivos móviles/web para notificaciones y segmentación.

Parte 3. Uso de las extensiones de Pushwoosh

Pushwoosh incluye extensiones de Shopify para segmentación por segmentos, automatización (Flow) y notificaciones específicas por cliente.

Extensión 1. Send notification by customer

Caso de uso

Enviar manualmente mensajes personalizados o notificaciones de prueba a un usuario específico.

Pasos

1. Abra Customers → Seleccione un cliente
2. Haga clic en More actions → Notification by customer
   
3. Seleccione la plataforma de mensajería (por ejemplo, Email) y un preset de contenido.
4. Haga clic en Send

Consejo

Use esto para recordatorios posteriores a la compra, agradecimientos personales o mensajes de reactivación.

Extensión 2. Notification by segment

Caso de uso

Segmentar grupos de clientes: carritos abandonados, compradores primerizos, grandes compradores.

Pasos

1. Vaya a Customers → Segments

2. Elija un segmento → Haga clic en Use Segment

3. Seleccione Notification by Segment
4. Seleccione el canal de comunicación deseado y el preset de mensaje. Haga clic en Send.

Consejo

Los segmentos se pueden crear en función del historial de compras, la ubicación, la actividad o las etiquetas.

Extensión 3. Pushwoosh en Shopify Flow

Caso de uso

Automatizar la mensajería en los recorridos de cliente usando disparadores como pedidos, etiquetas o comportamiento.

Pasos

1. Cree un nuevo Flow en Shopify Flow
2. Añada una acción → Elija Pushwoosh send notification

3. Configure el mensaje y los campos dinámicos

Por ejemplo:

• Enviar un mensaje tras realizar un pedido

• Recordar al usuario cuando abandona el carrito

• Enviar un push de reactivación tras 30 días de inactividad

Parte 4. Active web push (y eventos de navegación en el storefront)

Opcional solo para web push. Obligatorio si necesita eventos de vista de producto y añadir al carrito en Eventos y campañas de Shopify.

Active el embed del tema para web push del navegador en su storefront:

1. Vaya a Online Store → Themes → Customize
   
2. Abra App Embeds en el menú izquierdo
3. Active Push Init Embed

Nota

Ahora su tienda puede invitar a los usuarios a suscribirse a web push directamente desde el storefront. Si omite este interruptor, tampoco obtendrá eventos de navegación en el storefront en Eventos y campañas de Shopify. Los eventos de pedido pagado y checkout seguirán llegando sin él.

Cumplimiento de datos

Shopify exige que toda app pública responda a sus webhooks obligatorios de GDPR/CCPA. Pushwoosh los gestiona de la siguiente manera:

• customers/redact: cuando un comprador pide a la tienda que borre sus datos, Pushwoosh borra los registros de Pushwoosh correspondientes según los identificadores que envíe Shopify: email, teléfono e ID de cliente de Shopify.
• customers/data_request: cuando un comprador solicita una copia de sus datos, Pushwoosh publica una notificación en el canal interno de soporte, y una persona gestiona la solicitud manualmente. Shopify exige que las apps respondan a estas solicitudes en un plazo de 30 días.
• shop/redact: Shopify envía esto 48 horas después de que una tienda desinstala la app, solicitando el borrado de los datos de la tienda. Pushwoosh vuelve a ejecutar la misma eliminación que activa la propia desinstalación, limpiando cualquier sesión restante y borrando el registro de integración de la tienda (incluyendo la clave de API de dispositivo, el código de aplicación y los ID de facturación). Esto existe como red de seguridad para el caso de que la desinstalación no se haya limpiado por completo la primera vez.

Resumen de casos de uso

Después de la configuración, formas comunes de enviar mensajes desde Shopify:

Escenario	Herramienta usada
Seguimiento personalizado	Notification by Customer
Promoción basada en segmento	Notification by Segment
Mensaje de bienvenida tras el registro	Flow + seguimiento de metacampo
Recordatorio de carrito abandonado	Shopify Flow + acción de Pushwoosh
Suscripción a push	Embed del tema + interruptor Push Init

Para journeys y segmentos sobre eventos de pedido, carrito, checkout y storefront, consulte Eventos y campañas de Shopify.