Integração com Magento

Necessária a ajuda de um desenvolvedor

Você precisará da ajuda de sua equipe de desenvolvimento para configurar a integração. Por favor, compartilhe este guia com eles.

Visão geral da integração

Magento é uma plataforma líder de e-commerce que ajuda empresas a gerenciar produtos, clientes e pedidos em escala. Ao integrar o Magento com a Pushwoosh, você pode sincronizar automaticamente clientes, pedidos e carrinhos abandonados para permitir mensagens em tempo real, segmentação direcionada e automação de marketing multicanal, ajudando você a engajar usuários e aumentar as conversões diretamente da atividade da sua loja.

Tipo de integração

Destino: Esta integração envia dados da sua loja Magento para a Pushwoosh.

Pré-requisitos

Antes de prosseguir, certifique-se do seguinte:

• Acesso ao Painel de Administração do Magento

• Uma conta Pushwoosh válida

• Seu token de acesso à API e código do aplicativo da Pushwoosh

• Composer instalado no seu servidor Magento

• Requisitos de sistema atendidos:

  • PHP 7.4 / 8.x
  • Magento 2.3 / 2.4
  • Elasticsearch 7
  • RabbitMQ

Glossário

Mapeamento de nomes de entidades se forem diferentes:

Magento	Pushwoosh
Cliente	Usuário

Lista de entidades sincronizadas:

• Clientes
• Pedidos
• Carrinhos abandonados

Casos de uso

• Envie notificações push com base em eventos de criação de pedidos e abandono de carrinho.

• Segmente clientes com base em atributos (por exemplo, localização, aniversário) e envie campanhas direcionadas.

• Envie notificações promocionais baseadas no navegador.

Configurar a integração

Instalação

Nota

Para instalar a integração Pushwoosh, certifique-se de ter o Composer instalado.

1. Execute o seguinte comando do Composer na raiz do seu projeto Magento:

composer require pushwoosh/magento2-integration

2. Assim que o pacote for instalado, execute a configuração do Magento para instalar o módulo:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Configuração pós-instalação

Após concluir a instalação:

1. Faça login no painel de Administração do Magento.

2. Navegue para Stores > Configuration > Pushwoosh > Configuration.

Configurações gerais

Na seção General, configure os seguintes campos:

• Status: Defina como Enable para ativar a integração.
• API URL: Insira o endpoint da API da Pushwoosh: https://api.pushwoosh.com/
• API Key: Cole sua Chave de API da Pushwoosh necessária para autenticar as solicitações. Saiba mais sobre a chave de acesso da API da Pushwoosh
• App Code: Insira o Código do Aplicativo Pushwoosh correspondente ao seu aplicativo móvel ou web.

Abaixo estão as opções de configuração disponíveis para sincronizar clientes, pedidos e carrinhos abandonados.

Configuração de sincronização de pedidos

Defina como os dados dos pedidos são sincronizados entre sua loja Magento e a Pushwoosh.

Preencha os seguintes campos:

Order Sync Enable	Defina como Yes para ativar a sincronização automática de pedidos. Se ativado, o processo seguirá o agendamento cron definido. Defina como No para desativar a sincronização automática.
Cron Settings	Disponível apenas se a Sincronização de Pedidos estiver ativada. Defina quando o trabalho cron deve ser executado usando os seguintes campos: Minute, Hour, Day, Month, Weekday. Cron é um agendador baseado em tempo usado para executar tarefas automaticamente em intervalos especificados.
Order Sync Numbers	Especifique quantos pedidos processar durante cada execução de sincronização.
Order Sync in Real Time	Defina como Yes para sincronizar pedidos imediatamente após a sua realização.

Aqui você também pode ver o status da sincronização de pedidos:

• Total Orders: Exibe o número total de pedidos avaliados para sincronização.
• Synced Orders: Número de pedidos sincronizados com sucesso com a Pushwoosh.
• Not Synced Orders: Pedidos que ainda não foram sincronizados.
• Fail Synced Orders: Pedidos para os quais as tentativas de sincronização falharam.

Configuração de sincronização de carrinhos abandonados

Configure a sincronização de dados de carrinhos de compras abandonados entre sua loja Magento e a Pushwoosh.

Preencha os seguintes campos:

Abandoned Cart Syncing	Defina como Yes para ativar a sincronização automática de dados de carrinhos abandonados. Se ativado, a sincronização é executada de acordo com o agendamento cron definido.
Cron Schedule Configuration	Defina quando a sincronização deve ser executada usando os seguintes campos: Minute, Hour, Day, Month, Weekday. Cron é um agendador de tarefas baseado em tempo que executa tarefas automaticamente em intervalos especificados.
Number of Abandoned Cart	Especifique quantos carrinhos abandonados serão processados durante cada execução de sincronização.
Minimum Inactivity Time	Defina o tempo mínimo de inatividade (em minutos) para que um carrinho seja considerado abandonado. Por exemplo, 60 significa que carrinhos inativos por pelo menos 60 minutos serão elegíveis para sincronização.

