#Integrar Nuvemshop

Clique em Conectar com a Nuvemshop, aprove o acesso no painel da sua loja e pronto: os pedidos passam a criar ou atualizar contatos (com a tag nuvemshop), registrar vendas e disparar automações. Não há token para copiar nem webhook para cadastrar — a Clickmax registra tudo sozinha na sua loja.

Antes de começar

• Papel de workspace: Proprietário, Administrador, Editor ou Colaborador. Os papéis Financeiro, Convidado e Atendente não têm acesso a Integrações.
• Na Nuvemshop você precisa conseguir entrar no painel da loja e aprovar a instalação de aplicativos.

#Passo a passo

1. Na Clickmax, abra Integrações e selecione o card Nuvemshop.
2. Clique em Conectar com a Nuvemshop.
3. Você é levado ao painel da Nuvemshop. Faça login, se ainda não estiver logado.
4. Revise as permissões e aprove a instalação. A Clickmax pede apenas leitura de pedidos, clientes e produtos — ela não altera nada na sua loja.
5. Você volta para Integrações com a mensagem Nuvemshop conectada e a integração já aparece na lista, com o nome da sua loja.

Pronto. A partir daí os eventos da loja chegam sozinhos.

#Instalar pela Nuvemshop

Também dá para começar pelo lado da Nuvemshop, instalando o aplicativo Clickmax pelo painel da sua loja:

1. Aprove a instalação na Nuvemshop.
2. Você chega na tela Conecte sua loja Nuvemshop à Clickmax. Clique em Entrar na minha conta ou, se ainda não tem conta, em Criar conta na Clickmax.
3. Se tiver mais de um workspace, escolha em qual a loja vai entrar.
4. Confira a loja e o workspace e clique em Conectar a este workspace.

Ao criar a conta, confirme o e-mail no mesmo navegador: depois do questionário inicial da conta nova, você volta direto para a etapa 4. O link de instalação vale por 24 horas. Se ele expirar (ou se você confirmar o e-mail em outro aparelho), abra o aplicativo Clickmax de novo no painel da Nuvemshop para gerar outro.

Abrir o aplicativo de novo numa loja que já está conectada não duplica nada: só renova o acesso e você volta para Integrações.

#O que passa a chegar

Cada evento com e-mail cria ou atualiza um contato com a tag nuvemshop, registra uma atividade no histórico do contato e pode disparar automações. Parte deles também registra uma venda.

Pontos que costumam gerar dúvida:

• Carrinho abandonado dispara quando o comprador começa o checkout, e não depois de um tempo sem comprar — a Nuvemshop não avisa o abandono com atraso. Na automação de recuperação, coloque uma espera antes da primeira mensagem e use Nuvemshop — Pedido pago como gatilho de saída, para quem concluir a compra não receber a cobrança.
• Reembolso e chargeback chegam pela mudança de status do pedido. Quando a Nuvemshop marca o pedido como reembolsado ou com chargeback, a mesma venda muda de status — não é criada outra.
• Reembolso não muda o valor da venda. Um reembolso parcial marca a venda como Reembolsada mantendo o total do pedido.
• Pedido ainda não pago entra como Aguardando (pix, boleto). Quando o pagamento é confirmado, a mesma venda passa a Aprovada. Pedido que já nasce pago entra direto como Aprovada.
• Venda com status Aguardando não conta como faturamento. Os indicadores de receita, o ticket médio e o LTV do contato somam apenas vendas aprovadas.
• Uma venda por pedido, não por produto. Um pedido com três produtos gera uma venda com o total do pedido e três atividades no histórico do contato, uma por produto.
• Pedido pago marca o contato como cliente.
• Pedidos sem e-mail são ignorados, porque sem e-mail não é possível identificar o contato.

#Filtro por produto

Nos gatilhos você pode filtrar pelo produto: a Clickmax lista os produtos direto da sua loja. O gatilho dispara se o produto escolhido estiver em qualquer item do pedido ou do carrinho. O gatilho de cliente cadastrado não tem filtro de produto — não há pedido nesse evento.

#Desconectar

• Pela Clickmax: exclua a integração em Integrações. A Clickmax remove os webhooks da sua loja e para de receber eventos.
• Pela Nuvemshop: desinstale o aplicativo no painel da loja. A integração é arquivada na Clickmax automaticamente.

Contatos, vendas e atividades já recebidos continuam na sua conta nos dois casos. Para voltar a receber, conecte de novo (pelo botão ou instalando o aplicativo pela Nuvemshop): a integração anterior da loja é reativada no mesmo workspace, sem duplicar.

#Relacionados

• Todas as integrações
• Criar sua primeira automação — reaja aos pedidos da sua loja
• Integrar Shopify

#Se não funcionou

• Apareceu "Conexão cancelada": você não aprovou o acesso no painel da Nuvemshop. Clique em Conectar com a Nuvemshop de novo e aprove.
• Apareceu "Não foi possível conectar a Nuvemshop": tente novamente em alguns minutos. Se o erro continuar, fale com o suporte.
• Apareceu "Este link de instalação expirou": o link vale 24 horas e uma única vez. Abra o aplicativo Clickmax de novo no painel da Nuvemshop.
• Apareceu "Você não pode conectar integrações neste workspace": seu papel não permite. Peça a um administrador para concluir ou clique em Usar outro workspace.
• Nenhum evento chega: confira se a integração está ativa em Integrações e se o aplicativo continua instalado na sua loja. Se você desinstalou o app, conecte de novo pelo botão.
• Um pedido específico não chegou: pedidos sem e-mail do comprador são descartados. Confira o pedido no painel da Nuvemshop.