Conectar a Nuvemshop

Como instalar o app Hub Embaixadores na sua loja Nuvemshop, o que acontece depois e o que fazer quando a conexão dá erro.

Atualizado em 09/11/2026Só o dono da marca

Com a Nuvemshop conectada, os pedidos e o catálogo chegam sozinhos ao painel e os cupons do programa são criados direto na sua loja. A conexão é feita por um app: você não precisa copiar nenhum token. Só o dono da marca pode conectar.

Passo a passo#

  1. Entre na sua conta Nuvemshop no mesmo navegador.
  2. No painel, abra Configurações › Loja. Se a plataforma ainda não foi escolhida, clique em Nuvemshop em "Em qual plataforma a sua loja roda?".
  3. No card Nuvemshop, clique em Conectar loja.
  4. Na tela Integração Nuvemshop, clique em Conectar loja de novo.
  5. Na Nuvemshop, aprove as permissões do app Hub Embaixadores (ler pedidos e produtos, criar cupons).
  6. Você volta para o painel com a mensagem "Loja conectada! Pedidos e cupons já estão ligados à sua loja."
A tela Integração Nuvemshop com a loja conectada

Na volta, a plataforma já registra os webhooks (os avisos de pedido) na sua loja. Se isso falhar, a mensagem diz "Os webhooks ainda não foram registrados: use “Registrar webhooks” abaixo." Clique em Registrar webhooks no card Ações.

Depois de conectar, clique em Sincronizar produtos para trazer o catálogo na hora. Veja webhooks, sincronizar produtos e reconciliar.

O que cada status significa#

StatusSignificado
ConectadoA loja está ligada e o token está salvo.
ErroA última operação com a Nuvemshop falhou. O motivo aparece em "Último erro".
Não configuradoNenhuma loja conectada (ou ela foi desconectada).

Erros comuns e o que fazer#

MensagemPor quêO que fazer
"Para conectar, comece por aqui: clique em “Conectar loja” nesta página."A instalação começou pela Nuvemshop, não pelo painel.Clique em Conectar loja na tela Integração Nuvemshop.
"A autorização precisa terminar no mesmo navegador em que começou. Tente conectar de novo."Você trocou de navegador ou aba anônima no meio do caminho.Faça tudo no mesmo navegador.
"A autorização demorou demais e expirou. Tente conectar de novo."Passou tempo demais na tela da Nuvemshop.Clique em Conectar loja de novo.
"A autorização foi iniciada por outro usuário. Entre com a conta do dono da marca e tente de novo."Outra pessoa estava logada no painel.Entre com a conta do dono e repita.
"Somente o dono da marca pode conectar a loja."Você é da equipe.Peça para o dono conectar.
"Essa loja Nuvemshop já está conectada a outra marca."A mesma loja já está ligada a outra marca na plataforma.Fale com o suporte.
"A Nuvemshop não aceitou a autorização. Tente conectar de novo em instantes."Falha do lado da Nuvemshop.Espere alguns minutos e tente de novo.

Reconectar ou desconectar#

  • Reconectar: refaz a autorização. Use quando aparecer erro de token ou depois de reinstalar o app.
  • Desconectar → Confirmar: remove os webhooks e apaga o token daqui. Os pedidos já sincronizados continuam no painel. Para revogar o acesso de vez, desinstale também o app no painel da Nuvemshop.

Perguntas frequentes#

Os pedidos antigos da loja aparecem?

O painel recebe os pedidos a partir da conexão. A reconciliação olha os pedidos alterados nos últimos 3 dias. E só entram pedidos com cupom ou link do programa. Veja um pedido não apareceu.

Minha loja é Shopify ou outra plataforma. Funciona?

Hoje a plataforma conecta Nuvemshop, Yampi e Yever.

Este artigo ajudou?

Não resolveu?

Fale com a gente. A mensagem já vai com a tela e o artigo, para agilizar o atendimento.

Leia também