# Integración con Shopify
## Descripción general de la integración
Pushwoosh se integra perfectamente con Shopify, una plataforma de comercio electrónico líder que permite a las empresas crear, gestionar y escalar tiendas en línea. Esta guía le guiará a través de la instalación y configuración de la aplicación Pushwoosh en su tienda Shopify, la configuración de la identificación de usuario y el uso de notificaciones y herramientas de automatización para atraer a los clientes a través del móvil y la web.
### Tipo de integración
- **Destino**: Shopify envía datos de clientes a Pushwoosh, donde se utilizan para la segmentación y la mensajería.
### Requisitos previos
* Una [cuenta de Pushwoosh](https://www.pushwoosh.com/)
* Acceso a su panel de administración de Shopify
* El [Token de Acceso a la API de Dispositivos](/es/developer/api-reference/api-access-token/#device-api-token) de Pushwoosh y el **Código de Aplicación**
* Una tienda Shopify con clientes y datos de pedidos disponibles
### Entidades sincronizadas
* **Clientes**: Se utilizan para asignar e identificar los UserIDs de Pushwoosh a través de los metacampos de Shopify
* **Segmentos de clientes**: Se utilizan para la segmentación y la mensajería basada en grupos
* **Eventos y disparadores** (por ejemplo, pedidos realizados, etiquetas aplicadas): Se utilizan en Shopify Flow para automatizar la mensajería push
* **Escaparate**: Se utiliza para capturar las suscripciones a notificaciones push web a través de scripts incrustados
### Glosario (mapeo de nombres de entidades si son diferentes)
| **Shopify** | **Pushwoosh** |
| -------------------------- | --------------------------------------------------------- |
| Cliente | UserID |
## Cómo funciona la integración
Pushwoosh actúa como un destino de mensajería para Shopify. Una vez integrado, Shopify envía datos de clientes y de comportamiento a Pushwoosh, donde impulsa notificaciones en tiempo real, segmentación de clientes y mensajería personalizada a través de la web y el móvil.
### Componentes clave de la integración
1. **Identificación del cliente a través de metacampos**
A cada cliente de Shopify se le asigna un `UserID` único, almacenado en un metacampo (`custom.pushwoosh_userid`). Este ID permite a Pushwoosh reconocer y enviar mensajes a los usuarios de forma consistente en todas las plataformas.
2. **Automatización basada en eventos a través de Shopify Flow**
Pushwoosh proporciona acciones de Flow que le permiten automatizar las notificaciones push basadas en eventos de Shopify, tales como:
* Nuevo pedido realizado
* Etiqueta aplicada a un cliente
* Abandono de carrito
3. **Segmentación basada en segmentos**
Los segmentos de clientes de Shopify se pueden utilizar para enviar notificaciones push específicas para grupos, como promociones para compradores primerizos o campañas de reactivación para usuarios inactivos.
4. **Mensajería manual y en tiempo real**
Desde la vista de cliente o segmento de Shopify, puede activar manualmente las notificaciones utilizando las Extensiones de Pushwoosh:
* **Notificación por Cliente**: Para seguimientos personales o pruebas
* **Notificación por Segmento**: Para mensajes basados en campañas
### Notificaciones push web a través de la inserción en el escaparate
Al habilitar la inserción de Pushwoosh en su tema de Shopify, puede solicitar a los visitantes del sitio web que opten por recibir notificaciones push basadas en el navegador, sin necesidad de una aplicación 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)
↓
UserID → Segmentación → Notificaciones Activadas o Manuales
```
Esta integración le permite entregar 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
### Iniciar sesión en Shopify
1. Vaya a [Shopify Admin](https://admin.shopify.com/)
2. Seleccione su tienda desde el panel de control
### Instalar la aplicación de Pushwoosh
1. Visite la [página de la App Store de Pushwoosh](https://apps.shopify.com/pushwoosh-notifications)
2. Haga clic en **Instalar**
3. Confirme la instalación en el diálogo de Shopify
### Conectar su aplicación de Pushwoosh
Después de la instalación, será redirigido a la aplicación de Pushwoosh dentro de Shopify.
1. Haga clic en **Conectar**.
2. Ingrese el **Código de Aplicación** y el [Token de Acceso a la API de Dispositivos](/es/developer/api-reference/api-access-token/#device-api-token), que puede encontrar en el **Panel de Control de Pushwoosh → Configuración → Acceso a la API**.
Cuando se conecte, aparecerá un mensaje de éxito: "Aplicación de Pushwoosh conectada."
### Suscribirse a un plan
1. Haga clic en **Actualizar Suscripción**
2. Se mostrará un único plan basado en el uso.
3. Confirme la facturación.
## Parte 2. Configuración: ID de Usuario del Cliente a través de metacampos
Para entregar notificaciones push móviles a usuarios identificados, Pushwoosh utiliza un **ID de Usuario** único por cliente. Shopify almacena este valor dentro de los **Metacampos de Cliente** de Shopify.
1. Vaya a **Configuración → Metacampos y metaobjetos → Clientes**
2. Haga clic en **Añadir definición** y use estos valores:
| Campo | Valor |
| ----------------------- | ------------------------ |
| Espacio de nombres y clave | custom.pushwoosh_userid |
| Espacio de nombres | custom |
| Tipo | Texto de una sola línea |
| Validación | Ninguna |
| Acceso a la cuenta del cliente | Lectura y escritura |
| Acceso a la API de la tienda | Habilitado |
## Parte 3. Uso de las extensiones de Pushwoosh
Pushwoosh incluye Extensiones de Shopify para la segmentación, la automatización (Flow) y las notificaciones específicas para clientes.
### Extensión 1. Enviar notificación por cliente
#### Caso de uso
Enviar manualmente mensajes personalizados o probar notificaciones a un usuario específico.
#### Pasos
1. Abra **Clientes → Seleccione un cliente**
2. Haga clic en **Más acciones → Notificación por cliente**
3. Seleccione la plataforma de mensajería (por ejemplo, Correo electrónico) y un [preajuste de contenido](/es/product/content/push-presets/).
4. Haga clic en **Enviar**
### Extensión 2. Notificación por segmento
#### Caso de uso
Dirigirse a grupos de clientes: carritos abandonados, compradores primerizos, grandes gastadores.
#### Pasos
1. Vaya a **Clientes → Segmentos**
2. Elija un segmento → Haga clic en **Usar Segmento**
3. Seleccione **Notificación por Segmento**
4. Seleccione el canal de comunicación deseado y el preajuste de mensaje. Haga clic en **Enviar**.
### Extensión 3. Pushwoosh en Shopify Flow
#### Caso de uso
Automatizar la mensajería en los recorridos del cliente utilizando disparadores como pedidos, etiquetas o comportamiento.
#### Pasos
1. Cree un nuevo Flujo en **Shopify Flow**
2. Añada una acción → Elija **Notificaciones de Pushwoosh**
3. Configure el mensaje y los campos dinámicos
Por ejemplo:
* Enviar un mensaje después de realizar un pedido
* Recordar al usuario cuando el carrito está abandonado
* Enviar una notificación push de reactivación después de 30 días de inactividad
## Parte 4. Habilitar notificaciones push web (opcional pero recomendado)
Para admitir notificaciones push web basadas en el navegador en su escaparate, haga lo siguiente:
1. Vaya a **Tienda en línea → Temas → Personalizar**
2. Abra **Incrustaciones de aplicaciones** desde el menú de la izquierda
3. Active **Push Init Embed**
## Resumen de casos de uso
| Escenario | Herramienta utilizada |
| ----- | ----- |
| Seguimiento personalizado | Notificación por Cliente |
| Recordatorio de abandono de carrito | Shopify Flow + acción de Pushwoosh |
| Promoción basada en segmentos | Notificación por Segmento |
| Mensaje de bienvenida después de registrarse | Flow + seguimiento de Metacampo |
| Suscripción a notificaciones push | Incrustación de Tema + Activador de Push Init |