# Canais de venda

Venda os produtos da loja pelo Discord da cidade, com painel fixo ou vitrines, carrinho em canal privado e pagamento pelo link da loja.

Source: https://fivedash.fivex.gg/docs/pt/store/sales-channels

Os canais de venda levam a loja para onde os jogadores já estão. No Discord, o bot da cidade publica a loja num painel fixo ou em vitrines espalhadas pelos canais, e cada comprador monta o pedido num carrinho privado. O catálogo, os preços, os cupons e os criadores são os mesmos do site. Tudo fica em **Loja → Canais de venda**.

## Antes de começar

* **Plano:** a página **Canais de venda** faz parte do plano **Pro** ou superior.
* **Bot do Discord:** a loja vende pelo bot deste servidor. Se ele não estiver configurado, a página mostra **Conecte o bot do Discord primeiro** com o botão **Configurar o bot**. Se o Discord recusou o token, aparece **O Discord recusou o token do bot** com **Trocar o token**.
* **Permissões do bot:** ele precisa enviar mensagens no canal do painel e das vitrines e criar canais na categoria dos carrinhos.
* **Pagamentos:** para o comprador conseguir pagar, a loja precisa estar recebendo pagamentos. Veja [Pagamentos](https://fivedash.fivex.gg/docs/pt/store/payments).
* **Permissões** (área **Canais de venda**):

| Ação                          | Nível          |
| ----------------------------- | -------------- |
| Canais e carrinhos abertos    | **Ver**        |
| Painel e carrinhos do Discord | **Configurar** |

> O cartão **WhatsApp** aparece como **Em breve**. Por enquanto, o canal de venda disponível é o Discord.

## Abrir a loja no Discord

### Abra a página

Vá em **Loja → Canais de venda**. Em **Loja no Discord**, ligue a chave (ela passa de **Desativado** para **Ativo**).

### Escolha o formato

Em **Como vender → Formato**, escolha **Painel principal** (uma mensagem fixa num canal, com todas as categorias numa lista) ou **Vitrines** (mensagens em vários canais, cada uma com os produtos ou categorias que você escolher).

### Escolha onde a compra acontece

Em **Onde a compra acontece**, escolha **Pelo Discord** (carrinho num canal privado) ou **Pelo site** (os botões levam ao produto ou à categoria no site da loja).

### Escolha o canal

No formato **Painel principal**, escolha o **Canal do painel**. No formato **Vitrines**, crie pelo menos uma vitrine em **Nova vitrine**.

### Configure o carrinho

Se a compra for **Pelo Discord**, escolha a **Categoria dos carrinhos** e revise as opções de **Carrinho**, **Descontos**, **Comprador** e **Ofertas**.

### Salve

Clique em **Salvar**. O bot publica o painel (ou as vitrines) e o aviso **Loja aberta no Discord** mostra onde ele está. Use **Abrir no Discord** para ver a mensagem.

> Salvar publica o painel de novo com as mudanças. Trocar o formato tira as mensagens do outro formato ao salvar.

## Como o jogador compra pelo Discord

1. No painel, o jogador escolhe uma categoria na lista. Ele recebe uma resposta que só ele vê, com os produtos dela.
2. Ele escolhe um produto e clica em **Adicionar ao carrinho**. O bot cria um canal privado só dele (por exemplo `#carrinho-jogador`), dentro da **Categoria dos carrinhos**.
3. No carrinho, ele usa **Adicionar produtos**, **Cupom**, **Código de criador**, **Presentear** ou **Cancelar carrinho**, e muda a quantidade ou remove itens pela lista.
4. No primeiro carrinho, se **Dados do comprador** estiver ligado, o bot pede nome, sobrenome, e-mail e CPF. Os dados ficam salvos para as próximas compras.
5. Ele clica em **Ir para o pagamento** e depois no botão de pagar (padrão `Pagar {total}`). O botão abre a página de pagamento do FiveDash, com o carrinho e o preço atual da loja.
6. Na página, ele escolhe a forma de pagamento: o Pix aparece ali mesmo, com QR Code e **Pix copia e cola**; o cartão é pago no site do provedor. Se precisar, a página pede o ID na cidade de quem recebe.
7. Pago, o carrinho mostra **Pagamento aprovado** e o canal fecha sozinho em alguns minutos. A entrega na cidade começa na hora.

O link de pagamento vale enquanto o carrinho estiver aberto. Se o carrinho fechar, o comprador monta outro pelo painel.

## Configurações

### Como vender

| Campo                      | O que faz                                                                                                                                                                                                                                | Padrão               |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| **Formato**                | **Painel principal** ou **Vitrines**.                                                                                                                                                                                                    | **Painel principal** |
| **Onde a compra acontece** | **Pelo Discord**: carrinho num canal privado, com cupons e ofertas, e pagamento pelo link da loja. **Pelo site**: os botões levam ao produto ou à categoria no site, e a compra termina lá. Vale para o painel e para todas as vitrines. | **Pelo Discord**     |

> Com **Pelo site**, carrinho, cupons, códigos de criador e ofertas seguem as regras do site, e as configurações do carrinho do Discord ficam guardadas para quando você voltar a vender por lá. Se o site da loja estiver fora do ar, a venda continua pelo Discord até ele entrar no ar.

### Painel

| Campo                    | O que faz                                                                                                                                                            | Padrão                  |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| **Canal do painel**      | Onde a mensagem fixa da loja fica. Salvar publica o painel de novo.                                                                                                  | Nenhum                  |
| **Categorias no painel** | Só as categorias escolhidas, na ordem da loja. Vazio, mostra todas as categorias visíveis com produtos ativos (até 25). Categorias sem produtos ativos não aparecem. | **Todas as categorias** |

### Vitrines

Cada vitrine é uma mensagem num canal, com até 5 produtos ou categorias, um cartão cada. Uma categoria mostra todos os produtos dela, inclusive os que entrarem depois. A loja pode ter até 10 vitrines.

| Campo                     | O que faz                                                                                | Padrão     |
| ------------------------- | ---------------------------------------------------------------------------------------- | ---------- |
| **Canal da vitrine**      | Onde a vitrine fica fixa. Pode ser o mesmo canal do painel, mas não o canal de registro. | —          |
| **Produtos e categorias** | Até 5, na ordem escolhida. Use **Adicionar produto ou categoria**.                       | —          |
| **Título**                | Opcional. Sem título nem texto, a vitrine é só os cartões.                               | Vazio      |
| **Texto**                 | Opcional, até 1000 caracteres.                                                           | Vazio      |
| **Imagem**                | Opcional. Larga (2:1), embaixo do título e do texto. PNG, JPG, WebP ou GIF até 1 MB.     | Sem imagem |

A lista de vitrines mostra a situação de cada uma: **Publica ao salvar**, **Não publicada**, **Nada à venda** ou quantos itens estão **fora de venda** (pausados, apagados ou numa categoria escondida).

### Carrinho

| Campo                          | O que faz                                                                                                                                         | Padrão                     |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| **Categoria dos carrinhos**    | A categoria do Discord onde os canais de carrinho são criados. Só o membro (e a equipe abaixo) vê o seu. Vazio, os canais ficam no topo da lista. | Nenhuma                    |
| **Nome do canal**              | Nome dos canais de carrinho. `{membro}` vira o nome de usuário. Até 60 caracteres.                                                                | `carrinho-{membro}`        |
| **Fecha sozinho depois de**    | Sem nenhum clique por esse tempo, o carrinho fecha e o canal é apagado: 15 min, 30 min, 1 hora, 2 horas, 6 horas ou 1 dia.                        | 30 min                     |
| **Máximo por produto**         | Quantas unidades de um mesmo produto cabem num carrinho: 1, 2, 3, 5, 10 ou 20. O estoque e o limite por jogador também valem.                     | 5 unidades                 |
| **Equipe que vê os carrinhos** | Cargos que enxergam todos os carrinhos, para ajudar quem travar. Ninguém escreve nos canais. Até 10 cargos.                                       | **Ninguém além do membro** |

Um carrinho leva até 20 produtos diferentes.

### Descontos

| Campo                     | O que faz                                                                                                                                        | Padrão    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | --------- |
| **Cupons**                | O botão **Cupom** no carrinho, com as mesmas regras do site.                                                                                     | Ligado    |
| **Códigos de criador**    | O botão **Código de criador**: a venda conta para o criador e o comprador ganha o desconto do programa. Precisa do programa de afiliados ligado. | Ligado    |
| **Cupom e código juntos** | Desligado, usar um tira o outro do carrinho, para os descontos não se somarem.                                                                   | Desligado |

### Comprador

| Campo                  | O que faz                                                                                                                                        | Padrão |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
| **Presentear**         | O botão **Presentear** no carrinho: o comprador digita o ID de outro jogador e quem recebe é ele. Sem presente, vai para a conta de quem compra. | Ligado |
| **Dados do comprador** | No primeiro carrinho, pede nome, sobrenome, e-mail e CPF. Os dados ficam salvos no cliente, em **Clientes**, e não são pedidos de novo.          | Ligado |

### Ofertas

| Campo                       | O que faz                                                                                             | Padrão |
| --------------------------- | ----------------------------------------------------------------------------------------------------- | ------ |
| **Sugestões no carrinho**   | Upgrades, "Leve junto" e combos da página **Ofertas** aparecem no carrinho com um botão de um clique. | Ligado |
| **Desconto por quantidade** | As faixas de "Leve mais, pague menos" valem no carrinho, com um aviso de quanto falta para a próxima. | Ligado |
| **Sugestões por vez**       | Quantas ofertas o carrinho mostra juntas: 1, 2 ou 3. Upgrades vêm primeiro.                           | 2      |

Use **Gerenciar ofertas** para ir para **Loja → Ofertas**.

### Registro

| Campo                 | O que faz                                                                                                                            | Padrão           |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------- |
| **Canal de registro** | Avisa quando alguém abre um carrinho, vai para o pagamento, paga, cancela ou deixa fechar. Precisa ser diferente do canal do painel. | **Sem registro** |

## Personalizar as mensagens

Clique em **Mensagens** (Painel, produtos, carrinho e pagamento) para abrir **Personalizar mensagens**. Cada aba é um passo da compra.

| Passo         | Campo                                                                                                                   | Padrão                                                                                                                              |
| ------------- | ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Painel**    | **Título**                                                                                                              | `{{store}} Loja {servidor}`                                                                                                         |
| **Painel**    | **Texto**                                                                                                               | "Compre sem sair do Discord: escolha uma categoria abaixo, monte seu carrinho e pague pelo site. A entrega na cidade é automática." |
| **Painel**    | **Texto da lista** (o que aparece na lista antes de escolher)                                                           | "Escolha uma categoria"                                                                                                             |
| **Painel**    | **Botão do site** (um link embaixo da lista para o site da loja), com **Texto do botão do site** e **Endereço do site** | Desligado; "Comprar pelo site"                                                                                                      |
| **Painel**    | **Imagem** (larga, 2:1, embaixo do texto)                                                                               | Sem imagem                                                                                                                          |
| **Painel**    | **Miniatura** (quadrada, à direita do texto): **Ícone do servidor**, **Imagem própria** ou **Nenhuma**                  | **Ícone do servidor**                                                                                                               |
| **Produtos**  | **Texto da lista de produtos**                                                                                          | "Escolha um produto"                                                                                                                |
| **Produtos**  | **Botão de adicionar**                                                                                                  | "Adicionar ao carrinho"                                                                                                             |
| **Produtos**  | **Foto do produto** (a imagem do produto, grande, embaixo do preço)                                                     | Ligado                                                                                                                              |
| **Carrinho**  | **Título**                                                                                                              | `{{cart}} Seu carrinho`                                                                                                             |
| **Carrinho**  | **Texto** (fica no topo do carrinho, acima dos itens)                                                                   | `{membro}, este canal é só seu. Monte o pedido pelos botões abaixo e vá para o pagamento quando quiser.`                            |
| **Carrinho**  | **Carrinho vazio**                                                                                                      | "Seu carrinho está vazio. Escolha produtos no painel da loja."                                                                      |
| **Carrinho**  | **Botão de pagamento**                                                                                                  | "Ir para o pagamento"                                                                                                               |
| **Pagamento** | **Título**                                                                                                              | `{{card}} Quase lá!`                                                                                                                |
| **Pagamento** | **Texto**                                                                                                               | "Confira o pedido e clique em pagar. O pagamento é feito no site da loja, com Pix ou cartão."                                       |
| **Pagamento** | **Botão de pagar** (abre o pagamento no site da loja)                                                                   | `Pagar {total}`                                                                                                                     |

Os textos começam no idioma da cidade. Títulos têm até 120 caracteres e textos até 1500. Imagens: PNG, JPG, WebP ou GIF de até 1 MB.

### Variáveis

| Variável     | Onde vale                           | O que vira                                                        |
| ------------ | ----------------------------------- | ----------------------------------------------------------------- |
| `{servidor}` | Painel                              | O nome do servidor FiveM                                          |
| `{loja}`     | Painel                              | O nome da loja                                                    |
| `{membro}`   | Carrinho, pagamento, nome do canal  | Menciona o dono do carrinho (no nome do canal, o nome de usuário) |
| `{itens}`    | Carrinho                            | Quantos itens estão no carrinho                                   |
| `{total}`    | Carrinho, pagamento, botão de pagar | O total, com os descontos                                         |

### Embed

Clique em **Embed** para abrir **Personalizar embed**. Vale para todas as mensagens da loja.

| Campo                     | O que faz                                                                                                                                                                 | Padrão         |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| **Cor**                   | A barra lateral de cada mensagem.                                                                                                                                         | **Cor do bot** |
| **Cabeçalho do servidor** | Nome e ícone do servidor no topo.                                                                                                                                         | Desligado      |
| **Rodapé**                | Texto opcional embaixo, até 100 caracteres (por exemplo, "Entrega automática na cidade"), com um ícone do pacote do bot à esquerda. O ícone só aparece junto de um texto. | Vazio          |

A **Prévia no Discord**, ao lado, mostra cada passo (**Painel**, **Categoria**, **Produto**, **Carrinho**, **Pagamento**) como o jogador vai ver.

## Carrinhos

A lista **Carrinhos** mostra os carrinhos abertos e os recentes, com os números **Abertos agora**, **No pagamento**, **Nos carrinhos** e **Foram ao pagamento** (nos últimos 7 dias). Clique em **Atualizar** para ler de novo.

| Situação           | O que quer dizer                                                    |
| ------------------ | ------------------------------------------------------------------- |
| **Montando**       | O jogador ainda está montando o carrinho.                           |
| **No pagamento**   | O jogador foi para o pagamento.                                     |
| **Pago**           | O pedido foi pago.                                                  |
| **Cancelado**      | O jogador cancelou o carrinho.                                      |
| **Fechou sozinho** | O carrinho ficou sem uso pelo tempo de **Fecha sozinho depois de**. |

## Fechar a loja no Discord

Desligue a chave de **Loja no Discord** e clique em **Salvar**. As mensagens da loja saem dos canais. Carrinhos abertos continuam até fechar.

## Perguntas frequentes

**O bot não publicou o painel. O que conferir?**
Se aparecer "O bot não pode enviar mensagens nesse canal", dê ao bot permissão de enviar mensagens no canal. Se o canal foi apagado, escolha outro. Se o jogador vê "O bot não tem permissão para criar o seu carrinho", dê ao bot permissão para gerenciar canais na categoria dos carrinhos.

**Os preços do Discord são diferentes do site?**
Não. O catálogo e os preços vêm sempre da loja. A página de pagamento confere o preço de novo antes de cobrar.

**A equipe consegue ver os carrinhos?**
Sim, se você escolher cargos em **Equipe que vê os carrinhos**. Eles só leem; ninguém escreve nos canais.

**As vendas estão pausadas no Discord. Por quê?**
Quando a entrega na cidade está desligada (o recurso do FiveDash fora do servidor, desatualizado ou desligado), o pagamento avisa que as vendas estão pausadas. O carrinho continua guardado enquanto estiver aberto.

## Próximos passos

[Bot do Discord](https://fivedash.fivex.gg/docs/pt/discord/bot)Conecte o bot que vende pela cidade.
[Avisos no Discord](https://fivedash.fivex.gg/docs/pt/store/discord-notices)Mensagens privadas para quem compra.
[Ofertas](https://fivedash.fivex.gg/docs/pt/store/offers)Upgrades, combos e "Leve junto" no carrinho.
[Afiliados](https://fivedash.fivex.gg/docs/pt/store/affiliates)Códigos de criador que valem no carrinho.
