Configurar o Shopify

Visão geral da integração

O Pushwoosh se integra perfeitamente ao Shopify, uma plataforma líder de e-commerce que permite às empresas criar, gerenciar e escalar lojas online. Este guia orienta você na instalação e configuração do app 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 por 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 API do Dispositivo do Pushwoosh e o Application Code
• Uma loja Shopify com dados de clientes e pedidos disponíveis
• Aprovação do escopo de acesso read_orders para eventos de pedido/carrinho, além de write_pixels e read_customer_events para rastrear as etapas do checkout

Já conectado? Você será solicitado a aprovar o acesso novamente

Se você conectou o app Pushwoosh antes de existir o rastreamento de pedidos, carrinhos e checkout, o Shopify pedirá para você aprovar os novos escopos na próxima vez que abrir o app — essa é a forma padrão como o Shopify lança permissões adicionais, não é um erro. Aprove-os para começar a receber eventos de pedido, carrinho e checkout.

Entidades sincronizadas

• Clientes: usados para atribuir e identificar User IDs do Pushwoosh por meio 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 no app Pushwoosh.
• Apps móveis e de desktop: dispositivos/usuários podem ser sincronizados manualmente pelos painéis de administração do Pushwoosh e do Shopify.
• Plataformas web (Chrome, Firefox, Safari): dispositivos/usuários são gerenciados pelo próprio embed do tema do Shopify.

Como isso funciona?

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

1. O sistema tenta recuperar a sessão atual do usuário para obter um e-mail ou número de telefone (identificadores que funcionam sem configuração adicional).
2. Em caso de sucesso, 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 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: usados para segmentação e mensagens baseadas em grupos
• Eventos e gatilhos (por exemplo, pedidos realizados, tags aplicadas): usados no Shopify Flow para automatizar mensagens entre canais
• Vitrine: usada para capturar inscrições em web push por meio de scripts incorporados
• Feed de produtos: o feed da vitrine da sua loja (products.json) se conecta automaticamente ao Catálogo de produtos do Pushwoosh quando você conecta o app, e se desconecta automaticamente se você o desinstalar.
• Pedidos e carrinhos: eventos de servidor para servidor dos webhooks orders/paid, checkouts/create e checkouts/update do Shopify. Veja Eventos e campanhas do Shopify.
• Comportamento de navegação na vitrine: visualizações de produtos e ações de adicionar ao carrinho, coletadas pelo mesmo embed de tema usado para as inscrições em web push.
• Etapas do checkout: informações de contato inseridas e informações de pagamento enviadas, coletadas por meio de um Shopify Web Pixel.

Glossário (mapeamento de nomes de entidades quando diferentes)

Shopify	Pushwoosh
Customer	User ID
Webhook orders/paid	Evento PW_OrderCreated — compartilhado com outras integrações de e-commerce (por exemplo, Magento)
Webhook checkouts/create	Evento PW_AbandonedCart — o mesmo evento compartilhado, também usado pela fonte Cart do bloco Products
Webhook checkouts/update	Evento PW_AbandonedCartUpdate — disparado enquanto o comprador continua editando o mesmo checkout, sobrescrevendo o carrinho armazenado desde PW_AbandonedCart
Visualização de página de produto	Evento PW_ProductViewed
Adicionar ao carrinho (sem recarregar a página)	Evento PW_AddToCart
Web Pixel checkout_contact_info_submitted	Evento PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Evento PW_PaymentInfoSubmitted

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 de comportamento para o Pushwoosh, onde eles alimentam notificações em tempo real, segmentação de clientes e mensagens personalizadas em diferentes canais.

Componentes-chave da integração

1. Identificação de clientes via metacampos Cada cliente do Shopify recebe um User ID único, armazenado em um metacampo (custom.pushwoosh_userid). Esse ID permite que o Pushwoosh reconheça e envie mensagens aos usuários de forma consistente em todas as plataformas.

2. Automação orientada por eventos via Shopify Flow O Pushwoosh oferece ações de Flow que permitem automatizar mensagens (push, e-mail, SMS, WhatsApp) com base em eventos do Shopify, como:

   • Novo pedido realizado
   • Tag aplicada ao cliente
   • Abandono de carrinho

3. Segmentação baseada em segmentos Os segmentos de clientes do Shopify podem ser usados para enviar notificações específicas por grupo em diferentes canais, como promoções para novos compradores ou campanhas de reativação para usuários inativos.

4. Mensagens manuais em tempo real A partir da visualização de cliente ou segmento no Shopify, você pode acionar notificações manualmente usando as extensões do Pushwoosh:

   • Notification by Customer: para acompanhamentos pessoais ou testes
   • Notification by Segment: para mensagens baseadas em campanhas

Notificações web push por meio do embed da vitrine

Ao ativar o embed do Pushwoosh no seu tema do Shopify, você pode convidar os visitantes do site a se inscrever em notificações push baseadas no navegador — sem necessidade de um app móvel.

Visão geral do fluxo de dados

Dados de clientes e eventos do Shopify
         ↓
API do Pushwoosh (via o app)
         ↓
User ID → Segmentação → Notificações acionadas ou manuais

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

Parte 1. Instalação

Faça login no Shopify

1. Acesse o Shopify Admin
2. Selecione sua loja no painel

Nota

Este guia assume que você já tem uma conta Pushwoosh. Caso contrário, crie uma

