# Avisos no Discord

Ligue as mensagens privadas que o bot da cidade manda para quem compra: pagamento, entrega, presentes e VIPs vencendo.

Source: https://fivedash.fivex.gg/docs/pt/store/discord-notices

Os avisos no Discord mantêm o comprador por dentro sem ninguém da equipe precisar responder. O bot do servidor manda uma mensagem privada (DM) em cada momento da compra: pedido recebido, pagamento aprovado, entrega na cidade, presente da equipe e o VIP perto de vencer, com o botão para renovar. Você liga, escreve e testa tudo em **Loja → Avisos no Discord**.

## Antes de começar

* **Plano:** os avisos no Discord vêm em todos os planos com o módulo **Loja**.
* **Bot do Discord:** os avisos saem pelo bot deste servidor. Enquanto ele não estiver configurado, a página mostra **Conecte o bot do Discord primeiro** com **Configurar o bot**.
* **Comprador com Discord:** o aviso só sai quando o pedido tem o Discord do comprador (compras feitas com login do Discord no site ou pelo carrinho do Discord). O comprador precisa estar no servidor do Discord e aceitar mensagens privadas.
* **Permissões** (área **Avisos no Discord**):

| Ação                                                          | Nível          |
| ------------------------------------------------------------- | -------------- |
| Avisos enviados e VIPs vencendo                               | **Ver**        |
| Ligar os avisos, textos e aparência (inclui **Mandar teste**) | **Configurar** |

## Ligar os avisos

### Abra a página

Vá em **Loja → Avisos no Discord**. Enquanto estiver desligado, aparece o aviso **Os avisos estão desligados.**

### Confira os textos

Revise os avisos de cada grupo e ligue ou desligue cada um pela chave ao lado.

### Ligue

Ligue a chave **Ligar os avisos** no topo da página (ou clique em **Ligar avisos** no aviso).

### Salve

Clique em **Salvar**. O aviso **Avisos ligados** confirma: o bot já manda as próximas mensagens.

> Nada sai enquanto **Ligar os avisos** estiver desligado, mesmo com avisos ligados um a um. Cada aviso sai uma vez por pedido; o do VIP, uma vez por vencimento.

## Os avisos

| Aviso                   | Quando sai                                                                             | Botão            | Padrão    |
| ----------------------- | -------------------------------------------------------------------------------------- | ---------------- | --------- |
| **Pedido recebido**     | Logo depois de finalizar, com o botão para pagar.                                      | **Pagar agora**  | Desligado |
| **Pagamento aprovado**  | Quando o pagamento é confirmado.                                                       | **Ver pedido**   | Ligado    |
| **Pagamento expirou**   | O Pix venceu sem pagar: lembra de comprar de novo.                                     | **Abrir a loja** | Desligado |
| **Pagamento devolvido** | Quando o provedor devolve o dinheiro.                                                  | **Ver pedido**   | Ligado    |
| **Entregue na cidade**  | Quando a cidade confirma que entregou tudo.                                            | **Ver pedido**   | Ligado    |
| **Problema na entrega** | A cidade não conseguiu entregar: avisa que a equipe vai resolver.                      | **Ver pedido**   | Ligado    |
| **Presente da equipe**  | Quando a equipe dá um produto pelo painel.                                             | **Ver pedido**   | Ligado    |
| **VIP perto de vencer** | Alguns dias antes do fim (veja **Avisar com antecedência**), com o botão para renovar. | **Renovar**      | Ligado    |
| **VIP venceu**          | No dia em que acaba, com o botão para renovar.                                         | **Renovar**      | Ligado    |

Na página, os avisos ficam em três grupos: **Pedido e pagamento**, **Entrega na cidade** e **VIPs e assinaturas**.

> Os botões abrem o site da loja e só aparecem com o site no ar. Com o site fora do ar, as mensagens vão sem botão; o **Pagar agora** das compras feitas pelo Discord continua.

## Editar um aviso

### Abra o aviso

Clique em **Editar** na linha do aviso. A **Prévia no Discord**, ao lado, passa a mostrar esse aviso.

### Escreva

Mude o **Título** (aparece em destaque no topo da mensagem) e a **Mensagem**. Use as variáveis da tabela abaixo.

### Salve

Feche a janela e clique em **Salvar**.

