# Visão geral do Discord

Conheça o módulo Discord do FiveDash, configure o bot da cidade e acompanhe membros, módulos e comandos em uma tela só.

Source: https://fivedash.fivex.gg/docs/pt/discord/overview

O módulo **Discord** coloca um bot com o nome e o avatar da sua cidade no servidor do Discord. Ele cuida da porta de entrada (verificação, boas-vindas, whitelist), do atendimento (tickets, formulários), da comunidade (sugestões, creators, ponto) e da segurança (moderação, alinhamento, proteção). Tudo é configurado aqui no painel; o bot só executa. Esta página é para donos e equipe que vão ligar o bot e acompanhar o dia a dia.

[Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/discord-overview-pt.mp4)

## Antes de começar

* O módulo **Discord** precisa estar no plano da organização. **Proteção**, **Creators** e **Alinhamento** abrem a partir do plano **Pro**. Veja [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing).
* O bot fica ligado a **um servidor FiveM** do painel. Sem servidor, a página mostra **Nenhum servidor ainda**; adicione um pelo seletor da barra lateral.
* Para fazer a configuração inicial do bot você precisa do nível **Configurar** na página **Bot**. Quem não tem esse nível vê **O bot ainda não foi configurado** até alguém da equipe concluir a configuração.
* Para ver a **Visão geral** depois do bot pronto, você precisa do nível **Ver** em **Visão geral** ("Números e atividade de todos os módulos"). Sem ele, o painel abre direto a primeira página do Discord que você pode ver.

## Configure o bot pela primeira vez

Abra **Discord** na barra lateral. Enquanto o bot não está pronto, a página mostra **Conecte o bot da sua cidade**, com três passos. Leva uns cinco minutos. O passo a passo completo está em [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot).

### Crie e conecte o bot

No Discord Developer Portal, crie um aplicativo com o nome da cidade, copie o token na aba **Bot** (**Reset Token**) e ative **Server Members Intent** e **Message Content Intent**. Cole o token em **Token do bot** e clique em **Conectar bot**.

### Adicione ao seu servidor

Clique em **Adicionar ao Discord**, autorize o bot no servidor da cidade e volte para a aba do painel. Em **Onde o bot entrou**, escolha o servidor e clique em **Usar este servidor**.

### Confira as permissões

O painel confere tudo direto no Discord. Quando os itens obrigatórios estiverem em **Tudo certo**, clique em **Concluir**. O bot fica pronto e você vai para o painel do bot com **Ir para o painel do bot**.

## O que aparece na Visão geral

Depois de concluída a configuração, **Discord → Visão geral** mostra a saúde do bot e um resumo de todos os módulos.

### Cabeçalho do bot

| Item                        | O que mostra                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Status                      | **Online**, **Ligando**, **Offline** ou **Token recusado**.                                                                                 |
| **Verificar conexão**       | Roda de novo as verificações no Discord (permissões, intents, endpoint, comandos). Qualquer pessoa com acesso ao módulo pode usar.          |
| Menu **Mais opções do bot** | **Trocar token** e **Desconectar bot**. Só aparece para quem tem **Configurar** em **Bot**.                                                 |
| **Saúde da conexão**        | **Tudo certo** ou **Precisa de atenção**, com o estado no Gateway: **Online no Gateway**, **Ligando no Gateway** ou **Offline no Gateway**. |

O que cada status significa:

| Status             | O que acontece                                                                                                                |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------- |
| **Online**         | Conectado ao Gateway: entradas, sugestões, proteção e salas de entrevista chegam na hora.                                     |
| **Ligando**        | O bot está entrando no Gateway. Leva alguns minutos e a página atualiza sozinha.                                              |
| **Offline**        | Os comandos continuam funcionando, mas entradas, sugestões, proteção e salas de entrevista ficam paradas até o worker voltar. |
| **Token recusado** | O Discord recusou o token. Os comandos param de responder até um token novo ser salvo.                                        |

### Resumo do servidor

