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.

Remover e reintegrar o WooCommerce não exclui perfis nem eventos sincronizados anteriormente do Klaviyo. No entanto, remover a integração interrompe a sincronização e remove do Klaviyo as definições de cupom do WooCommerce.

"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"

Esse título pode aparecer para diferentes erros de configuração. Leia a mensagem em Detalhes e use a seção de solução de problemas correspondente abaixo.

Se os detalhes mencionarem um firewall ou uma camada de segurança, inclua o tráfego da integração da Klaviyo na lista de permissões e desative o Bot Fight Mode no Cloudflare se ele estiver ativado.

  1. Saiba como colocar os endereços IP do tráfego de integrações do Klaviyo na lista de permissões.
  2. Se você usa o Cloudflare, siga as instruções dele para desativar o Modo Bot Fight.

Depois de atualizar as configurações do firewall, tente conectar a integração do WooCommerce novamente.

"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).

Resolva todos os erros de certificado SSL e tente conectar sua loja novamente.

"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 essa, exclua-a ou comente-a para eliminar o erro. Para mais informações sobre esse erro, confira as Perguntas frequentes sobre a API REST do WordPress.

"Não foi possível acessar a API de pedidos, verifique as configurações de conexão e tente novamente"

Esse erro pode aparecer quando a Klaviyo não consegue validar o acesso aos dados de pedidos da sua loja. Por exemplo, o ponto de extremidade de contagem de pedidos do plugin do Klaviyo pode retornar uma contagem ausente ou inválida, ou uma solicitação à sua loja pode falhar.

Verifique se o plugin da Klaviyo está instalado, com atividade e atualizado e se sua loja permite as solicitações de API da Klaviyo. Resolva todos os erros antes de tentar a conexão novamente.

Para inspecionar a resposta de contagem de pedidos com a versão mais recente do plugin do Klaviyo instalada, execute a seguinte solicitação cURL. Substitua STORE_URL pelo domínio da sua loja e substitua CONSUMER_KEY e CONSUMER_SECRET pelas suas credenciais da API REST do WooCommerce.

text
curl --include "https://STORE_URL/wp-json/klaviyo/v1/orders/count" \
  -H "X-Klaviyo-Consumer-Key: CONSUMER_KEY" \
  -H "X-Klaviyo-Consumer-Secret: CONSUMER_SECRET"

Uma resposta bem-sucedida inclui um valor order_count, como {"order_count": 0} para uma loja sem pedidos. Se você receber um erro, compartilhe o status e a mensagem de erro com seu desenvolvedor ou com o Suporte da Klaviyo. Não compartilhe seu segredo de consumidor.

Como atualizar seu plugin da Klaviyo

Siga Como atualizar o plugin do WooCommerce para verificar e instalar uma atualização disponível. Você não precisa remover as integrações para atualizar o plugin. Se você acabou de atualizá-lo, um webhook de configurações atrasado pode fazer com que a Klaviyo mostre temporariamente as configurações anteriores. Aguarde alguns minutos e atualize a página de integrações.

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.
  1. 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.

image (1).png
image (1).png

Se a instalação no marketplace do WooCommerce falhar, instale e ative o plugin do Klaviyo no seu painel de administração do WordPress. Consulte o guia de instalação de plugins do WordPress para ver as instruções mais recentes.

  1. Navegue até o admin do WordPress e vá para Plugins.
  2. Selecione Adicionar novo.
  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, vá para Ativar a integração com o WooCommerce no artigo Guia de introdução ao WooCommerce.

Os eventos de webhook não estão chegando ao Klaviyo

Se os eventos do WooCommerce não chegarem ao Klaviyo, verifique os seguintes problemas de conexão e permissões. Se o problema persistir, entre em contato com o suporte da Klaviyo.

1. Seu firewall ou plugin de segurança bloqueia a solicitação DELETE