Instale o app Pushwoosh

1. Visite a página do Pushwoosh na App Store do Shopify
2. Clique em Install
3. Confirme a instalação na caixa de diálogo do Shopify

Conecte seu app Pushwoosh

Após a instalação, você será redirecionado para o app Pushwoosh dentro do Shopify.

1. Clique em Connect.

2. Insira o Application Code e a API Key, que você pode encontrar em Pushwoosh Control Panel → Settings → API Access. A API Key aqui é o seu Token de API do Dispositivo.

Ao conectar, uma mensagem de sucesso aparecerá: “Pushwoosh app connected.”

Quando o Shopify solicitar permissões (pedidos, pixels, eventos de clientes), aprove-as. Esses escopos são necessários para o rastreamento de Eventos e campanhas do Shopify. Se você conectou o app anteriormente, veja Já conectado? Você será solicitado a aprovar o acesso novamente.

Conexão automática do catálogo de produtos

Conectar o app também conecta automaticamente o feed da vitrine da sua loja ao Catálogo de produtos do Pushwoosh. Não é necessária uma configuração de feed separada. A moeda da sua loja é capturada ao mesmo tempo, e é atualizada automaticamente se você alterar a moeda da loja posteriormente.

Assine um plano

1. Clique em Upgrade Subscription
2. Um único plano baseado em uso será exibido.
3. Confirme a cobrança.

Nota

É necessária cobrança 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 por diferentes canais (push, e-mail, SMS, WhatsApp), o Pushwoosh usa um User ID único por cliente. O Shopify armazena esse valor nos metacampos de cliente do Shopify.

1. Vá para Settings → Metafields and metaobjects → Customers

2. Clique em Add definition e use estes 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

Defina Customer accounts access e Storefront API access como na tabela acima.

Por que isso é importante

Esse 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 por segmento, automação (Flow) e notificações específicas de cliente.

Extensão 1. Send notification by customer

Caso de uso

Enviar manualmente mensagens personalizadas ou notificações de teste para um usuário específico.

Etapas

1. Abra Customers → Selecione um cliente
2. Clique em More actions → Notification by customer
   
3. Selecione a plataforma de mensagens (por exemplo, Email) e um preset de conteúdo.
4. Clique em Send

Dica

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

Extensão 2. Notification by segment

Caso de uso

Segmentar grupos de clientes — carrinhos abandonados, primeiros compradores, grandes gastadores.

Etapas

1. Vá para Customers → Segments

2. Escolha um segmento → Clique em Use Segment

3. Selecione Notification by Segment
4. Selecione o canal de comunicação e o preset de mensagem desejados. Clique em Send.

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

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

Etapas

1. Crie um novo Flow no Shopify Flow
2. Adicione uma ação → Escolha Pushwoosh send notification

3. Configure a mensagem e os campos dinâmicos

Por exemplo:

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

• Lembrar o usuário quando o carrinho for abandonado

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

Parte 4. Ative o web push (e os eventos de navegação na vitrine)

Opcional apenas para web push. Obrigatório se você precisar de eventos de visualização de produto e adição ao carrinho em Eventos e campanhas do Shopify.

Ative o embed de tema para web push do navegador na sua vitrine:

1. Vá para Online Store → Themes → Customize
   
2. Abra App Embeds no menu esquerdo
3. Ative Push Init Embed

Nota

Agora sua loja pode convidar os usuários a se inscrever em web push diretamente pela vitrine. Se você pular essa alternância, também não obterá eventos de navegação na vitrine em Eventos e campanhas do Shopify. Os eventos de pedido pago e checkout continuam chegando mesmo sem isso.

Conformidade de dados

O Shopify exige que todo app público responda aos seus webhooks obrigatórios de GDPR/CCPA. O Pushwoosh os trata da seguinte forma:

• customers/redact: quando um comprador pede à loja para apagar seus dados, o Pushwoosh apaga os registros correspondentes do Pushwoosh de acordo com os identificadores enviados pelo Shopify — e-mail, telefone e ID de cliente do Shopify.
• customers/data_request: quando um comprador solicita uma cópia de seus dados, o Pushwoosh publica uma notificação no canal interno de suporte, e uma pessoa trata a solicitação manualmente. O Shopify exige que os apps respondam a essas solicitações dentro de 30 dias.
• shop/redact: o Shopify envia isso 48 horas depois que uma loja desinstala o app, solicitando o apagamento dos dados da loja. O Pushwoosh executa novamente a mesma exclusão que a própria desinstalação aciona, limpando qualquer sessão restante e apagando o registro de integração da loja (incluindo a chave de API do dispositivo, o código de aplicação e os IDs de cobrança). Isso existe como uma rede de segurança para o caso de a desinstalação não ter limpado tudo completamente na primeira vez.

Resumo dos casos de uso

Após a configuração, formas comuns de enviar mensagens a partir do Shopify:

Cenário	Ferramenta usada
Acompanhamento personalizado	Notification by Customer
Promoção baseada em segmento	Notification by Segment
Mensagem de boas-vindas após o cadastro	Flow + rastreamento de metacampo
Lembrete de carrinho abandonado	Shopify Flow + ação do Pushwoosh
Inscrição em push	Embed de tema + alternância Push Init

Para journeys e segmentos baseados em eventos de pedido, carrinho, checkout e vitrine, veja Eventos e campanhas do Shopify.