# Botão Mágico

Guias sobre o Botão Mágico — cadastro de produto assistido por IA no painel do lojista.

# Botão Mágico (v2): como cadastrar produtos com IA

O **Botão Mágico** é a forma mais rápida de cadastrar um produto: você manda uma descrição e até 3 fotos, e a IA gera título, descrição completa, categoria sugerida e **3 fotos de catálogo** (estúdio, ambiente e modelo/lifestyle). No final, você revisa tudo e decide se publica ou salva como rascunho.

O uso é debitado da sua **cota mensal grátis** do plano, ou cobrado avulso quando a cota do ciclo já acabou — o consumo aparece em **Financeiro → Extrato**.

## 1. Preenchendo o pedido

<table id="bkmrk-descreva-o-produtote"><tbody><tr><td>**Descreva o produto**</td><td>Texto livre: material, medidas, cores, o que mais souber sobre o produto. Mínimo de 10 caracteres.</td></tr><tr><td>**Estoque (opcional)**</td><td>Também em texto livre, do jeito que você fala — ex.: "3 de cada cor, exceto Preto/38 que tem 0". A IA interpreta esse texto e distribui a quantidade nas variantes certas.</td></tr><tr><td>**Fotos**</td><td>Envie até 3 fotos do produto (referência real) — a IA usa como base pra gerar as fotos de catálogo. Se enviar mais de 3, só as 3 primeiras são usadas.</td></tr></tbody></table>

Clique em **"Gerar produto"**. A geração leva cerca de 30-60 segundos — dá pra continuar navegando, o resultado fica salvo e aparece na aba **Histórico** assim que terminar.

## 2. Revisando o resultado

Quando a geração termina, aparecem:

- **Título** e **Descrição** — editáveis livremente antes de cadastrar. Se a IA sugeriu uma categoria, ela aparece do lado da descrição.
- **3 fotos geradas** — Estúdio, Ambiente e Modelo/Cenário. Clique numa foto pra ampliar ou baixar. Marque qual delas será a **foto principal** do anúncio.

### Pedindo retake de uma foto

Se alguma foto saiu errada (fundo ruim, corte errado, etc.), clique em **"Retake"** na foto, escreva o que precisa ajustar (ex.: "fundo mais claro", "não cortar a alça") e clique em **"Gerar novamente"**. Cada retake é **cobrado como imagem extra** no extrato — as versões anteriores ficam salvas e navegáveis (aparece "v1/2", "v2/2" etc. embaixo da foto).

### Foto por cor (produtos com variação de cor)

Se o produto tem uma dimensão "Cor", aparece uma seção pra gerar uma versão da foto de estúdio recolorida pra cada cor. Clique em **"Gerar foto desta cor"**, opcionalmente descreva o tom exato (ex.: "azul marinho escuro, não royal") e gere. Cores sem foto própria simplesmente usam a foto de estúdio genérica no cadastro — não é obrigatório gerar foto de todas as cores.

## 3. Ajustando o estoque por variante

Se o produto tiver variações (tamanho, cor etc.), aparece uma lista com uma combinação por linha (ex.: "Azul / P") e um campo de quantidade — já vem preenchido a partir do que você escreveu no campo de estoque no início, mas pode ajustar cada valor manualmente antes de cadastrar.

## 4. Finalizando o cadastro

Duas opções:

- **Finalizar e Publicar** — o produto vai direto pro ar, visível na loja.
- **Finalizar e Salvar como Rascunho** — o produto é criado mas fica invisível pra clientes até você revisar e publicar manualmente depois, em Produtos.

Depois de finalizado, a tela mostra o ID do produto criado e um aviso de que ele já está em **Produtos** no menu do painel — a partir daí, título, descrição, fotos e estoque não são mais editáveis por essa tela (edite direto no produto).

## Histórico e recuperação

A aba **Histórico** lista as gerações anteriores (concluídas, em processamento ou com erro), com um marcador "cadastrado" pras que já viraram produto. Clique em qualquer uma pra reabrir e continuar de onde parou.

Também dá pra baixar o resultado de uma geração como **JSON** (botão "Baixar JSON") e depois recarregá-lo em outra sessão pelo botão **"Enviar JSON de uma geração anterior"** — útil como backup ou pra continuar em outro computador.

## Preços e cota grátis

Cada plano tem uma **cota mensal grátis** de gerações completas do Botão Mágico (renovada a cada ciclo de cobrança). Fora isso, o uso extra é cobrado avulso e lançado direto no seu **Financeiro → Extrato**:

<table id="bkmrk-planogera%C3%A7%C3%B5es-gr%C3%A1tis"><tbody><tr><td>**Plano**</td><td>**Gerações grátis por mês**</td></tr><tr><td>Grátis</td><td>3</td></tr><tr><td>Básico</td><td>5</td></tr><tr><td>Pro</td><td>10</td></tr><tr><td>Avançado</td><td>15</td></tr><tr><td>Personalizado</td><td>combinado com o suporte</td></tr></tbody></table>

<table id="bkmrk-o-quepre%C3%A7ogera%C3%A7%C3%A3o-co"><tbody><tr><td>**O que**</td><td>**Preço**</td></tr><tr><td>Geração completa (título, descrição, categoria + as 3 fotos), fora da cota grátis</td><td>R$ 15,00 por produto</td></tr><tr><td>Retake de uma foto (pedir refazer estúdio/ambiente/modelo)</td><td>R$ 5,00 por imagem</td></tr><tr><td>Foto extra por cor de variante</td><td>R$ 5,00 por imagem</td></tr><tr><td>Vídeo do produto *(em breve)*</td><td>R$ 120,00 por vídeo</td></tr></tbody></table>

Ou seja: enquanto a geração inicial (o produto completo, com as 3 fotos) conta pra cota grátis do plano ou custa R$ 15, cada retake ou foto de cor adicional depois disso é sempre cobrado à parte, R$ 5 cada — independente de ter cota disponível ou não.

## Em breve: vídeo do produto

Está sendo preparada a geração de **vídeo do produto** pelo Botão Mágico, com preço já definido em R$ 120,00 por vídeo — ainda não disponível na tela atual, mas em breve deve aparecer como uma nova opção ao lado das fotos geradas.