---
title: "Introdução à Magento 2.x (CE e EE)"
description: "Saiba como integrar a Klaviyo com sua loja Magento 2 CE ou EE. Você precisará instalar a extensão da Klaviyo na Magento, configurar a extensão e configurar o OAuth e, em seguida, ativar a integração na Klaviyo. Este guia abrange todas as etapas de integração necessárias e como confirmar se a sincronização de dados históricos foi bem-sucedida."
canonical_url: "https://help.klaviyo.com/hc/pt-br/articles/115005254348"
markdown_url: "https://help.klaviyo.com/hc/pt-br/articles/115005254348.md"
locale: "pt-br"
category: "Integrações"
section: "Magento 2"
updated: "2026-02-25"
---

# Introdução à Magento 2.x (CE e EE)

## O que você vai aprender

Saiba como integrar a Klaviyo à sua loja Magento 2 CE ou EE. Você precisará instalar a extensão da Klaviyo no Magento, configurar a extensão e configurar o OAuth e, em seguida, ativar a integração na Klaviyo. Este guia aborda todas as etapas de integração necessárias, além de como confirmar se a sincronização dos seus dados históricos foi bem-sucedida. 

## Antes de começar

**📝 Note:** Observe que as versões do Magento 2 abaixo da versão 2.4.0 não são compatíveis.

Para garantir que a Klaviyo possa fazer as chamadas de API necessárias para a integração, seu servidor da Magento 2 deve ter um nome de host acessível ao público. Os servidores da Magento 2 hospedados localmente não poderão se integrar totalmente à Klaviyo.

