O senhor aprenderá
Saiba como solucionar problemas com a configuração do seu WooCommerce integrações seguindo o cenário de solução de problemas relevante descrito abaixo. Se o senhor estiver enfrentando problemas que não estão nessa lista, entre em contato com a comunidade ou com nossa equipe de suporte.
Antes de começarAntes de começar
Se ainda não o fez, leia nosso guia sobre como começar a usar o WooCommerce para obter instruções passo a passo sobre a integração. Se o senhor deseja atualizar seu plugin, faça o checkout de nosso artigo sobre como atualizar seu WooCommerce plugin .
Cenários de solução de problemasCenários de solução de problemas
Consulte os cenários a seguir com base na mensagem de erro recebida no aplicativo para resolver seu problema.
Observe que, se o senhor optar por remover sua integração e depois reintegrá-la, seus dados do WooCommerce não serão excluídos da Klaviyo.
"Para evitar interrupções na funcionalidade, talvez seja necessário desativar os seguintes plug-ins: Nome(s) do(s) plugin(s)"
Se o senhor tiver plug-ins de cache ativos ou plug-ins de redirecionamento no WordPress, eles podem interferir na integração do Klaviyo e causar problemas de conexão. Recomendamos desativar esses plug-ins durante o processo de configuração da integração.
"Não é possível concluir sua configuração"
Essa mensagem significa que seu firewall está bloqueando as solicitações do Klaviyo, que o senhor tem o Bot Fight Mode ativado no Cloudflare, ou ambos.
Para resolver o problema, recomendamos que o tráfego de integração do Klaviyo seja incluído na lista de permissões e que o Bot Fight Mode seja desativado (se o senhor o tiver ativado).
- Saiba como colocar na lista de permissões os endereços IP do tráfego de integração do Klaviyo.
- Para desativar o modo Bot Fight no Cloudflare:
- Faça login no painel de controle da Cloudflare.
- Selecione sua conta e domínio.
- Acesse Security > Bots.
- Para Bot Fight Mode, selecione Off.
"Certifique-se de que sua loja WooCommerce tenha https e SSL habilitados"
A Klaviyo espera que o URL de sua loja siga os protocolos HTTPS, o que significa que o site tem um certificado SSL válido. Se o seu site estiver em HTTP em vez de HTTPS, o senhor poderá ter problemas.
O senhor pode verificar se o seu certificado SSL é válido em SSL Server Test (Powered by Qualys SSL Labs).
A Klaviyo exige que os testes sejam aprovados com notas A.
"Não é possível acessar a API com as credenciais fornecidas""Não é possível acessar a API com as credenciais fornecidas"
O senhor pode receber esse erro se tiver personalizações implementadas para impedir o acesso à API de usuários não conectados. Normalmente, essa é uma função no arquivo functions.php do WordPress, que aciona uma resposta de código de status 401.
Se o senhor tiver uma personalização como essa, exclua-a ou comente-a para eliminar o erro. Para obter mais informações sobre esse erro, consulte as Perguntas frequentes sobre a API REST do WooCommerce.
"Não foi possível acessar a API de pedidos, verifique as configurações de conexão e tente novamente""Não foi possível acessar a API de pedidos, verifique as configurações de conexão e tente novamente"
Esse erro significa que quando a Klaviyo tenta validar a integração do WooCommerce e obter uma contagem de pedidos, a API não retorna o valor esperado pela Klaviyo ou não retorna nada.
Como a integração ainda não foi oficialmente conectada ao Klaviyo, isso significa que o problema precisa ser resolvido no WooCommerce.
Para obter mais informações sobre esse erro, o senhor precisa fazer uma chamada de API para o endpoint de contagem de pedidos, que fornecerá mais informações sobre o que está sendo passado para o Klaviyo. Aqui está um exemplo de solicitação cURL. Para usá-lo, preencha o URL da loja, a chave do consumidor e o segredo do consumidor:
curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET
"Seu plugin Klaviyo está desatualizado"
Ocasionalmente, o webhook demorará a chegar ao Klaviyo, fazendo com que o senhor veja temporariamente a página de configurações antiga. Isso deve se resolver após alguns minutos.
404 ao conectar-se ao Klaviyo a partir do WordPress404 ao conectar-se ao Klaviyo a partir do WordPress
Para resolver isso, o senhor deve confirmar se tem Permalinks ativados para o seu site WordPress. A autenticação do WooCommerce não funcionará a menos que os Permalinks estejam ativados.
- Navegue até o site do WordPress e acesse Settings > Permalinks.
- Em Common Settings, escolha qualquer estrutura de link que não seja Plain.
- Confirme clicando em Save Changes (Salvar alterações).
- Quando o senhor terminar, reintegre-se ao Klaviyo.