--- title: "Magento 2" slug: "magento-2" updated: 2026-06-12T10:30:48Z published: 2026-06-12T10:30:48Z canonical: "docs.xtremepush.com/magento-2" --- > ## 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. # Magento 2 Integre o Magento 2 para sincronizar usuários e dados com o Xtremepush A Integração Magento 2 permite que você sincronize automaticamente os dados do Magento 2, execute campanhas personalizadas de marketing de comércio eletrônico e as analise. Este guia demonstra como integrar e coletar dados com sucesso do Magento. ## Instale a extensão Xtremepush no Magento 2 Como primeiro passo da integração, a extensão Xtremepush precisa ser instalada no Magento 2. > [!NOTE] > Suporte técnico necessário > > A extensão Xtremepush pode ser instalada via compositor. Ele exige suporte de TI com acesso SSH ao servidor onde o Magento 2 foi hospedado. Para instalar a extensão Xtremepush, quatro passos principais precisam ser tomados: 1. Faça login no seu servidor Magento 2 e navegue até o diretório raiz do seu app Magento a partir da sua ferramenta de linha de comando. Este guia mostra exemplos de saídas para o Terminal, mas esses passos podem ser modificados para qualquer ferramenta de linha de comando de sua escolha. 2. O módulo é instalado via Composer. Primeiro, certifique-se de que suas dependências atuais estejam atualizadas: ```powershell composer update ``` 3. Depois, execute este comando para adicionar o módulo Xtremepush ao seu ambiente Magento: ```powershell composer require xtremepush/magento2-plugin ``` 4. Após a atualização, você deve realizar a regeneração do código e reiniciar os serviços: ```powershell sudo php -d memory_limit=-1 bin/magento setup:upgrade sudo php -d memory_limit=-1 bin/magento setup:di:compile sudo php -d memory_limit=-1 bin/magento setup:static-content:deploy -f ``` Após implantar o conteúdo estático, reinicie os serviços. ## Criar integração no Magento 2 Faça login na sua conta Magento e navegue até **Integrações > Sistema > Adicionar Nova Integração**. Preencha os detalhes da integração digitando um nome descritivo e senha, depois navegue até **a API** (em Configurações Básicas) para atribuir as permissões de nível relevantes. > [!NOTE] > Permissões necessárias > > Você precisará conceder as seguintes permissões de usuário: > > - **Extensões > Integrações de Sistema > Sistema** > - **Marketing > Comunicação > Assinantes de Newsletters** > - **Vendas > Operações > Pedidos > Ações > Visualização** > - **Clientes** Clique em **Salvar** após definir as permissões. Neste momento, o Magento gerará seu **Access Token** que você precisará usar na plataforma Xtremepush para completar sua integração. Você pode encontrá-lo em **Detalhes de Integração**. ## Integração completa no Xtremepush Depois de completar os passos acima em Magento 2, abra uma nova aba no seu navegador e faça login na sua conta Xtremepush. Navegue até **Integrações > Marketplace**, selecione o cartão **Magento** na aba **Integration Marketplace** e clique **em Conectar**. Preencha as seções **de Conexão** e **Mapeamento de Dados** para completar a integração. ### Conecte o Magento Nesta página, 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 - *Access Token*: Encontrado no Magento navegando para **System > Integrations > integração Xtremepush** em uma seção chamada **Access Token**. - **URL da loja**: Como `https://my-shop.com/`. Após completar os detalhes da conexão, clique no botão **Buscar Atributos Magento** . Ele automaticamente gerará uma seção de mapeamento de dados para atributos assim que as credenciais de integração forem confirmadas. ### Mapeamento de dados Esta seção lista seus atributos do sistema mapeados automaticamente. Ele permite que você selecione qual atributo padrão deseja importar. Você também pode mapear seus atributos personalizados do Magento para seus atributos personalizados no Xtremepush. Os atributos do sistema do Xtremepush, como `user_id` e `email` – serão automaticamente mapeados para Magento `id` e `email` atributos (listados nos **campos Coluna** ). Você pode definir os atributos padrão do Magento para **Importar** ou **Não Importar** nos campos **Mapa** . Se você selecionar **Importar**, essas opções serão criadas automaticamente no Xtremepush. Por fim, você também verá os atributos personalizados do Magento (listados nos campos **da Colunha** ) como `gender` , `default_billing` e `default_shipping`. Você pode mapear esses atributos para seus atributos personalizados Xtremepush predefinidos. > [!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 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. > [!NOTE] > Dados de assinatura por e-mail > > Para coletar dados de assinaturas de e-mail, você precisa mapear o atributo do `is_subscribed` Magento ao atributo do `email_subscription` Xtremepush. Depois de concluir o mapeamento de dados, clique em **Conectar** para concluir a integração. ## Assine os webhooks Depois de completar os passos acima no Xtremepush, pelo seu painel do Magento, navegue até o **Xtremepush > Configurações > Geral**, verifique as configurações de integração e então ative a integração. Após ativar sua integração com sucesso, navegue até **o General > Webhooks** e permita que os webhooks extraiam eventos em tempo real do Magento para o Xtremepush. Você pode ativar o checkout (cotações), eventos relacionados ao cliente e pedidos. Quando você ativa um webhook, poderá usar seus eventos nas suas campanhas, pois eles serão automaticamente criados como eventos personalizados na plataforma Xtremepush quando esse evento for acionado pelo Magento. Esses eventos podem ser usados quando você cria [campanhas desencadeadas por eventos](/documentation/docs/pt-br/realtime-responses-to-events). Você também pode usá-los dentro [da segmentação](/documentation/docs/pt-br/segmentation-app-usage#event-with-value), por exemplo, para e-mails [de abandono ou](/documentation/docs/pt-br/automated-drop-off-recovery) boas-vindas para compradores de primeira viagem. > [!NOTE] > Os eventos usarão o nome deles de Magento 2. Por exemplo;`customer/order/created`, `customer/quote/updated`, `customer/customer/registered` etc. Você pode verificar a nomeação dos eventos disponíveis nesta página. Depois de selecionar os webhooks necessários, clique **em Salvar Configuração**. Uma vez feitas e confirmadas as conexões, sua integração com o Magento será listada na **aba Integrações Configuradas** dentro do Marketplace e você receberá a página **de Detalhes da Integração** . Por fim, para iniciar a sincronização, clique no menu **suspenso Ações** e selecione **Sincronizar**. Suas opções serão **Sincronização Total**, **Sincronizar perfis** e **Compras por Sincronização**. Uma sincronização completa inclui sincronização dos usuários (que será criada no Xtremepush) e 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 dos 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. ## Revise a integração Navegue até **Configurações > Integrações > Marketplace > Integrações Configuradas** e clique em **Magento** para revisar os detalhes da integração (**Visão Geral**). A seção *de Informações* mostra o token e o endpoint. Essas informações são automaticamente passadas para o Magento, mas também podem ser confirmadas nesta página para manchetes de segurança. A seção *Histórico de Sincronização* oferece uma visão geral do histórico de sincronização com o Magento. ## Atualize ou exclua uma conexão existente Selecione a integração que deseja atualizar em **Configurações > Integrações > Marketplace > Integrações Configuradas**. Vá até a **aba Configurações** e atualize qualquer configuração necessária, clique **em Salvar** para confirmar. Se precisar deletar ou desativar a conexão, clique no **botão Ações** . Você terá a opção de **desativar** ou **excluir** a integração. Clicar em qualquer um deles abre uma janela de confirmação.