Referência de requisitos do sistema de integrações do Magento

O que você vai aprender

Saiba mais sobre os requisitos do sistema para uma sincronização ideal com o Magento 1 ou 2. O administrador da sua loja Magento é responsável pelas especificações e configurações do sistema. Garantir que seu sistema esteja configurado para funcionar com o Klaviyo vai permitir uma experiência de integração tranquila.

As versões do Magento 2 anteriores à 2.4.0 não são compatíveis.

Configurar permissões da API

Para uma integração existente do Magento 1, o usuário da API SOAP precisa ter acesso total aos recursos. Certifique-se de que Acesso aos recursos esteja definido como Todos.

Para o Magento 2, instale e configure a extensão da Klaviyo e, em seguida, configure o OAuth e aprove as permissões de API solicitadas. Siga o guia de integração do Magento 2 para concluir a configuração no Magento e habilitar a integração na Klaviyo.

Sem as permissões necessárias da API, a Klaviyo não conseguirá interagir corretamente com as APIs da sua loja Magento, o que impedirá as integrações de recuperar dados da sua loja.

Ative o acesso aos pontos de extremidade de API necessários

A Klaviyo solicita dados de pontos de extremidade específicos. As configurações do seu sistema precisam permitir o acesso a esses pontos de extremidade; considere o impacto de controles de segurança ou da lógica de redirecionamento de URL na acessibilidade desses pontos de extremidade para a Klaviyo. Se a Klaviyo não tiver acesso aos pontos de extremidade de API esperados, alguns ou todos os dados do Magento não poderão ser sincronizados e você verá relatórios de erro no aplicativo.

Para o Magento 2, sua loja deve ter um nome de host acessível publicamente. Permita que o Klaviyo acesse /oauth/token/request e /oauth/token/access para autenticação OAuth, bem como a API REST em /index.php/rest. Se a autenticação falhar, siga o guia de solução de problemas do Magento 2.

Todo o tráfego de integrações de saída do Klaviyo fica por trás de um conjunto de endereços IP estáticos e previsíveis, para que você tenha um alto nível de confiança de que esse tráfego está vindo do Klaviyo; recomendamos adicionar esses endereços à allowlist.

Capacidade do sistema para solicitações de API de sincronização de dados históricos

Quando você ativa a integração, a Klaviyo automaticamente coloca na fila as solicitações de API para sincronizar dados históricos, incluindo registros de clientes, registros de pedidos e o catálogo de produtos. Tentamos fazer isso rapidamente para permitir que profissionais de marketing usem esses dados em suas contas o mais rápido possível. Também tentamos fazer isso de forma responsável, limitando a simultaneidade e lidando com novas tentativas de forma adequada. Se a sua loja tiver um grande volume de dados históricos, capacidade limitada de recursos ou outros aplicativos que façam solicitações substanciais de API, recomendamos consultar o administrador do Magento para garantir que sua infraestrutura esteja preparada para oferecer suporte à sincronização de dados históricos. Seu administrador pode considerar aumentar temporariamente os recursos ou aplicar o dimensionamento automático.

Verificar a validade do certificado SSL

Um certificado SSL autentica digitalmente a identidade de um site e habilita uma conexão criptografada entre um navegador web e um servidor web. O certificado SSL do seu site é hospedado no servidor de origem do site. Um certificado SSL válido é fundamental para aceitar pagamentos com segurança, proteger logins de senha e proteger formulários web. O Teste de servidor SSL pode ser usado para verificar o certificado SSL de um site.

As integrações do Magento podem ser desativadas se o certificado SSL do seu site expirar. Nesse caso, o domínio e os certificados intermediários precisam ser atualizados no provedor de hospedagem. Se você não tiver certeza de onde seus certificados estão, entre em contato com seu provedor de hospedagem para obter ajuda.

Alocação de memória do servidor suficiente

O espaço em disco para produtos, imagens de produtos, e-mails armazenados e páginas de conteúdo estático é separado da memória PHP. Ter espaço em disco suficiente não significa que o PHP tenha memória suficiente para processar as solicitações de API do Klaviyo.

Recomendamos que você aloque mais de 1 gigabyte de memória para suas integrações do Klaviyo, mas 512 megabytes é o mínimo exigido. Se o seu servidor não conseguir alocar recursos suficientes para responder às solicitações do Klaviyo, ocorrerão erros de integração. A integração Klaviyo-Magento começa com uma sincronização de dados históricos, então é recomendável que você verifique as configurações de memória no Magento e no seu servidor antes de ativar a integração.

Verifique a configuração do PHP memory_limit usada pelo seu servidor web do Magento. O padrão do PHP é 128 megabytes, mas a configuração da sua hospedagem pode substituí-lo. O administrador do Magento pode atualizar essa configuração em php.ini. Para o Magento 2, siga também as orientações da Adobe sobre configurações do PHP.

Use carimbos de data/hora em UTC para sincronização

A Klaviyo usa o Tempo Universal Coordenado (UTC) para solicitar dados recentes do Magento e interpretar os carimbos de data/hora retornados pelas APIs. Carimbos de data/hora incorretos podem fazer com que registros sejam ignorados durante a sincronização ou apareçam no momento errado na Klaviyo.

Peça para o administrador do Magento verificar se os carimbos de data/hora retornados pelas APIs da sua loja estão em UTC. Se registros recentes estiverem faltando ou mostrarem horários incorretos, verifique esses carimbos de data/hora e a configuração do seu servidor antes de alterar as configurações de fuso horário da sua loja.

Recursos adicionais