Integração com o Shopify

Visão geral da integração

O Pushwoosh integra-se perfeitamente com o Shopify, uma plataforma de e-commerce líder que permite às empresas criar, gerenciar e escalar 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 canais como push, e-mail, SMS e WhatsApp.

Tipo de integração

• Destino: O Shopify envia dados de clientes para o Pushwoosh, onde são usados para segmentação e mensagens.

Pré-requisitos

• Uma conta Pushwoosh
• Acesso ao seu painel de administração do Shopify
• Token de Acesso da API de Dispositivo e Código da Aplicação do Pushwoosh
• 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 metacampos 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.
• Aplicações 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 do 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 mensagens baseadas em grupos
• Eventos e gatilhos (por exemplo, pedidos feitos, tags aplicadas): Usado no Shopify Flow para automatizar mensagens em todos os canais
• Vitrine (Storefront): Usado para capturar opt-ins de web push através de scripts incorporados

Glossário (mapeando 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 em todos os canais.

Componentes chave da integração

1. Identificação do cliente via metacampos A cada cliente do Shopify é atribuído um UserID único, armazenado em um metacampo (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 mensagens (push, e-mail, SMS, WhatsApp) 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 específicas para grupos em todos os canais, 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 de web push 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 da App Store do Pushwoosh
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 no uso será mostrado.
3. Confirme o faturamento.

Nota

O faturamento é necessário para usar os recursos de entrega de mensagens e segmentação.

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

Para entregar notificações a usuários identificados em todos os canais (push, e-mail, SMS, WhatsApp), o Pushwoosh usa um User ID único por cliente. O Shopify armazena esse valor nos Metacampos do Cliente do Shopify.

1. Vá para Configurações → Metacampos 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 Storefront	Ativado

Por que isso é importante

Este metacampo é 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 uma predefinição 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 a predefinição 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 do cliente 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:

• 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 web push (opcional, mas recomendado)

Para suportar notificações de web push baseadas no 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 a Incorporação de Inicialização de Push

Nota

Agora sua loja pode solicitar que os usuários optem por receber web push 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 Metacampo
Opt-in de Push	Incorporação de Tema + Ativação de Inicialização de Push