A Nuvemshop é uma das plataformas mais usadas no varejo brasileiro. Você conecta sua loja em poucos minutos e o ShopIA passa a importar pedidos, clientes e produtos automaticamente.
A integração com Nuvemshop está disponível no nível api_only (sem instalação de extensão). O ShopIA consome a API oficial da plataforma e recebe webhooks nativos para os principais eventos.
O que você consegue fazer com a Nuvemshop conectada
| Recurso | Disponível |
|---|---|
| Sincronização de pedidos | Sim, em tempo real |
| Sincronização de clientes | Sim |
| Sincronização de produtos | Sim |
| Recuperação de carrinho abandonado | Limitada (depende dos eventos nativos da plataforma) |
| Pós-venda automatizado | Sim |
| Newsletter Otto | Sim |
| Captura de leads (popup) | Sim, via JS embed instalado no tema |
Atenção: a Nuvemshop possui recurso nativo de carrinho abandonado. Antes de ativar a recuperação pelo Otto, recomendamos pausar o envio nativo da plataforma para evitar mensagens duplicadas ao mesmo comprador.
Pré-requisitos
Antes de começar, garanta que você tem:
- Acesso de administrador da loja na Nuvemshop
- Conta ativa no ShopIA com plano que permita conexão de loja
- O domínio da loja em mãos (ex:
https://minhaloja.com.br)
Passo a passo
1. Iniciar a conexão no painel ShopIA
No painel do ShopIA, acesse Configurações > Plataforma. Selecione Nuvemshop na lista de plataformas suportadas e clique em Conectar.
2. Autorizar o ShopIA na sua loja
Você será redirecionado para a tela de autorização da Nuvemshop. Faça login com a conta administradora da sua loja e revise as permissões solicitadas:
- Leitura de pedidos
- Leitura de clientes
- Leitura de produtos
- Recebimento de webhooks
Clique em Autorizar instalação.
3. Aguardar a sincronização inicial
Após a autorização, o ShopIA inicia a importação de dados históricos. O tempo varia conforme o volume da loja:
- Até 1.000 pedidos: aproximadamente 5 minutos
- 1.000 a 10.000 pedidos: entre 10 e 30 minutos
- Acima de 10.000 pedidos: até 2 horas
Você pode acompanhar o progresso em Painel > Estado da sincronização.
4. Validar a conexão
Após a sincronização, verifique:
- Se o número de pedidos importados confere com o painel da Nuvemshop
- Se a quantidade de clientes está coerente
- Se os produtos aparecem corretamente em Minha Loja > Produtos
Configurações recomendadas após conectar
- Configurar email — defina o endereço de envio das automações em Configurar > Email.
- Ativar recuperação de carrinho — em Recuperação > Configurar, valide os textos padrão antes de ligar o toggle principal.
- Instalar o popup de captura — caso utilize o Ímã de Leads, siga o guia de instalação do JS embed.
Problemas comuns
Pedido novo não aparece no ShopIA
Verifique se os webhooks da Nuvemshop estão ativos. Acesse Configurações > Plataforma no ShopIA e clique em Testar conexão. Se houver falha, refaça a autorização.
A autorização foi negada
Confirme que a conta utilizada possui permissão de administrador. Sub-usuários sem esse perfil não conseguem instalar aplicativos externos.
Recuperação de carrinho não dispara
A Nuvemshop só envia evento de carrinho abandonado para compradores identificados (com email ou telefone). Visitantes anônimos não geram disparo.