| Número                | O que conta                                                      |
| --------------------- | ---------------------------------------------------------------- |
| **Membros**           | Membros do servidor do Discord, com quantos estão online.        |
| **Entradas · 7 dias** | Quem entrou nos últimos 7 dias, comparado aos 7 dias anteriores. |
| **Saídas · 7 dias**   | Quem saiu nos últimos 7 dias, comparado aos 7 dias anteriores.   |
| **Módulos ligados**   | Quantos módulos estão ligados.                                   |

**Movimento do servidor** mostra entradas e saídas dos últimos 14 dias, com o **Saldo**. Os números aparecem assim que o bot estiver online no Gateway.

### Módulos

Cada módulo tem um cartão com o número principal dos últimos 7 dias. Um módulo desligado mostra **Desligado** e o botão **Configurar e ligar**.

| Módulo                                                                | Número principal                          | Detalhes                         | Alerta                          |
| --------------------------------------------------------------------- | ----------------------------------------- | -------------------------------- | ------------------------------- |
| [Verificação](https://fivedash.fivex.gg/docs/pt/discord/verification) | verificados em 7 dias                     | **Hoje**, **Erros**              | —                               |
| [Boas-vindas](https://fivedash.fivex.gg/docs/pt/discord/welcome)      | entradas em 7 dias                        | **Saídas**, **Saldo**            | —                               |
| [Tickets](https://fivedash.fivex.gg/docs/pt/discord/tickets)          | abertos agora                             | **Na semana**, **Nota média**    | tickets sem atendimento         |
| [Whitelist](https://fivedash.fivex.gg/docs/pt/discord/whitelist)      | liberados em 7 dias                       | **Para revisar**, **Entrevista** | whitelists esperando a equipe   |
| [Connect](https://fivedash.fivex.gg/docs/pt/discord/connect)          | jogadores na cidade (ou estado da cidade) | **Ocupação da cidade**           | **O painel não foi atualizado** |
| [Sugestões](https://fivedash.fivex.gg/docs/pt/discord/suggestions)    | esperando resposta                        | **Na semana**, **Aprovadas**     | sugestões novas                 |
| [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)     | punições em 7 dias                        | **Banidos**, **De castigo**      | —                               |
| [Proteção](https://fivedash.fivex.gg/docs/pt/discord/protection)      | bloqueios em 7 dias                       | **Camadas**, **Hoje**            | —                               |

### Atividade recente e comandos

* **Atividade recente**: os últimos tickets abertos, sugestões, punições (banido, expulso, castigo, desbanido, castigo retirado) e IDs liberados. Clique em um item para abrir o detalhe.
* **Comandos**: os comandos de barra registrados no seu servidor do Discord. Os comandos marcados com **Equipe** são só para a staff. A lista completa está em [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands).

## Todas as páginas do módulo

As páginas ficam em **Discord** na barra lateral. Cada uma tem seu próprio nível de acesso, definido em **Configurações → Membros**.

| Página                                                                | Para que serve                              | Ver                                  | Gerenciar                                          | Configurar                                      | Plano |
| --------------------------------------------------------------------- | ------------------------------------------- | ------------------------------------ | -------------------------------------------------- | ----------------------------------------------- | ----- |
| **Visão geral**                                                       | Números e atividade de todos os módulos     | ✓                                    | —                                                  | —                                               | Todos |
| [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot)                  | Token, servidor, perfil e aparência         | Perfil e aparência do bot            | —                                                  | Conectar, trocar token e mudar o perfil         | Todos |
| [Verificação](https://fivedash.fivex.gg/docs/pt/discord/verification) | Captcha antes de liberar o servidor         | Atividade da verificação             | —                                                  | Cargos, mensagens e painel                      | Todos |
| [Boas-vindas](https://fivedash.fivex.gg/docs/pt/discord/welcome)      | Mensagem e cargo para quem entra            | Entradas e saídas                    | —                                                  | Mensagens, cargo e DM                           | Todos |
| [Tickets](https://fivedash.fivex.gg/docs/pt/discord/tickets)          | Atendimento em canais privados              | Tickets, conversas e ranking         | Compartilhar transcrições                          | Categorias, painel e mensagens                  | Todos |
| [Whitelist](https://fivedash.fivex.gg/docs/pt/discord/whitelist)      | Quem entra na cidade e a liberação do ID    | Whitelists, entrevistas e liberados  | Aprovar, recusar e gerar codiguinhos               | Perguntas, modos e painéis                      | Todos |
| [Connect](https://fivedash.fivex.gg/docs/pt/discord/connect)          | Painel ao vivo com o status da cidade       | Painel e status                      | —                                                  | Endereço, botões e painel                       | Todos |
| [Sugestões](https://fivedash.fivex.gg/docs/pt/discord/suggestions)    | Votos e discussão para cada ideia           | Sugestões e discussões               | Aprovar e recusar                                  | Canal, votos e mensagens                        | Todos |
| [Moderação](https://fivedash.fivex.gg/docs/pt/discord/moderation)     | /ban, /kick e /mute com registro            | Registro de punições                 | Desbanir, tirar do castigo e anexar provas         | Comandos, cargos e mensagens                    | Todos |
| [Alinhamento](https://fivedash.fivex.gg/docs/pt/discord/alignment)    | Chamar um membro para conversar, com prazo  | Alinhamentos e números               | Marcar presença, estender prazo e cancelar         | Comando, canais, salas e mensagens              | Pro   |
| [Formulários](https://fivedash.fivex.gg/docs/pt/discord/forms)        | Formulários com painel no Discord           | Formulários e respostas              | Aprovar e recusar respostas                        | Criar e editar formulários, painéis e mensagens | Todos |
| [Creators](https://fivedash.fivex.gg/docs/pt/discord/creators)        | Programa de streamers e criadores           | Creators, divulgações e inscrições   | Aprovar inscrições, mudar nível e remover creators | Níveis, cargos, canais, formulário e mensagens  | Pro   |
| [Ponto](https://fivedash.fivex.gg/docs/pt/discord/clock-in)           | Canal de ponto da equipe                    | Quem manda ponto e o que foi apagado | —                                                  | Canal, regras, quem passa e avisos              | Todos |
| [Proteção](https://fivedash.fivex.gg/docs/pt/discord/protection)      | Anti-link, anti-spam, anti-raid e anti-nuke | Incidentes                           | Desfazer incidentes e pausar convites              | Camadas, limites e alertas                      | Pro   |

> Alguns limites mudam com o plano, por bot: formulários (Plus 3, Pro 10, Ultra 25), categorias de ticket (Plus 5, Pro 15, Ultra 25) e por quanto tempo uma transcrição de ticket pode ficar guardada (Plus 30 dias, Pro 180 dias, Ultra 365 dias).

## Perguntas frequentes

**Os comandos funcionam com o bot Offline?**
Sim. Os comandos de barra continuam respondendo. O que para são os eventos ao vivo: entradas, sugestões, proteção e salas de entrevista, até o bot voltar a ficar online no Gateway.

**Posso usar o mesmo bot em dois servidores do FiveDash?**
Não. Cada bot fica ligado a um servidor do FiveDash. Se o token for de um bot já conectado em outro lugar, o painel mostra "Esse bot já está conectado a outro servidor do FiveDash."

**Alguém da equipe não vê a Visão geral. Por quê?**
Falta o nível **Ver** em **Visão geral**. Ajuste em **Configurações → Membros**. Veja [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions).

## Próximos passos

[Bot](https://fivedash.fivex.gg/docs/pt/discord/bot)Crie o aplicativo, conecte o token e ajuste o perfil.
[Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands)Todos os comandos de barra e quem pode usar.
[Verificação](https://fivedash.fivex.gg/docs/pt/discord/verification)Captcha antes de liberar o servidor.
[Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Defina quem vê, gerencia e configura cada página.
