S
ShopIA— Ajuda
Essencial·Primeiros 7 dias

Plugin WooCommerce não conecta: diagnóstico passo a passo

4 min de leitura·Atualizado em maio/2026
O plugin WooCommerce é o conector mais usado pelos lojistas e também o que mais gera tickets quando algo falha. Esta página lista as causas mais frequentes em ordem de probabilidade.

Sintomas comuns

  • Mensagem "Token inválido" após colar token no plugin
  • Banner amarelo "Aguardando conexão" no painel ShopIA por mais de 10 minutos
  • "Erro de comunicação" ao salvar configurações do plugin
  • Plugin instalado, ativado, mas sem evento algum chegando

Causa 1: token expirado ou copiado errado

A causa mais frequente. Tokens do plugin têm formato shk_ seguido de 32 caracteres alfanuméricos. Erros comuns:

  • Espaços antes ou depois ao colar
  • Token de outra loja (em multi-loja)
  • Token revogado por trocar plano ou rotação manual

Como resolver

  1. No painel ShopIA, acesse Configurar > Conexões > WooCommerce.
  2. Clique em Gerar novo token.
  3. Copie o token completo (ícone de copiar à direita).
  4. No WordPress, vá para WooCommerce > ShopIA > Configurações.
  5. Cole o token, sem espaços.
  6. Selecione o ambiente correto (Produção, salvo se você está em ambiente de teste).
  7. Clique em Salvar e testar conexão.

Causa 2: ambiente errado selecionado

A partir do plugin v3.11.0, há seletor Sandbox/Produção na própria UI. Lojistas que já usavam ambientes legados podem ter token de produção apontando para sandbox.

Ambiente do pluginURL ShopIA esperada
Produçãohttps://app.shopia.com.br
Sandboxhttps://sandbox.shopia.com.br

Confirme em WooCommerce > ShopIA > Configurações que o seletor está em Produção se você está conectando à conta principal.

Causa 3: plugin desatualizado

A partir da v3.13, o plugin aponta automaticamente para o subdomínio dedicado de webhooks (webhooks.shopia.com.br). Versões anteriores ainda funcionam, mas com latência maior.

Como resolver

  1. Acesse Plugins > Plugins instalados.
  2. Procure ShopIA Connector.
  3. Se houver atualização disponível, clique em Atualizar agora.
  4. Caso não apareça atualização e a versão for inferior a v3.13, baixe manualmente em shopia.com.br/plugin e reinstale.

Detalhes em Plugin WooCommerce v3.13: o que muda no seu painel.

Causa 4: HTTPS inválido ou expirado

O ShopIA recusa conexões via HTTP puro ou com certificado SSL inválido. Erros comuns:

  • Certificado autoassinado em ambiente de produção
  • Certificado expirado
  • Certificado emitido para outro domínio
  • Servidor sem suporte a TLS 1.2 ou superior

Como resolver

  1. Acesse sua loja no navegador. Confirme que aparece o cadeado verde sem aviso.
  2. Use ferramenta como SSL Labs para diagnóstico completo.
  3. Renove ou reinstale o certificado pela hospedagem.

Causa 5: firewall ou WAF bloqueando

Hospedagens com WAF (Web Application Firewall) agressivo podem bloquear chamadas vindas dos servidores ShopIA. Sintoma típico: plugin reporta "conectado" mas nenhum evento chega ao painel.

Como resolver

  1. Identifique o IP de origem da ShopIA com o suporte.
  2. Adicione esse IP à allowlist do WAF.
  3. Confirme se há plugin de segurança no WordPress (Wordfence, Sucuri) bloqueando rotas REST.
  4. Em casos persistentes, peça à hospedagem para liberar /wp-json/shopia/*.

Causa 6: rotas REST do WordPress desativadas

Algumas instalações WordPress têm a API REST desativada por hardening. O plugin ShopIA depende dela para funcionar.

Como verificar

Acesse no navegador:

https://www.suaLoja.com.br/wp-json/

Se retornar JSON, a API REST está ativa. Se retornar 404 ou 403, está desativada.

Como reativar

  • Desative plugins de segurança que disabilitam a REST API
  • Edite functions.php e remova filtros como add_filter('rest_authentication_errors', ...)
  • Em caso de dúvida, peça suporte à hospedagem

Causa 7: site em modo de manutenção

Plugins como WP Maintenance Mode ou Coming Soon Page bloqueiam todas as requisições externas, incluindo as do ShopIA.

Solução: desative o modo de manutenção até finalizar a configuração.

Quando entrar em contato com o suporte

Se você passou por todas as causas acima e o plugin ainda não conecta, abra ticket informando:

  • URL da loja
  • Versão do plugin (visível em Plugins > Plugins instalados)
  • Versão do WordPress e WooCommerce
  • Hospedagem (Hostinger, Locaweb, Kinsta, etc.)
  • Print da tela de erro do plugin

O suporte tem acesso a logs específicos da sua loja e pode identificar bloqueios silenciosos rapidamente.

Veja também

Este artigo foi útil?

Sua resposta ajuda a melhorar a Central de Ajuda.

Tenho outra dúvida →

Veja também