For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Veja essas ações passo a passo em Exemplos de uso.

🧠 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?"

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.

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

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.

Last updated