É altamente recomendável adicionar IPs da Klaviyo à lista de permissões do seu provedor de firewall para minimizar problemas de autenticação e configuração. Para mais informações, consulte a [lista Como permitir a integração com a Klaviyo e os endereços IP de tráfego](https://help.klaviyo.com/hc/pt-br/articles/19143781289115.md).

A extensão Magento 2 da Klaviyo deve ser instalada via Composer. Observe que a instalação via Composer requer um administrador de TI com acesso SSH ao servidor onde o Magento 2 está hospedado. 

## Instale a extensão da Klaviyo na Magento 2

🎬 [Watch video on Wistia](https://klaviyo.wistia.com/medias/yc7dejd9jw)

1. Faça login no seu servidor da Magento 2 e navegue até o diretório raiz do seu aplicativo Magento a partir da sua ferramenta de linha de comando. Este guia mostra exemplos de saídas para o Terminal, mas essas etapas podem ser modificadas para qualquer ferramenta de linha de comando de sua escolha.

2. Execute o seguinte comando para acessar a versão mais recente da extensão do Klaviyo no Packagist. O Packagist é um repositório de bibliotecas de código PHP que permite instalar facilmente a versão mais recente da extensão.
`composer require klaviyo/magento2-extension`

3. Execute o seguinte comando para ativar a extensão do Klaviyo que você acabou de baixar:
`php bin/magento module:enable Klaviyo_Reclaim  --clear-static-content`



![composer2.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c0b9b103e993b26b8c180dcc16438a8e6077f53e-1566x262.png?auto=format)

4. Como mostrado na saída de exemplo, agora você precisa ativar todos os módulos adicionais. Execute o seguinte comando para ativá-los:
`php bin/magento setup:upgrade`

5. Examine a saída em busca de `Module 'Klaviyo_Reclaim'` para confirmar que o módulo da Klaviyo está ativado e em execução.

6. Para garantir que o CSS e o JS da sua loja Magento 2 continuem funcionando corretamente, você vai precisar executar um comando de implantação de conteúdo estático.
`php bin/magento setup:static-content:deploy -f`



![composer3.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/102ed3a25f541567742413f296e80f9fc791d02a-1562x264.png?auto=format)

7. Agora você pode retornar ao painel de administração da Magento no seu navegador.



A instalação via Composer foi concluída! Vá para a próxima seção para obter instruções de configuração.

## Configurar a extensão da Klaviyo

### Vídeo tutorial

🎬 [Watch video on Wistia](https://klaviyo.wistia.com/medias/m7vqtc4psz)

1. Na sua conta da Klaviyo, navegue até a [aba de chaves de API](https://www.klaviyo.com/settings/account/api-keys).

2. Em uma nova aba, navegue até o administrador da loja da Magento.

3. Em Configurações, clique **em Lojas** **>** Configuração.

4. No menu suspenso da Klaviyo, clique em **Geral**.

5. Defina **Ativar extensão do Klaviyo** como **Sim**.

6. Copie a chave de API pública do Klaviyo (ID do site) na guia chaves de API e cole-a na caixa correspondente no Magento.

7. Na guia chaves de API do Klaviyo, [crie uma nova chave de API privada](https://help.klaviyo.com/hc/pt-br/articles/7423954176283.md) e copie-a para a caixa correspondente no Magento. A autenticação com sua chave de API privada permite que você sincronize as inscrições na newsletter do Magento com a Klaviyo.



Na próxima seção, você vai configurar o OAuth, que habilitará outros aspectos da integração.

![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/b6c04a8983befb3b4de367ec9f1043a954b73e09-1560x698.png?auto=format)

### Configurar o OAuth

Em seguida, você habilitará a autenticação OAuth para conectar com segurança sua conta Klaviyo à extensão da Magento 2. 

1. Navegue até a aba **Configurar OAuth** na Magento.

2. Dê um nome memorável à sua integração, pois você precisará localizá-la com esse nome mais tarde.

3. Clique em **Salvar configuração** para prosseguir.




![OAUTHtab.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/43febae7f999918b764c73d3375b6a79fa32e513-1926x614.png?auto=format)

4. Localize **Sistema** no painel de navegação à esquerda e selecione **Integrações** na bandeja *Sistema*.

5. Localize o nome da sua integração e clique em **Ativar**. A ativação da integração abrirá uma janela solicitando que você aprove o acesso.




![activateoauth.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/0742e1a5f6f5de9b7312177c2c9ff49996a513d1-1892x312.png?auto=format)

6. Clique em **Permitir** para ser redirecionado para a Klaviyo, onde você concluirá a configuração da integração.




![oauthperms.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/dfed353d025ccc34ae79aa263fd80a93b084a244-2518x842.png?auto=format)

7. Faça login na Klaviyo se solicitado ou confirme se o nome da sua conta está correto e clique em **Integrar.** Isso adicionará a integração da Magento 2 à conta Klaviyo associada à chave de API usada para a configuração. Se estiver conectado a várias contas Klaviyo e a conta correta não estiver sendo exibida, desconecte-se de qualquer outra sessão.




![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/9e556b43ab190092403ac9d6fa0262cbbbd45d67-1106x492.png?auto=format)

Se a janela fechar automaticamente, a conexão foi bem-sucedida. Você também pode confirmar o sucesso abrindo sua conta Klaviyo em uma nova aba ou janela do navegador, selecionando a aba **Integrações** e procurando a Magento 2 na lista.

Se você vir o erro “A conta Klaviyo não corresponde à ID da empresa”, verifique se as chaves de API que você inseriu no Magento pertencem à conta Klaviyo em que você está conectado no momento e tente novamente.

![apierror.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/3a8c5fe6e74f9c85769e0732311851549af7fc97-1400x458.png?auto=format)

Ao estabelecer a conexão entre a Magento e a Klaviyo, se você receber uma lista de erros, poderá clicar em cada erro para saber mais sobre a causa.

![oauthgenerror.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c83829dcbc34ed3b6d90f4d8245da142cb7b5b71-1450x850.png?auto=format)

### Definir uma lista de newsletter

Em seguida, você selecionará uma lista da Klaviyo para sincronizar seus assinantes de newsletter. Você também tem a opção de usar as configurações de inscrição da Klaviyo ou as configurações de inscrição da Magento 2 para sua lista escolhida.

1. Na Magento, clique em **Newsletter**.

2. Selecione a lista da Klaviyo para a qual deseja sincronizar o formulário de registro da Magento no menu suspenso.

3. Clique em **Salvar configuração**.



![newsletterm2.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/a12fc2f088bd9e1c1357c0c460fe24d435f497b8-2598x1040.png?auto=format)

### Habilitar consentimento no checkout

Você pode coletar consentimento no checkout para e-mail e para canais móveis (SMS, WhatsApp ou ambos).

Observe que, se você habilitar o consentimento no checkout, também precisará habilitar os webhooks (abaixo) para que o consentimento no checkout funcione corretamente. 

1. Na página *Configuration*, em *Klaviyo*, navegue até **Consent at Checkout**.




![m2cac-new.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c64fbdf2d6bdac7f722908c4a387d2e0778cc0fa-2070x736.png?auto=format)

2. Você verá uma seção para coletar consentimento para e-mail e consentimento para celular (SMS/WhatsApp). Os dois são tratados separadamente, para que você possa coletar apenas e-mail, apenas SMS/WhatsApp ou ambos. Se você reunir assinantes de SMS/WhatsApp e e-mail, escolha uma lista diferente para SMS/WhatsApp e e-mail. Isso garante que o consentimento seja sempre atribuído corretamente ao canal correto.

   - O consentimento não será sincronizado (para e-mail e SMS/WhatsApp) até que o cliente conclua o pedido e, se aplicável, confirme a inscrição devido à inscrição em duas etapas.

   - Observe que, para usuários que já estão conectados à sua loja Magento 2, a caixa de consentimento de e-mail não aparecerá no checkout por padrão.

3. Em *E-mail*, selecione **Sim** para *Inscrever contatos em marketing por e-mail no checkout*.

4. Selecione uma lista de e-mails para sincronizar os assinantes, como uma newsletter.

5. Digite o texto da caixa de seleção de consentimento para e-mail que deseja usar.




![2021-03-24_13-00-56.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/15ee0f77e8e9eb576484dcd38981c420d8905384-1424x612.png?auto=format)

6. Em *Celular*, selecione **Sim** para *Coletar assinantes de mensagens de texto e WhatsApp*.

7. Escolha a lista para a qual você quer sincronizar seus contatos de SMS/WhatsApp. Para mais detalhes sobre essas configurações, confira nosso guia sobre [como coletar consentimento para SMS e/ou WhatsApp no checkout](https://help.klaviyo.com/hc/pt-br/articles/360058698511.md).




![Uma página de configurações para celulares para coletar consentimento para mensagens de texto e WhatsApp, com opções para canais, listas de assinantes e texto de consentimento.](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/179c6fdbf1d9f96b559e1a2a1a1f282dea85126b-946x978.png?auto=format)

8. A ordem de classificação permite que você altere o posicionamento das caixas de consentimento de e-mail e SMS. Por padrão, essas caixas aparecem no primeiro campo de entrada de e-mail e número de telefone de envio, respectivamente. Portanto, se você não reorganizou a página de checkout, não precisará alterar a ordem de classificação. Se você alterou o layout, ajuste a ordem de classificação de acordo.

9. Quando terminar, clique em **Salvar configuração** no canto superior direito.



### Habilitar webhooks

**📝 Note:** Em seguida, você habilitará os webhooks da Klaviyo na sua conta da Magento 2. Observe que a ativação de webhooks é necessária para que o consentimento no checkout funcione corretamente.

1. No painel de administração, navegue até **Lojas > Configuração**.

2. Clique na **Klaviyo** e selecione a aba **Webhooks**.

3. Crie um segredo de webhook e insira-o no campo **Segredo de webhook** correspondente. O segredo do webhook é uma chave que a Klaviyo usará para validação. Esse segredo pode ser qualquer coisa que você escolher, mas recomendamos criar uma sequência segura de letras e números. A Magento ocultará seu segredo de webhook com asteriscos por motivos de segurança, portanto, tenha cuidado para inseri-lo corretamente.

Se estiver usando uma integração de várias lojas, o segredo do webhook nesse campo deverá ser inserido em sua configuração padrão, e o mesmo segredo será usado como validação para cada configuração de loja. O segredo do webhook só deve ser adicionado à configuração padrão e não deve ser adicionado por loja.



![m2webhooktab.png](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/bd7ba0d0018c75d8d27d5e6a6a6df87ee174c8b8-2610x1084.png?auto=format)

4. Ao lado dos webhooks que você quer ativar, selecione **Sim** no menu suspenso. Para saber mais sobre os webhooks compatíveis com a Klaviyo, confira nosso [guia de webhooks para Magento 2](https://help.klaviyo.com/hc/pt-br/articles/360055336451.md).

5. Clique em **Salvar configuração**.



## Habilitar a integração da Magento 2 na Klaviyo

### Vídeo tutorial

🎬 [Watch video on Wistia](https://klaviyo.wistia.com/medias/evlfi7fbya)

1. Abra a Klaviyo e selecione **Integrações** na navegação à esquerda. Localize o Magento 2 na lista e selecione-o.

2. Na próxima página, você pode optar por adicionar clientes do Magento 2 a uma lista da Klaviyo. Selecione **Adicionar novos clientes da Magento 2 a uma lista da Klaviyo** e selecione uma lista no menu suspenso. Adicionar um cliente a uma lista não concede, por si só, consentimento de marketing. Use as configurações de consentimento da newsletter e do checkout no Magento para coletar esse consentimento.

Os perfis de clientes existentes são incluídos na sincronização de dados históricos. Para fazer upload de assinantes existentes da newsletter a partir de um CSV, siga o guia de [upload de assinantes existentes do Magento 2 para uma lista da Klaviyo](https://help.klaviyo.com/hc/pt-br/articles/115005082407.md).



![Página de configurações de integração da Magento 2 e Klaviyo com opções de sincronização de dados, visualizações da loja e recursos avançados.](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/c03434d8b88d70812b062012c3e31ec7bf1715c7-686x983.png?auto=format)

3. Em seguida, selecione quais visualizações da loja do Magento 2 você gostaria de sincronizar com a Klaviyo. Por padrão, todas as visualizações da loja são sincronizadas com a Klaviyo. Essa configuração permite que você seja seletivo quanto às lojas com as quais integra. Se você estiver usando o Multi-Source Inventory (MSI) no Magento 2, selecione *Visualizações específicas da loja do Magento 2* e selecione as lojas que você deseja sincronizar para ver seu inventário representado corretamente na Klaviyo.

4. Em **Avançado**, configure as seguintes configurações conforme necessário:

   - **Configurações de preço especial**
Essa configuração se refere a um preço promocional especial para itens que, opcionalmente, pode entrar em vigor em um determinado intervalo de datas. Ative isso antes da sua primeira sincronização de catálogo se você pretende usar preços especiais. Se você ativar isso mais tarde, [sincronize novamente seu catálogo](#h_01JYSCX35A6AA1XSG38E9YDBQ2) para atualizar os produtos existentes. Quando você ativa **Usar preço especial para os preços do produto quando aplicável**, o bloco de produto exibirá o preço especial quando aplicável. Ao usar um feed de produtos dinâmico, o preço especial será preenchido no horário de envio. Ao selecionar itens manualmente no seu catálogo, o preço especial será preenchido assim que você selecionar o(s) produto(s). Para cada produto, há 4 campos de metadados que serão sincronizados:

     - **preço**
(Obrigatório, flutuante) O preço padrão do item.

     - **preço_especial**
(Opcional, flutuante) Este é um preço de venda especial para o item. Quando esse preço estiver em vigor, você verá esse special_price ao lado de um strikethrough do preço.

     - **special_from_date** 
(Opcional, data) Especifica uma data inicial para o special_price entrar em vigor.

     - **special_to_date** 
(Opcional, data) Especifica uma data final para o special_price em vigor.

   - **URL raiz de mídia**
Para alterar o caminho padrão das imagens do seu site, selecione **Alterar URL raiz de mídia** e insira a URL raiz de mídia. Use essa configuração se suas imagens estiverem hospedadas em uma URL diferente do seu site. 

   - **Limitar a Sincronização Periódica de Pedidos a pedidos recentes**
As sincronizações periódicas de pedidos identificam os pedidos que foram atualizados desde a sincronização periódica anterior e os incluem na próxima sincronização. Essa configuração permite limitar quais pedidos são elegíveis para sincronizações periódicas de pedidos com base em quando o pedido foi criado. Quando habilitado, você pode selecionar um intervalo de datas relativo, e somente as ordens atualizadas criadas dentro desse período serão incluídas na próxima sincronização periódica da ordem. Isso evita que pedidos mais antigos sejam recuperados durante sincronizações periódicas quando ocorrem atualizações não significativas nesses pedidos.

5. Clique em **Concluir configuração**.



Sua integração com o Magento 2 agora está ativada, e a sincronização dos seus dados históricos foi iniciada.

Quando a sincronização inicial de dados históricos for concluída, a integração da Magento 2 será sincronizada a cada 30 minutos.

### Confirme a sincronização dos seus dados históricos

1. No Klaviyo, selecione **integrações** e, em seguida, abra sua integração do Magento 2.

2. Selecione a aba **Dados**.

3. Revise a seção de **dados históricos**. Enquanto a importação estiver em andamento, ela mostrará o progresso da sincronização. Quando a importação terminar, a seção confirma que seus pedidos, clientes e produtos históricos foram sincronizados e mostra uma data **Sincronizado pela última vez em**.



## Dados sincronizados com a integração da Magento 2

A integração da Klaviyo com o Magento 2 extrai informações importantes dos clientes de sua plataforma Magento.

Aqui estão alguns dos dados que sincronizamos da Magento:

- Informações do cliente, incluindo nome, sobrenome e localização.

- Dados de vendas e pedidos, incluindo itens comprados, imagens de itens, categorias de itens e descontos aplicados.

- Dados de atendimento, reembolso e cancelamento de pedidos.

- Quando as pessoas visitam seu site e quais itens visualizam; o rastreamento web é tratado pela extensão.



Para saber mais, acesse nossa [referência de dados do Magento 2](https://help.klaviyo.com/hc/pt-br/articles/115003458852.md). 

## Converter valores de pedidos da Magento em uma única moeda

O Klaviyo oferece suporte à conversão de todas as moedas estrangeiras no Magento para uma moeda principal no Klaviyo. Entre [em contato com](https://help.klaviyo.com/hc/pt-br/articles/115001002272.md) o suporte para ativar esse recurso. Isso é especialmente útil se você tiver várias lojas com transações em moedas diferentes.

Quando esse recurso estiver habilitado:

- A conversão acontece quando a Magento sincroniza os dados do pedido com a Klaviyo. 

- A Klaviyo verificará se o *order_currency_code* é o mesmo que o set *global_currency_code*. Caso contrário, a Klaviyo converterá o total do pedido da moeda do pedido para a moeda global especificada para garantir que suas análises financeiras estejam precisas. Observe que os itens da linha da ordem permanecerão no código da moeda da ordem e não serão convertidos. 



## Atualize sua extensão

Para atualizar sua extensão do Klaviyo para Magento 2, repita as etapas em [Instalar a extensão do Klaviyo no Magento 2](#h_01HGGJNFJT8CTEQ8PVGDVNB6GB) acima, incluindo os comandos de atualização do Magento e de implantação de conteúdo estático. Essas etapas substituem a versão atual da sua extensão. Você não precisa reconfigurar a extensão nem reativar a integração no Klaviyo.

## Sincronizar novamente seu catálogo

Você pode solicitar uma nova sincronização histórica completa do seu catálogo do Magento 2 a qualquer momento. Sincronizar seu catálogo novamente pode ajudar você a aproveitar as atualizações do Klaviyo para o inventário e recursos relacionados a variantes. Sincronize seu catálogo novamente após alterar as configurações de sincronização do catálogo para aplicar essas alterações aos produtos existentes.

Para sincronizar novamente seu catálogo:

1. Na Klaviyo, selecione a aba **Integrações**.

2. Selecione sua integração com a Magento 2 na lista.

3. Clique na aba **Dados**.

4. Em **Sincronizar dados do catálogo**, clique em **Sincronizar novamente**.





![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/53b866961db9078dc95f5a9b82cf77b8460cef17-1318x214.png?auto=format)

Confira o **Progresso da sincronização** na mesma seção enquanto a ressincronização é executada. Quando ela terminar, a seção mostra uma data de **Última sincronização em**.

## Recursos adicionais

- [Referência de dados do Magento 2](https://help.klaviyo.com/hc/pt-br/articles/115003458852.md)
  Saiba quais dados a Klaviyo importa da sua loja Magento 2 quando você integra as duas plataformas. A integração da Klaviyo com o Magento 2 importa todos os dados históricos da sua loja Magento 2 com a sincronização histórica inicial. Depois de ativada, a integração também começará a sincronizar os dados de pedidos e clientes a cada 30 minutos. Exemplos desses dados incluem as informações associadas a pedidos feitos no passado, pedidos atendidos etc.
- [Klaviyo Community: Magento 2 "Ask Me Anything" Question and Answer Video](https://community.klaviyo.com/integrations-39/ama-magento2-updated-with-video-response-5450)
