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.
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#
- Entre na sua conta Nuvemshop no mesmo navegador.
- 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?".
- No card Nuvemshop, clique em Conectar loja.
- Na tela Integração Nuvemshop, clique em Conectar loja de novo.
- Na Nuvemshop, aprove as permissões do app Hub Embaixadores (ler pedidos e produtos, criar cupons).
- Você volta para o painel com a mensagem "Loja conectada! Pedidos e cupons já estão ligados à sua loja."
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#
| Status | Significado |
|---|---|
| Conectado | A loja está ligada e o token está salvo. |
| Erro | A última operação com a Nuvemshop falhou. O motivo aparece em "Último erro". |
| Não configurado | Nenhuma loja conectada (ou ela foi desconectada). |
Erros comuns e o que fazer#
| Mensagem | Por 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.