A Klaviyo envia solicitações DELETE para remover webhooks existentes ao registrá-los novamente. Se o seu firewall ou plugin de segurança bloquear essas solicitações, os webhooks antigos podem permanecer ativos. Ao solucionar problemas de configuração de webhook, verifique se há solicitações DELETE bloqueadas.

Como verificar:

  1. Abra seu firewall ou plugin de segurança.
  2. Verifique o log de solicitações em busca de solicitações DELETE bloqueadas para um URL /wp-json/.
  3. Se o seu host gerencia o firewall, peça para ele verificar os próprios logs.

Como corrigir: Permita o método DELETE em /wp-json/wc/v3/webhooks/ nas regras do seu firewall ou plugin de segurança. Se o seu host gerencia o firewall, peça ao host para fazer essa alteração.

2. O Cloudflare ou outro WAF bloqueia a solicitação antes que o WordPress a veja

Se o seu site estiver por trás do Cloudflare ou de outro firewall de aplicativo web (WAF), o WAF pode bloquear ou questionar as chamadas de API do Klaviyo antes que elas cheguem ao WordPress. Verifique os logs do firewall para confirmar um bloqueio. Um erro de permissão 403, como o exemplo a seguir, por si só, não prova que o firewall causou o problema:

{"code":"woocommerce_rest_cannot_view","message":"Sorry, you cannot list resources.","data":{"status":403}}

Como verificar:

  1. Abra o painel do Cloudflare ou o painel do seu WAF.
  2. Acesse o log de eventos de segurança.
  3. Procure solicitações bloqueadas ou questionadas para um URL /wp-json/wc/v3/, por volta do momento da falha.

Como corrigir: Adicione uma regra de acesso por IP no Cloudflare (ou o equivalente no seu WAF) que permita os intervalos de IP de integração da Klaviyo, com a ação definida como Permitir. Confira Como adicionar os endereços IP de tráfego de integração da Klaviyo à lista de permissões para ver a lista completa de intervalos de IP e instruções passo a passo do Cloudflare.

3. Sua chave de API não tem acesso de gravação

A Klaviyo usa uma chave de API REST do WooCommerce para ler dados da loja e gerenciar webhooks. Se essa chave tiver apenas permissão de Leitura, o WooCommerce bloqueia ações de escrita, incluindo o registro de webhook. A solicitação pode falhar com um erro de permissão.

Como verificar: siga as etapas abaixo ou consulte o guia de chave de API REST do WooCommerce para obter instruções atuais de gerenciamento de chaves.

  1. No WordPress, acesse WooCommerce > Settings > Advanced > REST API.
  2. Encontre a chave usada para suas integrações com a Klaviyo.
  3. Verifique o valor na coluna Permissões.

Como corrigir:

  1. Clique em Editar na chave.
  2. Altere Permissões para Leitura/gravação.
  3. Salve a chave.

Não revogue a chave nem crie uma nova. Uma nova chave tem um novo segredo. O novo segredo interrompe a conexão do Klaviyo com sua loja.

Depois de corrigir a conexão ou as permissões, tente configurar novamente se tiver falhado. Se a integração estiver conectada, mas os eventos ainda não chegarem, entre em contato com o Suporte da Klaviyo e informe os detalhes do erro.

Recursos adicionais

  • Introdução à WooCommerce

    Saiba como instalar a extensão da Klaviyo WooCommerce e habilitar a integração da WooCommerce na sua conta Klaviyo.

Esse artigo foi útil?
Use esse formulário somente para dar feedback sobre os artigos. Saiba como entrar em contato com o suporte.

Saiba mais sobre a Klaviyo

Community
Conecte-se com colegas, parceiros e especialistas da Klaviyo para ter ideias, compartilhar insights e tirar dúvidas.
Parceiros
Contrate um especialista certificado pela Klaviyo para ajudá-lo com uma tarefa específica ou para gerenciamento contínuo de marketing.
Suporte

Acesse o suporte na sua conta.

Suporte por e-mail (teste gratuito e contas pagas) Disponível 24 horas

Chat/assistência virtual
A disponibilidade varia conforme o local e o tipo de plano