# Configuração (/docs/products/configs)

# Configuração de Produtos [#configuração-de-produtos]

**Permissão necessária:** Produtos (`manage_products`).

## Acessando as Configurações [#acessando-as-configurações]

<DiscordSlashCommand
  name="produto"
  subcommand="configurar"
  description="[📦] - Configure um produto cadastrado"
  options={[{ name: "referencia", type: "text" }]}
/>

Informe a referência para abrir o produto direto. Sem referência, o bot mostra a lista de produtos para você escolher.

![Menu de seleção de produtos](/images/products/selecao-produtos.png)

## Menu de Configuração [#menu-de-configuração]

## Experimente o menu [#experimente-o-menu]

Produto de exemplo. Abra uma opção do seletor: título, descrição e valor abrem o formulário; depois de enviar, o rascunho fica ativo e **Salvar Alterações** é liberado.

_(Simulação interativa do menu do bot, disponível na versão HTML desta página.)_

<Accordions>
  <Accordion title="Ver captura de tela do menu real">
    ![Menu de configuração do produto](/images/products/menu-configuracao.png)
  </Accordion>
</Accordions>

Escolha uma opção no seletor **O que deseja alterar?**:

### <FileText className="inline w-5 h-5" /> Alterar título [#-alterar-título]
Nome do produto, com até **40 caracteres**.

### <FileText className="inline w-5 h-5" /> Alterar descrição [#-alterar-descrição]
Texto exibido na mensagem do produto, com até **2000 caracteres**. Aceita a formatação Markdown do Discord.

### <DollarSign className="inline w-5 h-5" /> Alterar valor [#-alterar-valor]
Preço em reais. Aceita formatos como `19,90`, `19.90` ou `R$ 19,90`. O valor deve ser **maior que 0** e **no máximo R$ 999**.

### <Palette className="inline w-5 h-5" /> Alterar cor [#-alterar-cor]
Cor da borda lateral da mensagem. Escolha uma das 25 cores prontas ou informe um código hexadecimal (`#RGB` ou `#RRGGBB`).

### <Package className="inline w-5 h-5" /> Configurar estoque [#-configurar-estoque]
Abre o menu de estoque. Veja [Estoque](/docs/products/stock).

### <Image className="inline w-5 h-5" /> Configurar imagens [#-configurar-imagens]
Até **5 imagens** por produto. Você pode:
- **Enviar arquivos**: até 5 de uma vez, em PNG, JPEG, WEBP ou GIF, com até 5 MB cada. As imagens também são salvas na [galeria](/docs/products/galeria).
- **Adicionar por link**: URL direta de uma imagem (jpg, png ou gif).
- **Escolher da galeria**: usar uma imagem já cadastrada.
- **Alterar** ou **excluir** uma imagem existente.

### <ListTree className="inline w-5 h-5" /> Vincular catálogo [#-vincular-catálogo]
Adiciona o produto a um [catálogo](/docs/products/catalogos). Requer um **plano pago**.

### <MessageSquare className="inline w-5 h-5" /> Configurar mensagens [#-configurar-mensagens]
Lista as mensagens publicadas do produto. Para cada uma, você pode **Abrir mensagem** ou **Desvincular** (a mensagem deixa de ser atualizada pelo bot).

### <Settings className="inline w-5 h-5" /> Configurações extras [#-configurações-extras]
- **Cargo de acesso**: até **5 cargos** que podem comprar o produto. Se ficar vazio, todos podem comprar.
- **Cargo ao comprar**: cargo entregue ao cliente quando a compra é aprovada.

### <Trash2 className="inline w-5 h-5" /> Descartar alterações / Excluir produto [#-descartar-alterações--excluir-produto]
- **Descartar alterações** aparece quando existe um rascunho e apaga as mudanças não salvas.
- **Excluir produto** apaga o produto de forma permanente. Não é possível excluir um produto que está em algum carrinho aberto.

## Botões do menu [#botões-do-menu]

| Botão | Função |
| --- | --- |
| <Sparkles className="inline w-4 h-4" /> **Gerar com IA** | Descreva o produto (até 300 caracteres) e a IA preenche título, descrição e preço. Requer plano pago |
| **Ativar / Desativar** | Produtos desativados não podem ser comprados |
| **Salvar Alterações** | Aplica o rascunho |
| **Menu Principal** / **Voltar** | Navegação |

## Sistema de Rascunho [#sistema-de-rascunho]

Todas as alterações ficam em um **rascunho individual** que dura até **24 horas**. Ao clicar em **Salvar Alterações**:

1. O produto é atualizado.
2. Todas as mensagens do produto e os catálogos vinculados são atualizados.
3. Se o estoque foi reposto, os clientes que clicaram em **Notificar-me** recebem um aviso.

<Callout type="warn" icon={<AlertCircle />}>
  Se você sair sem salvar, as alterações continuam no rascunho até expirarem. Se você sair pelo **Menu Principal**, o bot pede confirmação.
</Callout>

## Dicas [#dicas]

- Use títulos curtos e descrições objetivas.
- A aparência geral do card (estilo, thumbnail, botão) é definida em [Personalização](/docs/configs/customization).

## Próximos Passos [#próximos-passos]

- [Estoque](/docs/products/stock)
- [Catálogos](/docs/products/catalogos)