| Campo        | O que faz                                                  | Limite          |
| ------------ | ---------------------------------------------------------- | --------------- |
| **Título**   | Aparece em destaque no topo da mensagem.                   | 120 caracteres  |
| **Mensagem** | O texto do aviso. Aceita negrito do Discord (`**texto**`). | 1500 caracteres |

Um aviso ligado precisa de título ou mensagem; senão, o painel não salva e mostra qual aviso está vazio. Os textos começam no idioma da cidade.

### Variáveis

| Variável       | Vale em          | O que vira                                     |
| -------------- | ---------------- | ---------------------------------------------- |
| `{membro}`     | Todos            | Marca o comprador                              |
| `{nome}`       | Todos            | O nome do comprador                            |
| `{loja}`       | Todos            | O nome da loja                                 |
| `{pedido}`     | Avisos de pedido | O número do pedido                             |
| `{total}`      | Avisos de pedido | O valor do pedido                              |
| `{itens}`      | Avisos de pedido | O que foi comprado                             |
| `{id}`         | Todos            | Quem recebe na cidade (no VIP, quem tem o VIP) |
| `{produto}`    | Avisos de VIP    | O VIP que vence                                |
| `{vencimento}` | Avisos de VIP    | Dia e hora do fim, no fuso de quem lê          |
| `{tempo}`      | Avisos de VIP    | Quanto falta ("em 3 dias")                     |

Nos avisos de pedido, os itens, o total e quem recebe já aparecem embaixo do texto quando **Detalhes do pedido** está ligado.

### Textos padrão

| Aviso                   | Título                           | Mensagem                                                                                                                                       |
| ----------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pedido recebido**     | `Pedido #{pedido} recebido`      | `Oi, {nome}! Seu pedido na **{loja}** está esperando o pagamento. Assim que pagar, ele vai direto para a cidade.`                              |
| **Pagamento aprovado**  | `Pagamento aprovado`             | `Valeu pela compra, {nome}! O pagamento do pedido **#{pedido}** foi aprovado e a entrega já está a caminho da cidade.`                         |
| **Entregue na cidade**  | `Entregue na cidade`             | `Tudo certo, {nome}! O pedido **#{pedido}** já está no ID **{id}**. Bom jogo!`                                                                 |
| **Problema na entrega** | `Tivemos um problema na entrega` | `{nome}, a cidade não conseguiu entregar o pedido **#{pedido}**. Já avisamos a equipe e ela vai resolver: não precisa comprar de novo.`        |
| **Pagamento expirou**   | `O tempo para pagar acabou`      | `O Pix do pedido **#{pedido}** venceu e nada foi cobrado. Se ainda quiser, é só comprar de novo na **{loja}**.`                                |
| **Pagamento devolvido** | `Pagamento devolvido`            | `O pagamento do pedido **#{pedido}** ({total}) foi devolvido. O valor volta pela mesma forma de pagamento.`                                    |
| **Presente da equipe**  | `Você ganhou um presente!`       | `A equipe da **{loja}** te deu **{itens}**. Já está a caminho do ID **{id}** na cidade.`                                                       |
| **VIP perto de vencer** | `Seu {produto} vence {tempo}`    | `{nome}, seu **{produto}** acaba em **{vencimento}**. Renove antes para não perder os benefícios: os dias novos entram depois dos que faltam.` |
| **VIP venceu**          | `Seu {produto} venceu`           | `O seu **{produto}** acabou hoje. Sentiu falta? Renove pela loja e os benefícios voltam na hora.`                                              |

Cada título padrão começa com um emoji do pacote do bot.

## VIPs e assinaturas

Os avisos de VIP valem para grupos vendidos por dias (a entrega de grupo com duração). Os permanentes nunca vencem.

| Campo                       | O que faz                                                                            | Padrão       |
| --------------------------- | ------------------------------------------------------------------------------------ | ------------ |
| **Avisar com antecedência** | Quantos dias antes do fim sai o **VIP perto de vencer**: 1, 2, 3, 5 ou 7 dias antes. | 3 dias antes |

Como o FiveDash calcula o vencimento:

* O vencimento conta a partir da entrega confirmada na cidade.
* Renovar antes do fim soma os dias novos depois dos que faltam; renovar depois do fim começa de novo.
* Comprar o mesmo grupo como permanente deixa o VIP permanente.
* Presentes para o ID de outro jogador ficam de fora, porque o Discord de quem recebe não é conhecido.
* O **VIP venceu** só sai até 3 dias depois do fim. Vencimentos antigos não geram aviso.
* Uma renovação que muda a data gera um novo **VIP perto de vencer**.

