Conecte sua loja Nuvemshop para centralizar pedidos, automações por status, widget da loja e auditoria de webhooks no mesmo painel. Depois da autorização, a plataforma já prepara a base da integração automaticamente para você seguir apenas com os ajustes operacionais.
Requisitos
- Loja Nuvemshop ativa e acesso de administrador para autorizar o app
- Conector Nuvemshop liberado/ativo na sua conta CloudWhats
- Pelo menos um número de WhatsApp ativo no painel
- Um widget ativo com token gerado se você quiser exibir o chat na loja
- Templates aprovados no WhatsApp se for usar automações de pedidos
Produtos no catálogo Meta são opcionais
A sincronização de produtos só é necessária se você quiser enviar itens da loja pelo catálogo Meta dentro do WhatsApp. Pedidos, webhooks e automações de status podem funcionar sem essa etapa.
Conectar a Nuvemshop
Abra o catálogo de conectores
Configurações → Conectores
Localize Nuvemshop no catálogo e clique em Conectar.
Autorize sua loja na Nuvemshop
OAuth seguro
Faça login na loja, revise as permissões solicitadas e conclua a autorização do aplicativo.
Aguarde a preparação automática
Pós-conexão
Após o retorno da autorização, a CloudWhats salva a loja, ativa o conector, registra os webhooks necessários e inicia a sincronização inicial de pedidos e clientes em segundo plano.
Se já existir um token de widget ativo no tenant, a plataforma pode vinculá-lo automaticamente à loja para acelerar a configuração inicial. Mesmo assim, vale revisar manualmente a aba Loja & Widget antes de publicar.
Configurar após a conexão
Loja & Widget
Revise os dados da loja conectada, force uma sincronização manual quando precisar e escolha qual widget será exibido no storefront. O script do widget é publicado tecnicamente pela plataforma; você só precisa garantir que o widget escolhido tenha token ativo.
Automações
Configure mensagens para eventos como pós-compra, pedido pago, enviado, entregue, cancelado, primeira compra, novo cliente e carrinho abandonado. Para ativar uma automação, selecione um número de WhatsApp, escolha um template aprovado e, quando houver variáveis, faça o mapeamento dos dados do pedido.
Você também pode ajustar a janela de prevenção de duplicidade para evitar mensagens repetidas quando a Nuvemshop enviar múltiplos eventos próximos.
Mapeamento, produtos, pedidos e auditoria
- Mapeamento: defina a direção da sincronização, o mapeamento de status e como campos como rastreio, notas internas e histórico devem se comportar.
- Produtos: se quiser usar catálogo Meta no WhatsApp, vincule um número que já tenha Meta Catalog configurado e execute a sincronização manual dos produtos.
- Pedidos: acompanhe pedidos sincronizados, filtre por status e pesquise por pedido, cliente ou e-mail.
- Auditoria: revise a saúde dos webhooks, veja eventos recebidos e re-registre webhooks se houver pendências.
Boas práticas e observações importantes
- Revise o widget vinculado antes de publicar o chat na loja.
- Use templates aprovados e específicos para cada etapa do pedido para reduzir rejeição e ruído operacional.
- Mantenha a Nuvemshop como origem dos produtos sempre que o checkout da loja for a fonte principal dos pedidos.
- Confira a aba Auditoria sempre que alguma automação parecer “silenciosa” demais — normalmente o primeiro lugar para achar a pista certa.
Carrinho abandonado não é webhook nativo
A recuperação de carrinho abandonado não depende de um webhook nativo da Nuvemshop. O sistema verifica checkouts periodicamente, então esse tipo de automação pode levar alguns minutos para aparecer e respeita o tempo mínimo de abandono configurado.
Desconexão da loja
Ao desconectar a Nuvemshop, a plataforma remove webhooks e interrompe sincronizações e automações dependentes desse conector até uma nova conexão.