A conexão com a Nuvemshop é feita por login (OAuth): você autoriza a Toca na própria tela da Nuvemshop, sem digitar chave ou token.
Antes de começar
- Tenha em mãos o login da conta que administra a loja na Nuvemshop.
- Se você administra mais de uma loja, confirme em qual conta vai fazer login — a autorização vale para a loja dessa conta.
- Verifique se o navegador não está bloqueando pop-ups ou redirecionamentos.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Nuvemshop e clique no botão de conexão.
- Você será redirecionado para a página de autorização da Nuvemshop. Entre com o login da loja, se ainda não estiver conectado.
- Revise as permissões solicitadas e autorize o aplicativo.
- Você volta automaticamente para a Toca com o card marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê vendas, pedidos, cupons e devoluções da loja, além de produtos, estoque, clientes e carrinhos abandonados — a Nuvemshop só guarda carrinhos abandonados dos últimos 30 dias. Alterações — como atualizar produto, preço e estoque ou criar e excluir cupons — só acontecem mediante sua aprovação explícita, pedido a pedido, dentro do chat.
Manutenção da conexão
O token de acesso da Nuvemshop não expira sozinho: a conexão permanece ativa sem renovação
periódica. Ela só deixa de valer se o aplicativo for desinstalado na Nuvemshop ou se a
autorização for invalidada por lá. Nesses casos, o card em Configurações → Integrações
passa a indicar que a conexão precisa ser refeita — basta conectar novamente.
Problemas comuns
- Conectou a loja errada — a autorização vale para a loja da conta logada na Nuvemshop. Saia da conta no site da Nuvemshop, entre com a conta certa e refaça a conexão.
- A tela de autorização não abre — desative o bloqueio de pop-ups e redirecionamentos do navegador e tente novamente.
- A autorização demorou e falhou — o código gerado pela Nuvemshop expira em poucos minutos. Repita o fluxo do início, sem pausas longas na tela de autorização.
- O card voltou a pedir conexão — o aplicativo foi desinstalado ou a autorização foi invalidada na Nuvemshop. Refaça a conexão pelo card.