# Integração Loja Integrada

![Integração Loja Integrada](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNzVsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--10b9be726a01041e1fc0a25f6316b4dc1983fe69/simplesdesk-lojaintegrada.png)

Conecte a **Loja Integrada** ao SimplesDesk e monte a régua de e-commerce completa no WhatsApp: o Agente de IA responde "cadê meu pedido?" com situação e rastreio em tempo real, busca produtos e gera cupons — e cada evento da loja (pedido pago, enviado, entregue, cancelado, carrinho abandonado) pode **iniciar um fluxo automaticamente**, sem você configurar nada na loja: o webhook de pedidos é registrado sozinho ao conectar.

## Quando utilizar

- Sua loja usa a Loja Integrada e você quer **recuperação de carrinho abandonado** pelo WhatsApp;
- Régua de **pós-venda automática**: confirmação quando o pedido é pago, aviso de envio, entrega e cancelamento;
- Atendimento com **Agente de IA** que responde status de pedido, rastreio, preço e estoque sem abrir o painel.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Loja Integrada**.
2. Preencha a **Chave de API** e a **Chave de Aplicação** — as duas ficam em **Configurações → API** no painel da sua loja.
3. Clique em **Testar e conectar** — a conexão é validada e o **webhook de pedidos é registrado automaticamente** na loja.

Ao conectar, dois automatismos já começam a funcionar sozinhos:

- **Etiquetas por situação do pedido** — cada mudança etiqueta o contato: `pedido-aprovado`, `pedido-enviado`, `pedido-entregue`, `pedido-cancelado`;
- **Recuperação de carrinho** — novos abandonos etiquetam o contato com `carrinho-abandonado`; quando a compra acontece, a etiqueta é removida (carrinho recuperado).

---

## Agente de IA

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

| Capacidade | O que a IA faz |
| --- | --- |
| **Localizar cliente** | Busca na loja pelo e-mail (usa o e-mail do contato da conversa por padrão) |
| **Pedidos do cliente** | Lista os pedidos do cliente localizado, com número e situação |
| **Status do pedido** | Consulta pelo número: situação atual, histórico de situações e código de rastreio — o tool do "cadê meu pedido?" |
| **Rastreamento** | Consulta o rastreio em tempo real pelo código de envio e retorna os últimos eventos da entrega |
| **Buscar produtos** | Pesquisa por nome ou SKU e retorna preço e estoque atuais — para responder "tem o produto X?" |
| **Criar cupom** | Gera cupom de uso único por cliente (percentual ou valor fixo), somente dentro das regras de desconto definidas no prompt |

---

## Nós de fluxo

No editor de fluxos, três nós da Loja Integrada:

- **Buscar Cliente (Loja)** — localiza o cliente pelo e-mail (vazio = usa o e-mail do contato da conversa) e grava {{variables.li_cliente_id}} e {{variables.li_cliente_nome}}. Não achou = saída vermelha.
- **Status do Pedido (Loja)** — consulta o pedido pelo número e grava {{variables.li_pedido_situacao}}, {{variables.li_pedido_total}} e {{variables.li_pedido_rastreio}}.
- **Criar Cupom (Loja)** — cria um cupom de uso único por cliente. Configure código (vazio = gera automático), tipo (**porcentagem** ou **valor fixo**), valor e validade em dias. O código fica em {{variables.li_cupom_codigo}} e a validade em {{variables.li_cupom_validade}}.

---

## Eventos de integração: fluxos que disparam sozinhos

No gatilho **Evento de integração**, selecione **Loja Integrada** e escolha o evento que inicia o fluxo — o contato é identificado automaticamente e o payload vira variáveis (selecione também a **inbox** por onde a conversa será criada):

| Evento | Quando dispara |
| --- | --- |
| **Pedido pago** | Pagamento aprovado na loja |
| **Pedido enviado** | Pedido despachado |
| **Pedido entregue** | Entrega confirmada |
| **Pedido cancelado** | Pedido cancelado |
| **Carrinho abandonado** | Novo abandono de carrinho detectado |

Variáveis nos eventos de pedido: {{variables.li_pedido_numero}} · {{variables.li_situacao}} · {{variables.li_total}} · {{variables.li_cliente_id}}. No carrinho abandonado: {{variables.li_cliente_email}} · {{variables.li_cliente_nome}}.

### Exemplo: régua pós-venda completa

1. **Fluxo 1 — confirmação**: gatilho **Evento de integração** + **Pedido pago** → **Enviar Mensagem**: "Pagamento confirmado! 🎉 Seu pedido #{{variables.li_pedido_numero}} de R$ {{variables.li_total}} já está em preparação.";
2. **Fluxo 2 — envio**: evento **Pedido enviado** → mensagem com o nó **Status do Pedido (Loja)** para incluir {{variables.li_pedido_rastreio}};
3. **Fluxo 3 — recuperação**: evento **Carrinho abandonado** → nó **Criar Cupom (Loja)** com 10% e 7 dias → **Enviar Mensagem**: "Oi {{variables.li_cliente_nome}}, seu carrinho está te esperando! Use o cupom {{variables.li_cupom_codigo}} e finalize sua compra 😉".

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de evento de integração.

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