Em 10 minutos sua loja WooCommerce está conectada ao ShopIA. Recomendamos instalar o plugin oficial — ele desbloqueia recuperação de carrinho e captura de leads.
O que você vai precisar
- Acesso de administrador no WordPress da sua loja
- WooCommerce instalado (qualquer versão recente — 7.0 ou superior)
- Seu site com WordPress acessível pela internet (não funciona em localhost)
Tem dois caminhos: com plugin ou sem
| Caminho | O que entrega |
|---|---|
| Sem plugin (mais simples) | Insights de pedidos, clientes e produtos. Bom pra quem só quer Memo e analytics. |
| Com plugin (recomendado) | Tudo do anterior + recuperação de carrinho + captura de leads + Turbinador completo. |
A boa notícia: você pode começar sem plugin e instalar depois. O ShopIA continua funcionando.
Caminho recomendado — com plugin oficial
Passo 1: criar a loja no painel ShopIA
- Entre em
app.shopia.com.br/admin/lojas/nova - Escolha WooCommerce
- Informe o domínio da sua loja (
https://minhaloja.com.br) - O sistema gera um token de instalação — copie esse token, você vai precisar no próximo passo
Passo 2: instalar o plugin
- No WordPress da sua loja, vá em Plugins → Adicionar novo
- Procure por "ShopIA Connector" e clique em Instalar
- Depois de instalar, clique em Ativar
- Vá em ShopIA → Configurações no menu lateral do WordPress
- Cole o token que você copiou no passo anterior
- Clique em Conectar
Atenção: o plugin gera um token chamadoshk_seguido de 48 caracteres. Esse token funciona como uma senha — não compartilhe com ninguém fora da sua equipe.
Passo 3: validar a conexão
Volte pro painel ShopIA. Em Configurações → Conexão, você vai ver:
- Status do plugin: Ativo (bolinha verde)
- Última sincronização: data e hora
- Versão do plugin: deve ser 3.7.0 ou superior
Se algum item estiver vermelho, veja a seção de troubleshooting no final.
Caminho mais simples — sem plugin
Se você não consegue instalar plugin agora (loja gerenciada, host sem acesso), dá pra conectar usando só a API do WooCommerce.
- No WordPress, vá em WooCommerce → Configurações → Avançado → API REST
- Clique em Adicionar chave
- Descrição: "ShopIA"
- Permissões: Leitura/Escrita
- Clique em Gerar chave de API
- Copie a Chave do consumidor (
ck_...) e a Chave secreta do consumidor (cs_...) - Volte pro ShopIA, escolha "Conectar via API REST" e cole as duas chaves
O que você perde sem plugin: carrinho abandonado não funciona (WooCommerce não envia esse evento por padrão), captura de leads não roda na sua loja, e algumas otimizações do Turbinador ficam limitadas.
Quanto tempo demora a primeira sincronização
Depende do tamanho da sua loja:
- Até 1.000 pedidos: 2-5 minutos
- 1.000 a 10.000 pedidos: 10-30 minutos
- Acima de 10.000: pode levar 1-2 horas
Você pode usar o painel normalmente enquanto sincroniza. Os dados vão aparecendo aos poucos.
Problemas comuns
"Token inválido"
O token só vale uma vez. Se você gerou e não usou em 30 minutos, gere de novo em Configurações → Conexão → Gerar novo token.
"Não conseguimos acessar sua loja"
Verifique se:
- O domínio que você cadastrou bate com o domínio real (com
https://, sem barra no fim) - Sua loja não está em modo manutenção
- Plugins de segurança (Wordfence, iThemes) não estão bloqueando o IP da ShopIA
Pedidos novos não aparecem
Em Configurações → Conexão → Webhooks, verifique se os webhooks estão verdes. Se algum estiver vermelho, clique em Reparar — o plugin recria automaticamente.