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 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 envio de 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 do Aplicativo do Pushwoosh
• Uma loja Shopify com clientes e dados de pedidos disponíveis
• Aprovação dos escopos de acesso read_orders, write_pixels e read_customer_events que o aplicativo solicita, necessários para eventos de pedido/carrinho, rastreamento de etapas de checkout e eventos comportamentais da vitrine

Já conectado? Você será solicitado a reaprovar o acesso

Se você conectou o aplicativo Pushwoosh antes da existência do rastreamento de pedidos, carrinhos e checkout, o Shopify solicitará que você aprove os novos escopos na próxima vez que abrir o aplicativo — esta é a maneira esperada como o Shopify implementa 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 UserIDs do Pushwoosh por meio 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 no aplicativo 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 incorporaçã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 for 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: Usados para segmentação e mensagens baseadas em grupos
• Eventos e gatilhos (por exemplo, pedidos realizados, tags aplicadas): Usados no Shopify Flow para automatizar o envio de mensagens em todos os canais
• Vitrine: Usada para capturar opt-ins de 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 aplicativo e se desconecta automaticamente se você o desinstalar.
• Pedidos e carrinhos: Eventos de servidor para servidor dos webhooks orders/paid e checkouts/create do Shopify. Consulte Rastrear pedidos, carrinhos e etapas de checkout.
• Comportamento de navegação na vitrine: Visualizações de produtos e ações de adicionar ao carrinho, coletadas pela mesma incorporação de tema usada para opt-ins de web push.
• Etapas de checkout: Informações de contato inseridas e informações de pagamento enviadas, coletadas por meio de um Web Pixel do Shopify.

Glossário (mapeando nomes de entidades se forem diferentes)

Shopify	Pushwoosh
Cliente	UserID
webhook orders/paid	Evento PW_OrderCreated — compartilhado com outras integrações de e-commerce (por exemplo, Magento)
webhook checkouts/create	Evento PW_AbandonedCart — mesmo evento compartilhado, também usado pela fonte de Carrinho do bloco de Produtos
Visualização da página do produto	Evento PW_ProductViewed

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 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 o envio de 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 Na 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 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 do Aplicativo 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.”

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

Conectar o aplicativo também conecta o feed da vitrine da sua loja ao Catálogo de Produtos do Pushwoosh automaticamente — não é necessária uma configuração de feed separada. A moeda da sua loja é capturada ao mesmo tempo e atualiza automaticamente se você alterar a moeda da sua loja posteriormente.

Assine um plano

1. Clique em Atualizar Assinatura
2. Um único plano baseado em 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 metafields

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 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 и 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 solicitações 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 o envio de 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 do 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 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 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.

Parte 5. Rastrear pedidos, carrinhos e etapas de checkout

Depois de aprovar os escopos read_orders, write_pixels e read_customer_events (consulte Pré-requisitos), o Pushwoosh começa a receber três tipos de eventos de comércio da sua loja. Eles vêm de lugares diferentes e param independentemente uns dos outros — não os trate como um único feed.

Eventos de pedido e carrinho do lado do servidor

O Shopify envia eventos de pedido pago (webhook orders/paid, evento PW_OrderCreated) e checkout criado (webhook checkouts/create, evento PW_AbandonedCart) para o Pushwoosh diretamente, de servidor para servidor. Ambos são compartilhados com outras integrações de e-commerce — o Magento usa os mesmos dois nomes de eventos. Como outros eventos de webhook de entrada (o Stripe funciona da mesma maneira), eles aparecem no menu suspenso Evento quando você cria um segmento ou configura um gatilho de Jornada do Cliente, e você pode mapear qualquer um deles como fonte para eventos de conversão para trazer a receita do Shopify para a segmentação RFM, atribuição de jornada e as estatísticas dos blocos de Produtos que você envia em e-mails.

Como esses eventos vêm do servidor do Shopify, e não do navegador do comprador, eles continuam chegando mesmo para compradores que bloqueiam rastreadores ou usam um bloqueador de anúncios.

Abandono de carrinho significa três coisas diferentes aqui

