Guia de Permissões
O PontoBot foi projetado com foco em segurança, privacidade e transparência. Todas as permissões solicitadas pelo bot possuem finalidades técnicas específicas para viabilizar as automações de registro de ponto, emissão de relatórios e sincronização em tempo real com a dashboard.
Abaixo, detalhamos cada uma das permissões divididas em Essenciais, Complementares e Opcionais, além de instruções sobre canais privados e hierarquia de cargos.
1. Permissões Essenciais
Estas permissões são indispensáveis para o funcionamento do bot. Sem elas, operações básicas como envio do painel, registros de abertura e alternância de cargos não funcionarão.
| Permissão | Nome no Discord | Finalidade no PontoBot |
|---|---|---|
| View Channels | Ver Canais | Permite ao bot localizar e acessar os canais de texto de envio do painel, canais de logs e canais de ranking. No sistema automático por voz, permite identificar quais membros estão conectados no canal de voz no momento em que o expediente é iniciado. |
| Send Messages | Enviar Mensagens | Utilizada para enviar o painel de serviço (/painel), emitir as mensagens de log (abertura, pausa e encerramento de ponto), postar as mensagens periódicas do ranking e enviar resumos semanais de metas. |
| Embed Links | Inserir Links | Necessária para que o bot consiga renderizar mensagens ricas com containers, botões e elementos visuais de interface (Components V2), além de mensagens de logs e avisos. |
| Attach Files | Anexar Arquivos | Permite o upload de arquivos e imagens gerados dinamicamente em tempo real, como o banner personalizado do painel de ponto. |
| Read Message History | Ver Histórico de Mensagens | Permite ao bot buscar mensagens enviadas anteriormente para atualizá-las (por exemplo, ao despausar ou encerrar um expediente, o bot edita a mensagem original para indicar o encerramento, e no canal de ranking edita a mensagem anterior em vez de gerar mensagens duplicadas). |
| Manage Roles | Gerenciar Cargos | Permite que o bot atribua e remova automaticamente os cargos configurados para o serviço (cargo de expediente aberto, cargo de pausa e cargo de expediente finalizado). |
2. Permissões Complementares
Estas permissões melhoram a experiência visual e a precisão dos relatórios e métricas de fluxo do seu servidor:
| Permissão | Nome no Discord | Finalidade no PontoBot |
|---|---|---|
| Use External Emojis | Usar Emojis Externos | Garante a exibição correta dos emojis personalizados e ícones utilizados nos botões, títulos de componentes e mensagens do bot. Sem ela, os ícones podem falhar ou aparecer em formato de texto bruto. |
| Change Nickname | Mudar Apelido | Permite ao bot atualizar seu próprio apelido no servidor caso você altere o nome dele através da personalização de perfil do bot no dashboard (recurso exclusivo de servidores Premium). |
| Ban Members | Banir Membros | Uso estritamente para leitura e métricas. O PontoBot não possui comandos ou funções para banir membros. A permissão é utilizada apenas para consulta em segundo plano na API do Discord. |
Por que o PontoBot solicita a permissão "Banir Membros"?
O PontoBot não bane ninguém do seu servidor. Não existem comandos de moderação punitiva no bot.
Entretanto, para que as estatísticas do servidor e o histórico de fluxo de membros sejam precisos, quando um usuário sai do servidor, o bot precisa saber se ele saiu por vontade própria ou se foi banido por um moderador:
- A API do Discord exige a permissão
BanMemberspara permitir a consulta da lista de banimentos (guild.bans.fetch). - Ao detectar a saída de um membro, o bot consulta se existe um banimento registrado para ele.
- Se houver, o bot registra a saída como decorrente de um banimento no histórico e auditoria, e atualiza o status interno do membro no dashboard para "Banido", impedindo que ele conste como ativo ou possa bater ponto.
Caso você opte por desativar essa permissão, o bot continuará funcionando normalmente, mas todas as saídas de membros banidos serão contabilizadas nas métricas como saídas voluntárias normais.
3. Permissão de Administrador (Opcional)
A permissão de Administrador vem habilitada por padrão no convite exclusivamente para facilitar a vida de pessoas leigas ou administradores que não possuem familiaridade com a configuração de permissões avançadas do Discord:
- Facilidade e Praticidade: Para quem não sabe configurar permissões por canal ou categoria, a permissão de Administrador garante que o bot terá acesso a todos os canais selecionados de imediato, sem necessidade de editar permissões manuais de canais.
- Segurança e Controle Total: Se você já entende como configurar canais e cargos no Discord, você pode desmarcar a opção de Administrador no momento de adicionar o bot, ou revogá-la a qualquer momento nas configurações de cargos do seu servidor. O bot continuará funcionando perfeitamente desde que as permissões essenciais sejam fornecidas.
É importante ressaltar que não há problema nenhum em deixar a permissão de Administrador marcada, o bot foi desenvolvido com rigorosos padrões de segurança e código limpo, e a escolha de mantê-la ou não é exclusivamente uma questão de preferência pessoal de quem administra o servidor.
4. Cuidados Importantes na Configuração
Canais Privados e Categorias Trancadas
Mesmo com a permissão global de "Ver Canais", o Discord oculta canais privados e categorias restritas do bot por padrão. Se você tentar enviar o painel (/painel) ou definir canais de log privados sem conceder acesso:
- O bot não conseguirá enxergar o canal nem enviar mensagens, retornando erros de permissão insuficiente.
- Para resolver, acesse as Configurações do Canal Privado (ou da Categoria) > Permissões;
- Adicione o PontoBot (ou o cargo do bot);
- Conceda as opções Ver Canal e Enviar Mensagens (marque em verde ✅).
Regra da Hierarquia de Cargos
O Discord possui uma regra fundamental: um bot só pode atribuir ou remover cargos que estejam posicionados ABAIXO do seu próprio cargo mais alto.
Para que a alternância de cargos de serviço funcione sem erros:
- Acesse as Configurações do Servidor > Cargos;
- Localize o cargo do PontoBot;
- Arraste-o para cima, deixando-o acima dos cargos de expediente configurados (cargo de aberto, cargo de pausa e cargo de fechado).
5. Dúvidas Frequentes
Os membros não conseguem usar os comandos de barra (/painel, /configurar)?
Essa restrição geralmente ocorre nas permissões do próprio canal. Verifique se o cargo @everyone (ou o cargo dos seus membros) está com a permissão Usar Comandos de Aplicativo habilitada naquele canal específico.
Precisa de ajuda para configurar?
Caso tenha qualquer dúvida ou precise de assistência na configuração do seu servidor, nossa equipe está pronta para ajudar:
- Servidor de Suporte Oficial: discord.gg/k7w8EJSRV3
- E-mail de Suporte: suporte@pontobot.xyz