> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/assistente-ia-mcp/o-que-pedir.md).

# O que pedir

Depois de conectar, você conversa em **português normal** — o assistente escolhe o que buscar, lê os dados da sua loja e responde. Abaixo, exemplos do que você pode pedir em cada assunto.

## 📦 Produtos

* "Liste os produtos da minha loja."
* "Quantos produtos eu tenho cadastrados no total?"
* "Me mostre os 10 produtos mais caros."
* "Qual o preço e o estoque do produto com SKU RE152?"
* "Procure produtos com 'vestido' no nome."
* "Detalhe o produto de código 1283555 — quero ver descrição, preço e fotos."
* "Quais produtos estão desativados?"
* "Tem algum produto com estoque zerado?"
* "Compare o preço normal e o promocional dos meus produtos e me diga onde o desconto é maior."
* "Quais produtos pertencem ao departamento 'Cafeteiras'?"
* "Me dá a lista de SKUs e preços em formato de tabela."

## 🛒 Pedidos

* "Mostre meus últimos pedidos."
* "Quantos pedidos eu tenho no total?"
* "Liste os pedidos com pagamento confirmado."
* "Quais pedidos foram feitos entre 01/06 e 30/06?"
* "Me mostre os detalhes do pedido 3667015."
* "Qual o valor total, o frete e a forma de pagamento do pedido 3667015?"
* "Quais itens tem no pedido 3667015 e em que quantidade?"
* "Tem algum pedido que veio de marketplace?"
* "Liste os pedidos do cliente de código 123."
* "Qual o ticket médio dos meus últimos pedidos?"
* "Quais pedidos ainda estão aguardando pagamento?"

## 👥 Clientes

* "Liste meus clientes."
* "Quantos clientes eu tenho cadastrados?"
* "Procure o cliente pelo e-mail <fulano@email.com>."
* "Detalhe o cliente de código 456 — quero nome, telefone e endereço."
* "Quais clientes são pessoa jurídica (CNPJ)?"
* "Me mostre os clientes com telefone e e-mail para eu montar uma lista de contato."

## 🎟️ Cupons de desconto

* "Tenho algum cupom de desconto ativo?"
* "Liste todos os meus cupons."
* "Procure o cupom pela palavra 'natal'."
* "Detalhe o cupom de código 789."

## 🗂️ Departamentos (categorias)

* "Quais departamentos/categorias existem na minha loja?"
* "Me mostre a estrutura de categorias (quais são subcategorias de quais)."
* "Quantos departamentos eu tenho?"
* "Detalhe o departamento de código 44086."

## 📧 Newsletter

* "Quantas pessoas estão inscritas na minha newsletter?"
* "Liste os e-mails inscritos na newsletter."
* "Procure na newsletter pelo e-mail <contato@empresa.com>."

## 🔔 Webhooks

* "Quais webhooks estão configurados na minha loja?"
* "Que tipos de eventos eu posso assinar por webhook?"
* "Detalhe o webhook de código 5."

## ⚙️ Informações da loja

* "Quais formas de entrega estão ativas na minha loja?"
* "Quais formas de pagamento eu aceito?"
* "Quais são os status de pedido possíveis na plataforma?"

## ✍️ Ações que alteram a loja

Além de consultar, o assistente também **executa mudanças** — sempre pedindo **confirmação** antes. Exemplos:

* "Altere o estoque do SKU RE152 para 100 unidades."
* "Edite o produto 1283555 e desative ele."
* "Mude o status do pedido 3667015 para 'Enviado' e avise o cliente por e-mail."
* "No pedido 3667015, informe o código de rastreamento AB47859625SA."
* "Informe a nota fiscal do pedido 3667015 (número, série, data e chave)."
* "Cancele o pedido 4974307."
* "Crie um cupom DIAMULHER com 10% de desconto, válido este mês."
* "Cadastre um departamento chamado 'Promoções'."
* "Inscreva o e-mail <contato@empresa.com> na newsletter."
* "Crie um webhook que avise a URL X quando um pedido for pago."

{% hint style="warning" %}
**O assistente não exclui nada.** Cadastrar e editar, sim; **apagar** registros, não. E toda ação que muda a loja — principalmente as **irreversíveis**, como cancelar um pedido — passa por uma **confirmação** antes de ser executada.
{% endhint %}

Veja essas ações passo a passo em [Exemplos de uso](/assistente-ia-mcp/exemplos-de-uso.md).

## 🧠 Perguntas que combinam várias fontes

O assistente pode cruzar dados de mais de um lugar numa única resposta:

* "Faça um resumo da minha loja: quantos produtos, pedidos e clientes eu tenho."
* "Quais foram meus pedidos pagos e qual o faturamento total deles?"
* "Liste os produtos mais caros e me diga quais deles já foram vendidos em algum pedido."
* "Monte um relatório: total de pedidos por status."
* "Quais clientes fizeram pedidos acima de R$ 1.000?"
* "Analise meus produtos e sugira quais estão sem estoque e precisam de reposição."
* "Do total de inscritos na newsletter, quantos também são clientes cadastrados?"

{% hint style="info" %}
Como as listagens são paginadas, para números totais o assistente pode precisar percorrer várias páginas. Se você tem muitos registros, peça um **período** ou um **filtro** (status, data, busca) para respostas mais rápidas.
{% endhint %}

## 💡 Dicas para perguntas melhores

* **Seja específico com códigos e filtros:** "detalhe o pedido 3667015" é mais direto que "me mostre um pedido".
* **Peça o formato que preferir:** "em tabela", "só os nomes e preços", "resumido".
* **Encadeie:** faça uma pergunta ampla e depois refine — "e desses, quais são de marketplace?".
* **Datas:** use `DD/MM` ou `AAAA-MM-DD`; para pedidos, dá para filtrar por período.
* **Grandes volumes:** filtrar por status, data ou busca deixa a resposta mais rápida e precisa.

{% hint style="info" %}
Lembre-se: o assistente **não exclui** nada. Ele consulta, cadastra e edita — mas **apagar** registros (produtos, cupons, webhooks, clientes...) não é permitido. Para isso, use o painel da loja.
{% endhint %}