--- title: "Shopify" slug: "shopify" updated: 2026-06-12T10:30:48Z published: 2026-06-12T10:30:48Z canonical: "docs.xtremepush.com/shopify" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Shopify A Integração Shopify permite que você sincronize automaticamente os dados do Shopify, execute campanhas personalizadas de marketing de e-commerce e as analise. ## Criar um aplicativo Xtremepush no Shopify Faça login na sua conta Shopify, navegue até **Apps > Construa aplicativos personalizados para suas necessidades únicas**. Depois, clique em **Desenvolver aplicativos para sua loja**. Depois disso, clique em **Criar um app**. ![2862](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/fa27376-Screenshot_2022-04-07_at_17.37.15(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A00Z&se=2026-11-04T09%3A57%3A00Z&sr=c&sp=r&sig=sO9tqkDy0SWqjGg8S5W%2F%2BFjTBbHiQp9%2F53dAehLNGCc%3D)![2868](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/72f091d-Screenshot_2022-04-07_at_17.39.24(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A00Z&se=2026-11-04T09%3A57%3A00Z&sr=c&sp=r&sig=sO9tqkDy0SWqjGg8S5W%2F%2BFjTBbHiQp9%2F53dAehLNGCc%3D) Preencha os dados do app no pop-up inserindo um nome descritivo e o endereço de e-mail do desenvolvedor responsável pela integração nos campos apropriados, depois clique em **Criar app**. ![1646](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/728d528-Screenshot_2022-02-04_at_11_31_43(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A00Z&se=2026-11-04T09%3A57%3A00Z&sr=c&sp=r&sig=sO9tqkDy0SWqjGg8S5W%2F%2BFjTBbHiQp9%2F53dAehLNGCc%3D) Nessa etapa, atribua o nível relevante de permissões da API de Administrador da integração **da API de Configuração > Administrador**. ![2110](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/2267bf1-Screenshot_2022-02-04_at_11.40.20(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A00Z&se=2026-11-04T09%3A57%3A00Z&sr=c&sp=r&sig=sO9tqkDy0SWqjGg8S5W%2F%2BFjTBbHiQp9%2F53dAehLNGCc%3D) > [!NOTE] > Permissões necessárias > > Para uma integração funcional com o Shopify, você precisa das seguintes permissões de usuário: acesso de leitura e escrita para Clientes, acesso de leitura para pedidos de rascunho, acesso de leitura para Pedidos e acesso de leitura para Produtos. Depois de salvar suas permissões, vá até a seção **de Credenciais da API** e instale seu app. Depois que o app for instalado, o Shopify gerará seu token de acesso à API, que você precisará usar na plataforma Xtremepush para completar sua integração. ## Conecte-se ao Shopify Depois de completar os passos acima no Shopify, abra uma nova aba no seu navegador e faça login na sua conta Xtremepush. Navegue até **Integrações > Marketplace**, selecione o cartão **Shopify** na aba **Marketplace de Integrações** e clique **em Conectar**. Preencha as seções **de Conexão**, **Mapeamento de Dados** e **Eventos em Tempo Real** para completar a integração. ### Conexão Nesta seção, você precisa inserir configurações básicas e detalhes de conexão. #### Configurações básicas Dê um *nome* à sua conexão que ajude a identificá-la facilmente. #### Configurações de conexão - *Admin API Access Token*: Encontrado na **seção Develop apps do Shopify para sua loja > API Credentials** , chamado *Admin API access token*. - *Chave API*: Encontrada na **seção Desenvolver aplicativos para sua loja > Credenciais API** , chamada *chave API*. - *Chave secreta da API*: Encontrada na **seção Develop apps do Shopify para sua loja > Credenciais da API** , chamada *chave secreta da API*. - *URL do armazenamento*: Como `example.myshopify.com`. Após concluir os detalhes da conexão, clique **em Próximo** e navegue até a aba **de Mapeamento de Dados** . ### Mapeamento de dados Esta seção lista seus atributos do sistema mapeados automaticamente, o que permite selecionar qual atributo padrão deseja importar e também permitir que você mapeie seus atributos personalizados do Shopify para seus atributos personalizados no Xtremepush. Os atributos do sistema do Xtremepush, como `user_id` e (e `email` serão automaticamente mapeados para Shopify `legacyResourceId` e `email` atributos (listados nos campos **da Coluna** ). Por outro lado, você verá os atributos padrão do Shopify (listados nos campos **Coluna** ) selecionados como **Importar** (listados nos campos **Mapar para** ). Você pode decidir qual atributo buscar selecionando o campo **Importar** ou **Não Importar** na lista de descartes. Por fim, você também verá atributos personalizados do Shopify (listados nos campos **da Colunha** ), como `canDelete` e `acceptsMarketingUpdatedAt`. Você também pode mapear esses atributos para seus atributos personalizados Xtremepush predefinidos. > [!TIP] > Dados de assinatura por e-mail > > Para coletar dados de assinatura de e-mail, você precisa mapear o atributo do `acceptsMarketing` Shopify ao atributo do `email_subscription` Xtremepush. > [!NOTE] > Criação de atributos > > Atributos do sistema e atributos padrão são criados automaticamente no Xtremepush. No entanto, para mapear atributos personalizados, você precisa criar esses atributos primeiro no sistema Xtremepush. Revise nosso guia [de Atributos e Tags](/documentation/docs/pt-br/attributes-tags#create-a-new-attribute-or-tag) para ver como fazer isso. Depois de concluir o mapeamento de dados, clique em **Próximo** para navegar até a aba **de eventos em tempo** real. ### Eventos em tempo real Nesta seção, você é obrigado a selecionar eventos em tempo real que deseja usar em suas campanhas. Você pode ativar eventos relacionados ao checkout, cliente, ordem de pedido, pedido, transação de pedidos e reembolso. Quando você ativa um evento, poderá usá-lo em suas campanhas, pois ele será criado automaticamente como um evento personalizado na plataforma Xtremepush quando esse evento for acionado pelo Shopify. Esses eventos podem ser usados quando você cria campanhas desencadeadas por eventos. Você também pode usá-los na segmentação, por exemplo, para abandono de caixa ou envio de boas-vindas para compradores de primeira viagem. > [!NOTE] > Nomeação dos eventos > > Os eventos usarão seus nomes do Shopify. Por exemplo; ***pedidos/criação, clientes/atualização, pedidos/partially_fulfilled*** etc. Você pode conferir a nomeação dos eventos [disponíveis aqui.](https://shopify.dev/docs/admin-api/rest/reference/events/webhook) Depois de selecionar os eventos necessários, clique **em Conectar**. As conexões são feitas e confirmadas, sua integração com Shopify está listada na aba **Integrações Configuradas** dentro do Marketplace e você recebe a página **de Detalhes da Integração** . Por fim, para iniciar a sincronização, clique na lista **de Ações** e selecione **Sincronizar**. Suas opções serão `Full sync`, `Sync profiles` e `Sync purchases`. A sincronização total inclui sincronização dos usuários e dos dados de compra. Uma vez concluído, cada atributo do perfil é exibido junto com um carimbo de data e o status de *Concluído*. Se houver algum outro status, clique no menu **Mais** e escolha **Detalhes** para informações estendidas. > [!NOTE] > Sincronização de dados de compra > > Depois de sincronizar os dados de compra, não precisa mais sincronizar esses dados. O sistema atualiza automaticamente os dados de compra com base nos detalhes dos pedidos recebidos de eventos em tempo real. ## Abandono de checkout O abandono de checkout é um dos casos de uso mais significativos abordados no escopo desta integração. Você pode criar uma [campanha desencadeada por evento](/documentation/docs/pt-br/realtime-responses-to-events#how-to-create-an-event-triggered-campaign) usando um `checkout_abandoned` evento da [aba Evento](/documentation/docs/pt-br/campaign-events) da sua campanha. > [!WARNING] > Assine os eventos de checkout > > O `checkout_abandoned` evento é alimentado por *eventos de checkout/create*, *checkout/delete* e *checkout/update* da integração com o Shopify. Você deve assinar esses eventos ao integrar antes de usar o `checkout_abandoned` evento em suas campanhas. > > Se você assinar esses eventos, o `checkout_abandoned` evento será criado automaticamente no **Data > Data Manager > Events** quando for acionado pelo Shopify. Você não precisa criar esse evento antes. Um link de abandono de checkout também pode ser adicionado ao conteúdo da campanha para aumentar sua eficácia. Você deve adicionar um `{{abandoned_checkout_url}}` no seu conteúdo onde gostaria de incluir o link de abandono de checkout que redirecionará o usuário para o checkout abandonado ao clicar nele.