Integração com 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 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 de usuários 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
• Acesso ao seu painel de administração do Shopify
• Token de Acesso da API de Dispositivo do Pushwoosh e Código da Aplicação
• Uma loja Shopify com dados de clientes e pedidos disponíveis

Entidades sincronizadas

• Clientes: Usado para atribuir e identificar UserIDs do Pushwoosh através de metafields do Shopify

Nota

Abordagens de sincronização de clientes no Pushwoosh

Devido a limitações técnicas, o Pushwoosh oferece vários métodos de sincronização de clientes, dependendo do canal de comunicação usado para as notificações:

• E-mail, Web, SMS e WhatsApp: Dispositivos/usuários são registrados automaticamente na aplicação Pushwoosh.
• Aplicativos Móveis e de Desktop: Dispositivos/usuários podem ser sincronizados manualmente através dos painéis de administração do Pushwoosh e do Shopify.
• Plataformas Web (Chrome, Firefox, Safari): Dispositivos/usuários são gerenciados pela própria extensão de tema do Shopify.

Como funciona?

O processo de sincronização opera da seguinte forma:

1. O sistema tenta recuperar a sessão do usuário atual para obter um e-mail ou número de telefone (identificadores que funcionam sem configuração adicional).
2. Se bem-sucedido, o e-mail ou número de telefone é definido como o identificador userID tanto para o Pushwoosh quanto para a propriedade pushwoosh_userid nos dados do cliente.
3. Se isso não for possível, o userID padrão do SDK do Pushwoosh é atribuído como o identificador tanto para o Pushwoosh quanto para a propriedade pushwoosh_userid.
4. Em qualquer caso, um userID será atribuído em ambos os lados, garantindo uma sincronização consistente.

• Segmentos de clientes: Usado para segmentação e envio de mensagens baseadas em grupos
• Eventos e gatilhos (por exemplo, pedidos realizados, tags aplicadas): Usado no Shopify Flow para automatizar o envio de mensagens push
• Vitrine (Storefront): Usado para capturar opt-ins de push na 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 cliente 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 a um 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 A partir da visualização de cliente ou segmento do Shopify, você pode acionar manualmente notificações 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 na 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

Dados de Clientes e Eventos do Shopify
         ↓
API do Pushwoosh (via App)
         ↓
UserID → Segmentação → Notificações Acionadas ou Manuais

Esta integração capacita você a entregar mensagens oportunas e relevantes que melhoram a retenção de usuários, aumentam as conversões e aprimoram a experiência do cliente — automaticamente ou sob demanda.

Parte 1. Instalação

Faça login no Shopify

1. Vá para o Admin do Shopify
2. Selecione sua loja no painel

Nota

Este guia assume que você já tem uma conta Pushwoosh. Se não, crie uma

Instale o aplicativo Pushwoosh

1. Visite a página do Pushwoosh na App Store
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, 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 a cobrança.

Nota

A cobrança é necessária para usar os recursos de entrega de push e segmentação.

Parte 2. Configuração: User ID do Cliente via metafields

Para entregar notificações push móveis para usuários identificados, o Pushwoosh usa um User ID único por cliente. O Shopify armazena esse valor nos Metafields do 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

Por que isso é importante

Este metafield é um identificador de usuário persistente em dispositivos móveis/web para notificações e segmentação.

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 teste notificações 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 um preset de conteúdo.
4. Clique em Enviar

Dica

Use isso para lembretes pós-compra, agradecimentos pessoais ou prompts de reativação.

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 o preset de mensagem. Clique em Enviar.

Dica

Os segmentos podem ser criados com base no histórico de compras, localização, atividade ou tags.

Extensão 3. Pushwoosh no Shopify Flow

Caso de uso

Automatize mensagens em jornadas de clientes usando gatilhos como pedidos, tags ou comportamento.

Passos

1. Crie um novo Flow no Shopify Flow
2. Adicione uma ação → Escolha Notificações Pushwoosh

3. Configure a mensagem e os campos dinâmicos

Por exemplo:

• Enviar uma mensagem após a realização do pedido

• Lembrar o usuário quando o carrinho for abandonado

• Enviar um push de reativação após 30 dias de inatividade

Parte 4. Habilitar push na web (opcional, mas recomendado)

Para suportar notificações push na 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

Nota

Agora sua loja pode solicitar que os usuários optem por receber push na web diretamente da vitrine.

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 + Ativação do Push Init