• O gatilho de Abandono de carrinho no Shopify Flow (consulte Automação orientada a eventos via Shopify Flow) é uma condição nativa do Shopify, não relacionada aos eventos do Pushwoosh.
• O webhook checkouts/create acima significa apenas que um checkout foi iniciado — o Shopify ainda não decidiu que ele foi “abandonado”, e nenhum pedido foi confirmado.
• A fonte de Carrinho do bloco de Produtos lê o carrinho do destinatário através da tag PW_AbandonedCartID, independentemente desses eventos.

Escolha aquele que corresponde ao que você está realmente construindo, não o nome que soa mais próximo.

Eventos de navegação na vitrine

Visualizações de produtos (evento PW_ProductViewed) e ações de adicionar ao carrinho são coletadas pela mesma incorporação de tema que você já instalou para opt-ins de web push — não há nada de novo para adicionar ao seu tema, mas a incorporação deve estar ATIVADA (consulte Habilitar web push) para que esses eventos cheguem. Se você pulou essa ativação, não receberá nem opt-ins de web push nem eventos da vitrine.

Eventos da vitrine precisam que a incorporação do tema esteja habilitada

Eventos de visualização de produtos e de adição ao carrinho vêm do navegador do comprador. Se um comprador bloquear o script da incorporação, ou se você deixar a incorporação do tema desativada, você deixará de receber esses dois eventos — mas os eventos de pedido pago e checkout criado continuarão chegando independentemente, já que vêm do servidor do Shopify. Não presuma que uma incorporação de tema desativada também pausa o rastreamento de pedidos.

PW_ProductViewed não tem desduplicação

O PW_ProductViewed é acionado a cada carregamento de página de produto — incluindo visitas repetidas na mesma sessão, recarregamentos de página e tráfego de bots ou rastreadores. Não há desduplicação ou limitação. Como estratégias como Baseado no que eles viram são construídas a partir deste evento, o tráfego ruidoso também alimenta essas recomendações.

Eventos de etapa de checkout

Um Web Pixel do Shopify relata dois marcos do checkout à medida que o comprador preenche o formulário de checkout:

• PW_CheckoutContactInfo: o comprador inseriu suas informações de contato.
• PW_PaymentInfoSubmitted: o comprador enviou seus detalhes de pagamento.

A compra concluída não faz parte deste pixel

O Web Pixel intencionalmente não rastreia a compra concluída — esse é o evento de pedido pago do lado do servidor mencionado acima. Use os eventos do Web Pixel para ver onde os compradores desistem durante o checkout, e o evento de pedido para saber que uma venda realmente aconteceu.

Parte 6. Conformidade de dados

O Shopify exige que todos os aplicativos públicos respondam aos seus webhooks obrigatórios de GDPR/CCPA. O Pushwoosh os trata da seguinte forma:

• customers/redact: Quando um comprador solicita à loja que apague seus dados, o Pushwoosh apaga os registros correspondentes do Pushwoosh por quaisquer identificadores que o Shopify envie — e-mail, telefone e ID de cliente do Shopify.
• customers/data_request: Quando um comprador solicita uma cópia de seus dados, o Pushwoosh posta uma notificação no canal interno de suporte, e uma pessoa lida com a solicitação manualmente. O Shopify exige que os aplicativos respondam a essas solicitações em até 30 dias.
• shop/redact: O Shopify envia isso 48 horas após uma loja desinstalar o aplicativo, solicitando a exclusão dos dados da loja. O Pushwoosh não tem um manipulador separado para isso por design — a desinstalação já exclui todo o registro de integração da loja (incluindo chave de API de dispositivo, código do aplicativo e IDs de faturamento), então não há mais nada para este webhook apagar quando ele chega.

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 de Inicialização de Push
Atribuição de receita e segmentação RFM	Eventos de pedido/checkout mapeados para eventos de conversão
Análise de abandono de checkout	Eventos PW_CheckoutContactInfo / PW_PaymentInfoSubmitted
Segmentos de abandono de navegação ou carrinho	Eventos de visualização de produto / adição ao carrinho da vitrine