Como solucionar problemas da sua integração com o WooCommerce

O que você vai aprender

Saiba como resolver problemas com a configuração da sua integração com o WooCommerce seguindo o cenário de solução de problemas relevante descrito abaixo. Se você estiver enfrentando problemas que não estão nesta lista, entre em contato na Community ou com nossa Equipe de Suporte.

Antes de começar

Se ainda não fez isso, leia nosso Guia de introdução ao WooCommerce para ver instruções passo a passo sobre a integração. Se você quer atualizar seu plugin, confira nosso artigo sobre como atualizar seu plugin do WooCommerce.

Cenários de solução de problemas

Consulte os seguintes cenários com base na mensagem de erro recebida no app para resolver o problema.

"Para evitar interrupções de funcionalidade, talvez seja necessário desativar os seguintes plugins: Nome do(s) plugin(s)"

Se você tiver plugins de cache ou plugins de redirecionamento com atividade no WordPress, eles podem interferir nas integrações do Klaviyo e causar problemas de conexão. Recomendamos desativar esses plugins durante o processo de configuração da integração.

"Não é possível concluir sua configuração"

Esta mensagem significa que seu firewall está bloqueando as solicitações do Klaviyo, que você tem o Bot Fight Mode ativado no Cloudflare ou ambos.

Para resolver, recomendamos tanto permitir os tráfegos de integração da Klaviyo quanto desativar o Bot Fight Mode (se você o tiver ativado).

1. Saiba como colocar os endereços IP do tráfego de integrações do Klaviyo na lista de permissões.
2. Para desativar o Bot Fight Mode no Cloudflare:
   1. Faça login no painel do Cloudflare.
   2. Selecione sua conta e domínio.
   3. Acesse Segurança > Bots.
   4. Para o Bot Fight Mode, selecione Desativado.

"Garanta que sua loja WooCommerce tenha https e SSL ativados"

A Klaviyo espera que o URL da sua loja siga os protocolos HTTPS, ou seja, que o site tenha um certificado SSL válido. Se o seu site estiver em HTTP, em vez de HTTPS, você poderá ter problemas.

Você pode verificar se seu certificado SSL é válido em Teste de servidor SSL (com tecnologia da Qualys SSL Labs).

A Klaviyo exige que os testes sejam aprovados com classificações A.

"Não foi possível acessar a API com as credenciais fornecidas"

Você pode receber este erro se tiver personalizações configuradas para impedir o acesso à API para usuários que não fizeram login. Normalmente, esta é uma função no arquivo functions.php do WordPress, que aciona uma resposta de código de status 401.

Se você tiver uma personalização como esta, exclua-a ou comente-a para eliminar o erro. Para saber mais sobre este erro, confira as Perguntas frequentes da API REST do WooCommerce.

"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 o Klaviyo tenta validar a integração do WooCommerce e obter uma contagem de pedidos, a API deles não retorna um valor que o Klaviyo espera ou não retorna nada.

Como a integração ainda não se conectou oficialmente ao Klaviyo, isso significa que ela precisa ser resolvida no WooCommerce.

Para obter mais informações sobre esse erro, você precisa fazer uma chamada de API para o ponto de extremidade de contagem de pedidos, o que vai fornecer mais insights sobre o que está sendo transmitido ao Klaviyo. Aqui está um exemplo de solicitação cURL. Para usá-la, preencha o URL da sua 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 da Klaviyo está desatualizado"

Ocasionalmente, o webhook pode demorar para chegar à Klaviyo, fazendo com que você veja temporariamente a página de configurações antiga. Isso deve se resolver após alguns minutos.

Erro 404 ao conectar ao Klaviyo a partir do WordPress

Para resolver isso, você deve confirmar que os Permalinks estão ativados no seu site WordPress. A autenticação do WooCommerce não funcionará a menos que os Permalinks estejam ativados.

1. Acesse seu site do WordPress e vá para Configurações > Links permanentes.
2. Em Configurações comuns, escolha qualquer estrutura de link diferente de Simples.
3. Confirme clicando em Salvar alterações.
   

4. Quando terminar, reintegre com o Klaviyo.

Falha na instalação - Não foi possível instalar sua extensão

Você pode encontrar um erro de "Falha na instalação" ao tentar instalar a integração pelo marketplace do WooCommerce.

Se você não conseguir instalar com êxito pelo marketplace do WooCommerce, também pode instalar o plugin pelo administrador de plugins do Wordpress.

1. Navegue até o admin do WordPress e vá para Plugins.
2. Selecione Adicionar plugin.
3. Pesquise por Klaviyo em Pesquisar plugins.
4. Selecione Instalar agora.
5. Selecione Ativar.
6. Selecione Marketing na navegação à esquerda e, em seguida, clique em Klaviyo.
7. Clique em Conectar conta para começar e, em seguida, continue para Ativar a integração com o WooCommerce no artigo Guia de introdução ao WooCommerce.
   

Recursos adicionais