Integração Nuvemshop
Conecte sua loja Nuvemshop ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.
Visão geral
Ao integrar a Nuvemshop, o Synchro Hub passa a:
- Receber webhooks de pedidos, pagamentos, cancelamentos e atualizações em tempo real (
order/created,order/paid,order/cancelled,order/updated). - Consolidar cada pedido no dashboard com o valor correto, itens e status financeiro.
Boa notícia: a conexão é 100% por autorização (OAuth). Você não precisa gerar nem copiar nenhuma credencial — basta autorizar o Synchro Hub na sua loja.
Tempo estimado: 3 minutos. O que você vai precisar:
- Uma loja Nuvemshop ativa (Brasil), com acesso de administrador.
- Workspace já criado no Synchro Hub.
Importante: no momento a integração atende lojas da Nuvemshop Brasil. Se a sua loja é de outro país (Tiendanube LATAM), fale com o suporte antes de conectar.
Pré-requisitos
- Estar logado no Synchro Hub com um workspace selecionado.
- Ter acesso ao painel da sua loja em nuvemshop.com.br.
Passo 1 — Conectar a plataforma no Synchro Hub
- No Beacon, acesse Configurações → Integrações → Fontes de Venda.
- Clique em + Adicionar Plataforma.
- Selecione Nuvemshop e clique em Confirmar.
Passo 2 — Autorizar o Synchro Hub na sua loja
- No card da Nuvemshop, clique em Conectar (ou Atualizar credenciais).
- Você é redirecionado para a Nuvemshop. Faça login se necessário.
- Revise as permissões solicitadas (leitura de pedidos) e clique em Autorizar aplicativo.
- A Nuvemshop devolve você ao Beacon com a integração conectada. O card passa a exibir Ativa / Conectado.
Por que autorizar? É essa autorização que dá ao Synchro Hub acesso de leitura aos seus pedidos, com segurança e sem manuseio de tokens. O acesso vale até você desconectar a integração.
Passo 3 — Ativar o webhook (automático)
- No card da Nuvemshop, clique em Configurar Webhook.
- Clique em Ativar Webhook.
O Synchro Hub registra automaticamente os eventos de pedido na Nuvemshop — nenhuma configuração manual é necessária. Ao concluir, o card passa a exibir Webhook ativo.
Verificação
- Gere um pedido de teste na sua loja (uma compra real de valor baixo ou um pedido com cupom de 100%).
- Abra Vendas no menu lateral do Synchro Hub.
- A venda deve aparecer em até 1 minuto após o pagamento.
Limitações conhecidas
- Somente a partir de agora: pedidos anteriores à conexão não são importados. Só valem os eventos recebidos a partir da ativação.
- Apenas Nuvemshop Brasil: lojas de outras regiões (Tiendanube LATAM) ainda não são suportadas.
Solução de problemas
| Sintoma | O que fazer |
|---|---|
| A autorização não conclui | Faça login na Nuvemshop com uma conta de administrador da loja e tente novamente. Contas sem permissão não conseguem autorizar. |
| Nenhuma venda chega após o pagamento | Confirme no card se está Webhook ativo. Se não, clique em Configurar Webhook → Ativar Webhook. |
| Vendas antigas não aparecem | Esperado — a integração é somente a partir da ativação (sem importação retroativa). |
Perguntas frequentes
Tenho vários produtos na mesma loja. Preciso integrar cada um? Não. A integração é por loja. Todos os pedidos daquela loja passam a chegar pela mesma conexão.
Preciso copiar algum token ou API key da Nuvemshop? Não. A conexão é por autorização (OAuth) — você só autoriza o app na sua loja.
Posso reprocessar vendas antigas? Não automaticamente. A integração contabiliza vendas a partir da ativação.
Como desconecto a integração? No card da Nuvemshop, clique em Remover. O acesso do Synchro Hub à sua loja é encerrado.