# Integração Nuvemshop

![Integração Nuvemshop](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBN3hsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9a690414a0015b38ce2e4df43fb3c31c301942a7/simplesdesk-nuvemshop.png)

Conecte sua loja **Nuvemshop** ao SimplesDesk e transforme o WhatsApp no braço de vendas e pós-venda do seu e-commerce: o Agente de IA responde "cadê meu pedido?" com rastreio em tempo real, busca produtos com preço e estoque e cria cupons de desconto — enquanto as fontes de contatos alimentam réguas automáticas de carrinho abandonado, confirmação de compra, cobrança de PIX/boleto e aviso de envio.

## Quando utilizar

- Sua loja roda na Nuvemshop e o suporte responde **"cadê meu pedido?"** todos os dias;
- Você quer **recuperar carrinhos abandonados** automaticamente pelo WhatsApp — inclusive com cupom de desconto gerado na hora;
- Réguas de pós-venda: **confirmação de compra**, **lembrete de PIX/boleto pendente** e **aviso de envio com código de rastreio**.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Nuvemshop**.
2. Preencha o **ID da Loja (store_id)** — é o número da loja (o `user_id` retornado na autorização do app).
3. Preencha o **Access Token** — gerado na instalação do app na sua loja (não expira).
4. Clique em **Validar e conectar** — a conexão é testada antes de salvar e fica ativa para toda a conta.

Com a loja conectada, três frentes ficam disponíveis: **Agente de IA**, **nós de fluxo** e **fontes de contatos para disparos agendados**.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative a Nuvemshop. A IA passa a fazer:

| Capacidade | O que a IA faz |
| --- | --- |
| **Localizar cliente** | Busca na loja por e-mail, nome ou CPF/CNPJ — sempre antes de consultar pedidos |
| **Pedidos do cliente** | Lista os pedidos do cliente localizado, com status, pagamento, envio e rastreio |
| **Status do pedido** | Consulta pelo número (ex.: 1234): situação, pagamento, envio e código de rastreio |
| **Buscar produtos** | Pesquisa o catálogo por nome, tag ou SKU — retorna preço, estoque e link de compra |
| **Criar cupom** | Gera cupom percentual de uso único com validade, para recuperar carrinho ou reter o cliente |

> 💡 O desconto do cupom é limitado por um **teto configurável** nas configurações do assistente (padrão **15%**) — a IA nunca decide sozinha um desconto acima do permitido pelo lojista.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **Nuvemshop**:

- **Consultar pedido** — busca o pedido pelo número (texto ou variável, ex.: {{variables.pedido}} coletado do cliente) e grava os dados em variáveis. Saídas **encontrado × não encontrado**. Depois use {{variables.nuvemshop_pedido_status}}, {{variables.nuvemshop_pagamento_status}}, {{variables.nuvemshop_envio_status}}, {{variables.nuvemshop_rastreio}}, {{variables.nuvemshop_total}} e {{variables.nuvemshop_cliente_nome}}.
- **Criar cupom** — cria um cupom percentual de uso único na loja. Configure o **desconto (%)**, a **validade em dias** (padrão 7) e, opcionalmente, o **valor mínimo do pedido**. O código gerado fica em {{variables.nuvemshop_cupom_codigo}} (com {{variables.nuvemshop_cupom_percentual}} e {{variables.nuvemshop_cupom_validade}}).

---

## Fontes de contatos: 4 réguas prontas

No gatilho **Disparo agendado**, a Nuvemshop oferece **quatro fontes** — cada uma busca os registros do período e dispara o fluxo para cada contato (o mesmo carrinho/pedido nunca dispara duas vezes na mesma régua):

| Fonte | Para quê |
| --- | --- |
| **Carrinhos abandonados** | Recuperação de carrinho — checkouts abandonados dos últimos N dias |
| **Pedidos pagos** | Confirmação de compra, pós-venda, pedido de avaliação, upsell |
| **Pagamento pendente** | Lembrete de PIX/boleto aguardando ou cartão em análise |
| **Pedidos enviados** | Aviso de envio com código e link de rastreio |

Todas têm a configuração **"últimos (dias)"**. Variáveis disponíveis nas mensagens e condições:

- **Carrinhos abandonados**: {{variables.nuvemshop_cliente_nome}} · {{variables.nuvemshop_checkout_url}} (link para concluir a compra) · {{variables.nuvemshop_total}} · {{variables.nuvemshop_produtos}} · {{variables.nuvemshop_checkout_id}}
- **Fontes de pedidos**: {{variables.nuvemshop_cliente_nome}} · {{variables.nuvemshop_pedido_numero}} · {{variables.nuvemshop_total}} · {{variables.nuvemshop_produtos}} · {{variables.nuvemshop_status_pagamento}} · {{variables.nuvemshop_status_envio}} · {{variables.nuvemshop_rastreio_codigo}} · {{variables.nuvemshop_rastreio_url}}

### Exemplo 1: recuperação de carrinho abandonado

1. Gatilho **Disparo agendado** (ex.: todos os dias às 10h) + fonte **Nuvemshop — Carrinhos abandonados** (últimos 1 dia);
2. Nó **Criar cupom** com 10% de desconto e 7 dias de validade;
3. **Enviar Mensagem**: "Oi {{variables.nuvemshop_cliente_nome}}! Você deixou {{variables.nuvemshop_produtos}} no carrinho. Use o cupom {{variables.nuvemshop_cupom_codigo}} e finalize aqui: {{variables.nuvemshop_checkout_url}}".

### Exemplo 2: aviso de pedido enviado

1. Gatilho **Disparo agendado** + fonte **Nuvemshop — Pedidos enviados**;
2. **Enviar Mensagem**: "Boa notícia, {{variables.nuvemshop_cliente_nome}}! Seu pedido #{{variables.nuvemshop_pedido_numero}} foi enviado 🚚 Acompanhe: {{variables.nuvemshop_rastreio_url}}".

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de disparo agendado.

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.