# Integração Magazord

![Integração Magazord](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNzFsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--52a23df8acc1782eda33534728795195588657b0/simplesdesk-magazord.png)

Conecte sua loja **Magazord** ao SimplesDesk e resolva no WhatsApp as perguntas que mais chegam no suporte de e-commerce: o Agente de IA localiza o cliente, responde "cadê meu pedido?" com situação e rastreio em tempo real, simula frete por CEP com transportadoras e prazos, busca produtos e ainda registra observações direto no pedido — e os nós de fluxo levam consulta de pedido e cotação de frete para suas automações.

## Quando utilizar

- Sua operação de e-commerce roda no **Magazord** e o time responde status de pedido e rastreio manualmente;
- Você quer que o cliente **simule o frete pelo WhatsApp** antes de fechar a compra — só informando o CEP;
- Atendimento com **Agente de IA** que consulta pedidos, produtos e entrega de ponta a ponta, sem abrir o painel da loja.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **Magazord**.
2. Preencha a **URL da API da loja** — inclua o caminho fornecido pelo Magazord (ex.: `https://minhaloja.painel.magazord.com.br/api`).
3. Preencha o **Token** e a **Senha do token** (credenciais de API geradas no painel do Magazord).
4. Clique em **Conectar** — a integração fica ativa para toda a conta.

Com a loja conectada, duas frentes ficam disponíveis: **Agente de IA** e **nós de fluxo**.

---

## Agente de IA

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

| Capacidade | O que a IA faz |
| --- | --- |
| **Localizar cliente** | Busca o cadastro por CPF/CNPJ ou e-mail e vincula ao contato da conversa |
| **Pedidos do cliente** | Lista os pedidos recentes do cliente vinculado à conversa |
| **Status do pedido** | Consulta a situação de um pedido pelo código, incluindo o rastreio |
| **Rastreio do pedido** | Consulta o histórico completo de rastreio/entrega pelo código do pedido |
| **Simular frete** | Simula o frete para um CEP (com produto e quantidade opcionais) — retorna transportadoras, valores e prazos |
| **Buscar produtos** | Pesquisa o catálogo por nome/termo e retorna preço e disponibilidade |
| **Registrar observação** | Grava uma observação no pedido (ex.: resumo do atendimento, solicitação do cliente) |

> 💡 Ao localizar o cliente, a IA **vincula o cadastro Magazord ao contato** — nas próximas conversas, "meus pedidos" já funciona sem pedir CPF de novo.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **Magazord** — combine com os nós padrão (Enviar Mensagem, Coletar Dados, Condição) para montar autoatendimento sem IA:

- **Consultar pedido** — busca o pedido pelo código (texto ou variável, ex.: {{variables.pedido}} coletado do cliente) e grava situação, total, data e rastreio em variáveis. Saídas **encontrado × não encontrado**. Depois use {{variables.magazord_pedido_situacao}}, {{variables.magazord_pedido_total}}, {{variables.magazord_pedido_data}}, {{variables.magazord_rastreio_codigo}} e {{variables.magazord_rastreio_situacao}}.
- **Simular frete** — simula o frete para um **CEP de destino** (texto ou variável, ex.: {{variables.cep}}), com **id do produto** e **quantidade** opcionais. Grava a melhor opção em {{variables.magazord_frete_valor}}, {{variables.magazord_frete_prazo}} e {{variables.magazord_frete_transportadora}}, além de {{variables.magazord_frete_opcoes}} — um resumo formatado com até 3 opções, pronto para enviar na mensagem. Saídas **encontrado × não encontrado**.

---

## Exemplo 1: "cadê meu pedido?" com a IA

1. Ative o Magazord no assistente e publique-o na inbox do WhatsApp;
2. O cliente pergunta "cadê meu pedido?" — a IA pede o CPF ou o código do pedido;
3. A IA localiza o cliente, consulta o pedido e responde com a situação atual e o último evento do rastreio;
4. Se o cliente pedir algo extra ("entregar na portaria"), a IA registra a observação direto no pedido.

## Exemplo 2: cotação de frete no fluxo

1. No menu principal do fluxo, opção **"Calcular frete"**;
2. **Coletar Dados** pergunta o CEP e salva em {{variables.cep}};
3. Nó **Simular frete** com CEP = {{variables.cep}};
4. Na saída **encontrado**, **Enviar Mensagem**: "Opções de entrega para o seu CEP: {{variables.magazord_frete_opcoes}}" — na saída **não encontrado**, peça o CEP novamente ou transfira para um atendente.

> 📗 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.