Plugin WooCommerce v3.13: o que é, o que muda e como atualizar

O plugin WooCommerce do ShopIA é a integração de nível Tier 2 (connector) que habilita recursos avançados como recuperação de carrinho, captura de leads, autolink de identidade e agora roteamento direto de webhooks para o subdomínio dedicado.

A versão 3.13 traz três mudanças importantes:

1. Roteamento automático para o subdomínio webhooks.shopia.com.br
2. Compatibilidade total com o modelo de token único (shk_...) introduzido na v3.7
3. Self-healing aprimorado para webhooks regenerados pelo WooCommerce

Por que atualizar

Versões anteriores à 3.13 enviavam webhooks para o domínio principal app.shopia.com.br. Com o crescimento do volume, a partir de 2026-05-07 o tráfego de webhooks foi isolado em um container dedicado (shopia-webhooks), separado do tráfego de UI e API REST. O plugin v3.13 aponta automaticamente para o novo subdomínio.

Se você estiver em uma versão entre 3.7 e 3.12, sua loja continuará funcionando — o sistema aplica um redirect para o novo subdomínio durante a janela de transição. Mas a recomendação oficial é atualizar.

O que muda na prática

Como atualizar

Atualização automática (recomendado)

1. No admin do WordPress, acesse Plugins > Plugins instalados.
2. Localize ShopIA Connector.
3. Se houver atualização disponível, clique em Atualizar agora.
4. Aguarde a conclusão. O plugin reativa-se automaticamente.

Atualização manual

Caso o plugin não detecte a nova versão automaticamente:

1. Baixe o ZIP mais recente em Configurações > Plataforma no painel ShopIA.
2. No WordPress, vá em Plugins > Adicionar novo > Enviar plugin.
3. Faça o upload do ZIP e clique em Instalar agora.
4. O sistema solicita confirmação para sobrescrever a versão existente — confirme.

Atenção: o ZIP do plugin contém um seletor de ambiente (Sandbox / Produção) na primeira tela de configuração. Em lojas reais, mantenha sempre Produção selecionado.

Após a atualização

Verificar a comunicação

1. Acesse WooCommerce > ShopIA Connector > Status.
2. Confirme que o badge Conectado está verde.
3. Clique em Testar conexão. O resultado esperado é Comunicação OK · webhooks.shopia.com.br · X ms.

Validar webhooks

O plugin executa um self-heal automático após a atualização, validando que todos os webhooks registrados na sua loja apontam para o subdomínio correto. Caso encontre algum webhook órfão, ele é corrigido em background.

Você pode forçar uma revalidação:

1. WooCommerce > ShopIA Connector > Avançado
2. Clique em Reaplicar webhooks

Mudanças técnicas internas (para quem opera infraestrutura)

• O plugin envia agora o header User-Agent: ShopIA-Connector/3.13.0 (útil para logs).
• Implementa retry exponencial com jitter para reduzir picos em incidentes.
• O fail-fast da fila local ativa em código 401/403, suspendendo envios até reautenticação.
• O endpoint /api/plugin/whoami é chamado uma vez após instalação para descoberta de storeId, com cache transient de 24 horas.

Compatibilidade com versões anteriores

Lojas em v3.7 a v3.12 continuam funcionando durante a janela de transição. O servidor reconhece tanto o domínio antigo quanto o novo. A janela de tolerância para o domínio legado está prevista até 2026-08-07 (90 dias após a virada). Após essa data, lojas em versões anteriores precisarão atualizar para continuar enviando webhooks.

Problemas conhecidos

"Token inválido" após atualização

Se aparecer mensagem de token inválido, gere um novo em Painel ShopIA > Configurar > Plataforma > Rotacionar token. Cole no campo único do plugin e salve.

"Could not connect to webhooks endpoint"

Verifique se o servidor da sua loja consegue alcançar webhooks.shopia.com.br (DNS público, porta 443). Em ambientes corporativos com firewall restritivo, libere o subdomínio.

Compatibilidade com plugins de cache

Em alguns casos, plugins de cache muito agressivos podem armazenar respostas do AJAX do plugin. Limpe o cache após a atualização.

Veja também

• Como conectar minha loja WooCommerce
• Lista de bloqueio (suppression list) e opt-out
• Como conectar minha loja Nuvemshop