Guia de Integração: Nuvemshop

Conecte a sua loja virtual da Nuvemshop ao Conversaas de forma nativa e impulsione suas conversões sem necessidade de instalar códigos customizados ou mexer na programação do seu site.

1. Pré-Requisitos

• Loja ativa na plataforma Nuvemshop.
• Acesso à conta administrador da loja na Nuvemshop para instalar aplicativos de integração.

2. Instalação

1. Acesse o seu painel da Nuvemshop e vá até a seção Aplicativos.
2. O aplicativo oficial do Conversaas possui o App ID 29330. Procure por Conversaas na galeria.
3. Clique em Instalar Aplicativo.
4. Você será redirecionado para o painel do Conversaas para confirmar a autorização.
5. Após o login e confirmação no Conversaas, a sua loja estará conectada e mostrará o status Conectado na aba de Integrações.

3. Funcionalidades Disponíveis

• Recuperação de Carrinho Abandonado: [DISPONÍVEL] Captura automatizada de carrinhos sem checkout finalizado na Nuvemshop.
• Notificações de Pedido: [DISPONÍVEL] Informações enviadas ao cliente assim que o pagamento é aprovado e quando muda o status de envio.
• Consulta de Catálogo pelo Agente: [DISPONÍVEL] O agente analisa os produtos em sua loja via API (busca, preço, estoque) para tirar dúvidas dos clientes.

4. Webhooks

Os webhooks são configurados de maneira transparente quando você autoriza o aplicativo na Nuvemshop. O fluxo envia eventos nativos gerados pelo e-commerce.

Exemplo de payload de pedido recebido do webhook da Nuvemshop:

{
  "store_id": 12345,
  "event": "order/paid",
  "id": 987654
}

A partir deste ID no payload, o backend do Conversaas resgata os detalhes completos de itens no pedido para enviar a notificação ao cliente.

5. Testando a Integração

1. Dentro da sua loja Nuvemshop, na aba administrativa, adicione um pedido manual de simulação.
2. Mude o status do pedido para "Pagamento Recebido" usando os dados de um cliente teste seu (com o seu número de WhatsApp válido e formato nacional).
3. Verifique se a plataforma entregou a notificação para o Conversaas (Painel Conversaas > Logs/Campanhas).
4. O seu WhatsApp deverá receber a notificação sobre a alteração do pedido.

6. Perguntas Frequentes da Integração

A integração afeta a performance da loja?
Não. A integração da Nuvemshop utiliza a API REST oficial e webhooks assíncronos. Nenhum script de performance pesada é inserido na vitrine da loja. O carregamento será idêntico para o cliente comprador.

O que acontece se a loja ficar offline?
A Nuvemshop possui alta disponibilidade, mas caso ocorram paradas curtas, os webhooks continuarão enfileirados. O Conversaas não terá o serviço de assistente interrompido.

Como desativar temporariamente sem perder a configuração?
Vá ao seu painel administrativo no Conversaas (Integrações > Nuvemshop) e clique na chave "Desativar Integração/Pausar". Não há necessidade de desinstalar o app na própria loja Nuvemshop para pausar temporariamente as notificações e regras ativas.