Solução de problemas da sua integração com o Magento 2

O que você vai aprender

Saiba como resolver problemas com sua configuração de OAuth do Magento 2 seguindo as etapas de solução de problemas descritas abaixo. Se você ainda estiver enfrentando problemas depois de seguir estas etapas, entre em contato na nossa Community ou com nossa equipe de suporte.

Antes de começar

Se você ainda não fez isso, leia nosso Guia de introdução sobre Primeiros passos com o Magento 2 para ver instruções passo a passo para configurar sua integração com o Magento 2.

A Klaviyo usa o protocolo OAuth para gerar um token de acesso e recuperar dados da sua loja Magento 2. Se você personalizou a instalação do Magento 2, isso pode fazer com que o procedimento de OAuth da Klaviyo falhe. Este artigo vai orientar você por uma série de etapas de solução de problemas para identificar onde a falha está ocorrendo.

Etapas gerais de solução de problemas

Garanta que seu site esteja acessível publicamente com um certificado SSL válido

O procedimento OAuth da Klaviyo exige que seu site esteja acessível publicamente, caso contrário as chamadas de API necessárias para gerar os tokens de acesso falharão.

1. Verifique se você não protegeu sua loja com senha nem restringiu o acesso por IP.
2. Garanta que sua loja esteja acessível via HTTPS com um certificado SSL válido. Você pode testar seu certificado aqui.

Verifique se o firewall não está bloqueando as solicitações do Klaviyo

Todo o tráfego de integrações de saída da Klaviyo fica atrás de um conjunto de endereços IP previsíveis e estáticos, para que você tenha um alto nível de confiança de que esse tráfego vem da Klaviyo. Leia nosso artigo para saber como adicionar os endereços IP de tráfego de integrações da Klaviyo à lista de permissões.

Verifique as versões do Magento 2 e da extensão do Klaviyo

1. Se você estiver usando o Magento v2.2.0, será necessário habilitar manualmente o OAuth.
2. Certifique-se de que você instalou a extensão correta da Klaviyo (talvez seja necessário atualizar).

Garanta que os pontos de extremidade de OAuth estejam acessíveis

Você pode ter regras de reescrita extras ou ausentes, o que pode tornar os pontos de extremidade padrão do OAuth do Magento 2 inacessíveis. O Klaviyo precisa acessar esses pontos de extremidade para gerar as credenciais necessárias para o processo de autorização.

Garanta que as URLs abaixo estejam acessíveis para a sua loja:

https://[Store URL]/oauth/token/request

https://[Store URL]/oauth/token/access

1. Você pode validar que eles estão acessíveis fazendo uma solicitação POST como esta:

curl --location --url 'https://[Store URL]/oauth/token/request' --request 'POST' -v

curl --location --url 'https://[Store URL]/oauth/token/access' --request 'POST' -v

1. Você deve esperar uma resposta semelhante à seguinte. É normal ver um erro ao fazer uma solicitação dessa forma, e isso valida que os pontos de extremidade estão respondendo corretamente.
   

2. Se você não receber uma resposta relacionada ao OAuth, verifique se não há redirecionamentos, regras de reescrita inválidas ou erros internos do servidor impedindo o acesso a esses URLs.

Isso pode ser causado por um subcaminho da loja no seu URL. Teste se há um problema com subcaminho da loja acessando os pontos de extremidade em:

https://[Store URL]/[Store Path]/oauth/token/request

https://[Store URL]/[Store Path]/oauth/token/access

Se esses pontos de extremidade forem resolvidos, inclua as regras de reescrita abaixo no seu .htaccess arquivo para resolver o problema.

RewriteEngine on
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[Store Path]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[Store Path]/oauth/token/access [L,R=301]

Exclua a integração e crie-a novamente

Se você fez alterações depois de uma tentativa anterior de integrações malsucedida, é uma boa ideia excluir a integração OAuth original. As chaves usadas podem ser inválidas e precisarão ser geradas novamente.

1. No Magento, navegue até Sistemas
2. Select integrações
3. Localize o registro de integração do Klaviyo e exclua-o

Depois que o registro de integrações for excluído, siga as etapas do nosso guia como integrar com o Magento 2 para criar um novo registro de integrações e tentar novamente.

Problemas específicos da versão do Magento

Falha específica do Magento 2.4.2

Se você estiver usando o Magento 2.4.2, há um problema conhecido em que as ativações de OAuth falham. Ao ativar a integração, você pode ver uma mensagem de erro como a mostrada abaixo. Mesmo que você não receba o erro, a ativação de OAuth pode ter falhado. Normalmente, o erro pode ser encontrado nos seus logs do Magento.

Para resolver esse erro, você precisará fazer um dos seguintes:

• Faça upgrade para o Magento 2.4.3. Veja a documentação do Magento 2 para fazer upgrade da sua versão.
• Aplique um patch conforme descrito no repositório do GitHub da Klaviyo para Magento 2.

Falha de autenticação específica do Magento 2.4.6

Você está no Magento 2.4.6 e está enfrentando um erro de autenticação 401 após integrar com a Klaviyo? Isso pode ocorrer devido a um bug conhecido do Magento que afeta a versão 2.4.6 do Magento. Para resolver isso, você vai precisar ativar a autenticação por bearer token para que a Klaviyo possa fazer solicitações usando esse método (em vez de OAuth 1.0). Para ativar a autenticação por bearer token:

1. No admin do Magento, vá até Lojas > Configuração > Serviços > OAuth > Configurações do consumidor.
2. Para a configuração Permitir que tokens de acesso OAuth sejam usados como tokens Bearer independentes, selecione Sim.
3. Clique em Salvar config.
   

Depois de fazer essa atualização, seus erros de autenticação anteriores devem ser resolvidos, e as sincronizações de integrações serão retomadas.

Recursos adicionais