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

O senhor aprenderá

Saiba como resolver problemas com sua configuração do Magento 2 OAuth seguindo as etapas de solução de problemas descritas abaixo. Se o senhor ainda tiver problemas depois de executar essas etapas, entre em contato com a nossa comunidade ou com a nossa equipe de suporte. 

Antes de começar

Se ainda não o fez, leia nosso guia sobre Introdução ao Magento 2 para obter instruções passo a passo sobre como configurar sua integração com o Magento 2.

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

Etapas gerais de solução de problemas

Certifique-se de que seu site seja acessível ao público com um certificado SSL válido

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

1. Certifique-se de que o senhor não tenha protegido com senha ou acesso restrito por IP à sua loja.
2. Certifique-se de que sua loja esteja acessível via HTTPS com um certificado SSL válido. O senhor pode testar seu certificado aqui.

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

Todo o tráfego de saída da integração com a Klaviyo fica atrás de um conjunto de endereços IP estáticos e previsíveis, para que o senhor possa ter um alto nível de confiança de que esse tráfego está vindo da Klaviyo. Leia nosso artigo para saber como listar os endereços IP do tráfego de integração do Klaviyo. 

Verifique as versões das extensões do Magento 2 e do Klaviyo

1. Se estiver usando o Magento v2.2.0, o senhor precisará ativar manualmente o OAuth.
2. Verifique se o senhor instalou a extensão correta do Klaviyo (talvez seja necessário atualizar).

Garantir que os pontos de extremidade do OAuth estejam acessíveis

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

Certifique-se de que os URLs abaixo sejam acessíveis para sua loja:

https://[URL da loja]/oauth/token/request

https://[URL da loja]/oauth/token/access

1. O senhor pode validar se 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

2. O senhor deve esperar uma resposta semelhante à seguinte. É normal ver um erro ao fazer uma solicitação dessa forma, e isso valida que os endpoints estão respondendo corretamente. 
   
3. Se não receber uma resposta relacionada ao OAuth, o senhor deve verificar se não há redirecionamentos, regras de reescrita inválidas ou erros internos do servidor que impeçam o acesso a esses URLs.

Isso pode ser causado por um subcaminho de armazenamento em seu URL. Teste um problema de subcaminho de armazenamento acessando os pontos de extremidade em:

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

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

Se esses endpoints forem resolvidos, inclua as regras de reescrita abaixo em seu .htaccess para resolver o problema.

RewriteEngine on
RewriteRule /oauth/token/request$ https://%{HTTP_HOST}/[Caminho da loja]/oauth/token/request [L,R=301]
RewriteRule /oauth/token/access$ https://%{HTTP_HOST}/[Caminho da Loja]/oauth/token/access [L,R=301]

Excluir a integração e recriá-la

Se o senhor tiver feito alterações após uma tentativa de integração anterior que falhou, é 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. Selecione Integrações
3. Localize o registro de integração do Klaviyo e exclua-o

Depois que o registro de integração for excluído, siga as etapas do nosso guia sobre como fazer a integração com o Magento 2 para criar um novo registro de integração e tente novamente.

Problemas específicos da versão do Magento

Falha específica do Magento 2.4.2

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

Para resolver esse erro, o senhor precisará

• Faça a atualização para o Magento 2.4.3. Consulte a documentação do Magento 2 para atualizar sua versão. 
• Aplique um patch conforme descrito no repositório github da Klaviyo para o Magento 2.

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

O senhor está usando o Magento 2.4.6 e está encontrando um erro de autenticação 401 após a integração com o Klaviyo? Isso pode ser devido a um bug conhecido do Magento que afeta a versão 2.4.6 do Magento. Para resolver isso, o senhor precisará ativar a autenticação do token de portador para que o Klaviyo possa fazer solicitações usando-o (em vez do OAuth 1.0). Para ativar a autenticação de token de portador:

1. Em seu administrador do Magento, navegue até Stores > Configuration > Services > OAuth > Consumer Settings.
2. Para a configuração Allow OAuth Access Tokens to be used as stand-alone Bearer tokens (Permitir que os tokens de acesso OAuth sejam usados como tokens de portador autônomo), selecione Yes (Sim).
3. Clique em Save Config.
   

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

Recursos adicionais

Referência de dados do Magento 2
Guia de suporte a várias lojas Magento (para Magento 2.x)