Aqui você também pode ver métricas em tempo real sobre a atividade de sincronização:

• Total Abandoned Carts: Número total de carrinhos identificados como abandonados.
• Synced Abandoned Carts: Número de carrinhos sincronizados com sucesso com a Pushwoosh.
• Not Synced Abandoned Carts: Número de carrinhos que ainda não foram sincronizados.
• Fail Synced Abandoned Carts: Número de carrinhos para os quais a sincronização falhou.

Configuração de sincronização de clientes

Configure a sincronização de dados de clientes da sua loja Magento para a Pushwoosh para permitir a segmentação de público e mensagens personalizadas com base nos atributos do cliente.

Preencha os seguintes campos:

Customer Syncing	Defina como Yes para ativar a sincronização de todos os registros de clientes existentes e novos. A sincronização seguirá o agendamento cron definido e usará os mapeamentos de atributos especificados.
Cron Schedule Configuration	Defina quando a sincronização deve ser executada usando os seguintes campos: Minute, Hour, Day, Month, Weekday. Cron é um agendador de tarefas baseado em tempo que executa tarefas automaticamente em intervalos especificados.
Mapping Customer Custom Fields	Mapeie os atributos de cliente do Magento para os campos personalizados da Pushwoosh para uma transferência de dados precisa. Exemplos: Date of Birth → Birthday, First Name → firstName
Number of Customers	Defina o número máximo de clientes a serem sincronizados por execução do cron.

Aqui você também pode ver as estatísticas de sincronização:

• Total Customer: Número total de registros de clientes identificados para sincronização.
• Synced Customer: Número de clientes sincronizados com sucesso com a Pushwoosh.
• Not Synced Customer: Clientes pendentes de sincronização.
• Fail Synced Customer: Clientes que falharam na sincronização devido a erros.

Configuração de notificações web

Defina como Yes para ativar as notificações push da web para os visitantes da sua loja. Defina como No para desativar esta funcionalidade.

Quando ativada, sua loja Magento pode enviar mensagens em tempo real para os usuários através do navegador deles. As notificações podem ser usadas para ofertas promocionais, atualizações de status de pedidos, lembretes de carrinhos abandonados e outras comunicações de marketing.

Salvar configuração

Assim que todos os campos obrigatórios forem preenchidos, clique no botão Save Config localizado no canto superior direito. Limpe o cache do Magento se solicitado para aplicar as alterações.

Opções de sincronização manual

Sincronizar clientes selecionados para a Pushwoosh

Se você preferir não sincronizar todos os clientes automaticamente, pode sincronizar manualmente clientes individuais ou selecionados.

1. No Painel de Administração do Magento, navegue para Customers > All Customers.
2. Localize e selecione o(s) cliente(s) que deseja sincronizar.
3. No menu suspenso Actions acima da lista de clientes, escolha Sync to Pushwoosh.

Assim que a sincronização for concluída, os dados do cliente aparecerão na seção User Explorer da sua conta Pushwoosh, com todas as informações relevantes transferidas do Magento.

Sincronizar pedidos selecionados para a Pushwoosh

Se você preferir não sincronizar todos os pedidos automaticamente, pode sincronizar manualmente pedidos específicos. Para isso:

1. No Painel de Administração do Magento, navegue para Sales > Orders.

2. Selecione um ou mais pedidos da lista.

3. No menu suspenso Actions, escolha Sync to Pushwoosh.

Após a sincronização, o pedido aparecerá na seção Eventos do perfil do usuário no User Explorer da Pushwoosh como um evento PW_OrderCreated ou PW_OrderUpdated (se o status do pedido tiver mudado), incluindo informações detalhadas do pedido.

Sincronizar carrinhos abandonados selecionados

Para sincronizar manualmente carrinhos abandonados selecionados:

1. No Painel de Administração do Magento, vá para a seção Abandoned Carts.
2. Selecione o carrinho que deseja sincronizar.
3. No menu suspenso Actions, escolha Sync to Pushwoosh.

Nota: Certifique-se de ter configurado o período de inatividade necessário nas configurações de Abandoned Cart Sync para determinar quando um carrinho é considerado abandonado.

Após a sincronização, os dados do carrinho abandonado aparecerão na seção Events do perfil do usuário no User Explorer da Pushwoosh como um evento PW_AbandonedCart com informações detalhadas.

Além disso, duas tags serão definidas no perfil do usuário:

• Abandoned Cart Date → PW_AbandonedCartDate
• Abandoned Cart ID → PW_AbandonedCartID

Essas tags podem ser usadas para enviar lembretes de carrinho abandonado usando conteúdo conectado em seus modelos de e-mail. Saiba mais

Verificar se a integração está funcionando

Para confirmar que a integração está funcionando corretamente:

1. Crie um cliente de teste no Magento.
2. Sincronize manualmente o cliente para a Pushwoosh.
3. Abra o User Explorer no seu painel da Pushwoosh e encontre o cliente.

Se o cliente aparecer no User Explorer, isso indica que a sincronização foi bem-sucedida.