# Integração com o Shopify
## Visão geral da integração
O Pushwoosh se integra perfeitamente com o Shopify, uma plataforma de e-commerce líder que permite que as empresas criem, gerenciem e escalem lojas online. Este guia orienta você na instalação e configuração do aplicativo Pushwoosh em sua loja Shopify, na configuração da identificação do usuário e no uso de notificações e ferramentas de automação para engajar clientes em dispositivos móveis e na web.
### Tipo de integração
- **Destino**: O Shopify envia dados de clientes para o Pushwoosh, onde são usados para segmentação e envio de mensagens.
### Pré-requisitos
* Uma [conta Pushwoosh](https://www.pushwoosh.com/)
* Acesso ao seu painel de administração do Shopify
* [Token de Acesso da API de Dispositivo](/pt/developer/api-reference/api-access-token/#device-api-token) do Pushwoosh e **Código da Aplicação**
* Uma loja Shopify com dados de clientes e pedidos disponíveis
### Entidades sincronizadas
* **Clientes**: Usados para atribuir e identificar UserIDs do Pushwoosh via metafields do Shopify
* **Segmentos de clientes**: Usados para segmentação e envio de mensagens baseadas em grupos
* **Eventos e gatilhos** (por exemplo, pedidos feitos, tags aplicadas): Usados no Shopify Flow para automatizar o envio de mensagens push
* **Vitrine (Storefront)**: Usada para capturar opt-ins de push da web através de scripts incorporados
### Glossário (mapeamento de nomes de entidades se forem diferentes)
| **Shopify** | **Pushwoosh** |
| -------------------------- | --------------------------------------------------------- |
| Cliente | UserID |
## Como a integração funciona
O Pushwoosh atua como um destino de mensagens para o Shopify. Uma vez integrado, o Shopify envia dados de clientes e comportamentais para o Pushwoosh, onde alimenta notificações em tempo real, segmentação de clientes e mensagens personalizadas na web e em dispositivos móveis.
### Componentes-chave da integração
1. **Identificação de clientes via metafields**
A cada cliente do Shopify é atribuído um `UserID` único, armazenado em um metafield (`custom.pushwoosh_userid`). Este ID permite que o Pushwoosh reconheça e envie mensagens aos usuários de forma consistente em todas as plataformas.
2. **Automação orientada a eventos via Shopify Flow**
O Pushwoosh fornece ações do Flow que permitem automatizar notificações push com base em eventos do Shopify, como:
* Novo pedido realizado
* Tag aplicada ao cliente
* Abandono de carrinho
3. **Segmentação baseada em segmentos**
Segmentos de clientes do Shopify podem ser usados para enviar notificações push específicas para grupos, como promoções para compradores de primeira viagem ou campanhas de reativação para usuários inativos.
4. **Mensagens manuais e em tempo real**
Na visualização de cliente ou segmento do Shopify, você pode acionar notificações manualmente usando as Extensões do Pushwoosh:
* **Notificação por Cliente**: Para acompanhamentos pessoais ou testes
* **Notificação por Segmento**: Para mensagens baseadas em campanhas
### Notificações push da web via incorporação na vitrine
Ao habilitar a incorporação do Pushwoosh em seu tema do Shopify, você pode solicitar que os visitantes do site optem por receber notificações push baseadas no navegador — sem a necessidade de um aplicativo móvel.
#### Visão geral do fluxo de dados
```
Shopify Customer & Event Data
↓
Pushwoosh API (via App)
↓
UserID → Segmentation → Triggered or Manual Notifications
```
Esta integração permite que você entregue mensagens oportunas e relevantes que melhoram a retenção de usuários, aumentam as conversões e aprimoram a experiência do cliente — de forma automática ou sob demanda.
## Parte 1. Instalação
### Faça login no Shopify
1. Acesse o [Admin do Shopify](https://admin.shopify.com/)
2. Selecione sua loja no painel
### Instale o aplicativo Pushwoosh
1. Visite a [página do aplicativo Pushwoosh na App Store](https://apps.shopify.com/pushwoosh-notifications)
2. Clique em **Instalar**
3. Confirme a instalação na caixa de diálogo do Shopify
### Conecte seu aplicativo Pushwoosh
Após a instalação, você será redirecionado para o aplicativo Pushwoosh dentro do Shopify.
1. Clique em **Conectar**.
2. Insira o **Código da Aplicação** e o [Token de Acesso da API de Dispositivo](/pt/developer/api-reference/api-access-token/#device-api-token), que você pode encontrar no **Painel de Controle do Pushwoosh → Configurações → Acesso à API**.
Quando conectado, uma mensagem de sucesso aparecerá: "Aplicativo Pushwoosh conectado."
### Assine um plano
1. Clique em **Atualizar Assinatura**
2. Um único plano baseado em uso será mostrado.
3. Confirme o faturamento.
## Parte 2. Configuração: ID de Usuário do Cliente via metafields
Para entregar notificações push móveis a usuários identificados, o Pushwoosh usa um **ID de Usuário** único por cliente. O Shopify armazena esse valor nos **metafields de Cliente** do Shopify.
1. Vá para **Configurações → Metafields e metaobjetos → Clientes**
2. Clique em **Adicionar definição** e use estes valores:
| Campo | Valor |
| ----------------------- | ------------------------ |
| Namespace e chave | custom.pushwoosh_userid |
| Namespace | custom |
| Tipo | Texto de linha única |
| Validação | Nenhuma |
| Acesso à Conta do Cliente | Leitura e Escrita |
| Acesso à API da Vitrine | Habilitado |
## Parte 3. Usando as extensões do Pushwoosh
O Pushwoosh inclui Extensões do Shopify para segmentação, automação (Flow) e notificações específicas para clientes.
### Extensão 1. Enviar notificação por cliente
#### Caso de uso
Envie manualmente mensagens personalizadas ou notificações de teste para um usuário específico.
#### Passos
1. Abra **Clientes → Selecione um cliente**
2. Clique em **Mais ações → Notificação por cliente**
3. Selecione a plataforma de mensagens (por exemplo, E-mail) e uma [predefinição de conteúdo](/pt/product/content/push-presets/).
4. Clique em **Enviar**
### Extensão 2. Notificação por segmento
#### Caso de uso
Segmente grupos de clientes — carrinhos abandonados, compradores de primeira viagem, grandes gastadores.
#### Passos
1. Vá para **Clientes → Segmentos**
2. Escolha um segmento → Clique em **Usar Segmento**
3. Selecione **Notificação por Segmento**
4. Selecione o canal de comunicação desejado e a predefinição de mensagem. Clique em **Enviar**.
### Extensão 3. Pushwoosh no Shopify Flow
#### Caso de uso
Automatize o envio de mensagens nas jornadas do cliente usando gatilhos como pedidos, tags ou comportamento.
#### Passos
1. Crie um novo Fluxo no **Shopify Flow**
2. Adicionar ação → Escolha **Notificações Pushwoosh**
3. Configure a mensagem e os campos dinâmicos
Por exemplo:
* Envie uma mensagem após a realização de um pedido
* Lembre o usuário quando o carrinho for abandonado
* Envie um push de reativação após 30 dias de inatividade
## Parte 4. Habilitar push da web (opcional, mas recomendado)
Para suportar notificações push da web baseadas em navegador em sua vitrine, faça o seguinte:
1. Vá para **Loja Online → Temas → Personalizar**
2. Abra **Incorporações de aplicativos** no menu à esquerda
3. Ative o **Push Init Embed**
## Resumo dos casos de uso
| Cenário | Ferramenta usada |
| ----- | ----- |
| Acompanhamento personalizado | Notificação por Cliente |
| Lembrete de abandono de carrinho | Shopify Flow + ação Pushwoosh |
| Promoção baseada em segmento | Notificação por Segmento |
| Mensagem de boas-vindas após o cadastro | Flow + Rastreamento de Metafield |
| Opt-in de Push | Incorporação de Tema + Ativador Push Init |