A lista **VIPs vencendo** mostra os grupos comprados por dias que acabam nos próximos 7 dias. Com o site no ar, o aviso leva o botão **Renovar** direto para o produto.

## Aparência

Clique em **Aparência** (Cor, servidor no topo, detalhes, botão e rodapé) para abrir **Personalizar a aparência**. Vale para todos os avisos.

| Campo                    | O que faz                                                                                                 | Padrão          |
| ------------------------ | --------------------------------------------------------------------------------------------------------- | --------------- |
| **Cor**                  | A cor da faixa ao lado da mensagem.                                                                       | **Cor da loja** |
| **Cor de cada situação** | Verde quando dá certo, vermelho num problema, amarelo perto de vencer. Desligado, todos usam a cor acima. | Ligado          |
| **Servidor no topo**     | O nome e o ícone do servidor em cima da mensagem.                                                         | Ligado          |
| **Detalhes do pedido**   | Número, total, itens e quem recebe (no VIP, quando vence) embaixo do texto.                               | Ligado          |
| **Botão para a loja**    | **Pagar agora**, **Ver pedido** ou **Renovar**, abrindo o site da loja. Só aparece com o site no ar.      | Ligado          |
| **Rodapé**               | Texto embaixo da mensagem, até 100 caracteres. Vazio, mostra o nome da loja.                              | Vazio           |

## Mandar um teste

### Escolha o aviso

Passe o mouse ou clique em **Editar** no aviso que quer testar. A prévia mostra esse aviso.

### Digite seu ID

Em **Mandar teste**, cole o seu ID do Discord (só números, de 17 a 20 dígitos). Você precisa estar no servidor do bot.

### Envie

Clique em **Enviar**. O aviso chega na sua DM como está na prévia, com dados de exemplo e a linha "Teste: é assim que o jogador recebe." O teste usa os textos que estão na tela, mesmo antes de salvar, e não entra no histórico.

## Histórico e números

No topo, os **Números dos avisos** mostram **Enviados · 7 dias** (com a semana anterior), **Chegaram**, **Não chegaram** e **VIPs vencendo** nos próximos 7 dias.

A lista **Enviados recentemente** mostra cada mensagem que o bot mandou (ou tentou). Filtre por **Todos**, **Chegaram** ou **Não chegaram** e clique em **Atualizar** para ler de novo.

| Situação       | O que quer dizer                                   |
| -------------- | -------------------------------------------------- |
| **Chegou**     | O Discord entregou a mensagem.                     |
| **Não chegou** | O Discord não entregou. O motivo aparece na linha. |
| **Vazio**      | A mensagem ficou vazia e não foi enviada.          |

| Motivo                                                                    | O que fazer                                                        |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| O jogador fecha as mensagens privadas ou não está no servidor do Discord. | Peça ao jogador para entrar no servidor e liberar DMs do servidor. |
| O Discord pediu para esperar (muitas mensagens de uma vez).               | Nada: é um limite do Discord em picos de venda.                    |
| O Discord recusou o token do bot.                                         | Troque o token no módulo do bot.                                   |
| O bot do Discord ainda não terminou a configuração.                       | Termine a configuração em **Discord → Bot**.                       |

## Perguntas frequentes

**Um comprador não recebeu o aviso. Por quê?**
Veja a linha dele em **Enviados recentemente**. Os motivos mais comuns são DM fechada ou o jogador fora do servidor do Discord. Se não há linha, confira se o pedido tem o Discord do comprador e se o aviso estava ligado.

**Posso mandar o aviso de novo?**
Não. Cada aviso sai uma vez por pedido, para o comprador não receber repetido.

**O aviso de VIP saiu para um presente?**
Não. Presentes para o ID de outro jogador não entram nos avisos de VIP.

## Próximos passos

[Bot do Discord](https://fivedash.fivex.gg/docs/pt/discord/bot)Configure o bot que manda os avisos.
[Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery)Como a cidade confirma a entrega.
[Pedidos](https://fivedash.fivex.gg/docs/pt/store/orders)Acompanhe pagamento e entrega de cada pedido.
[Site da loja](https://fivedash.fivex.gg/docs/pt/store/site)Coloque o site no ar para os botões aparecerem.
