Permissões que o Toscio precisa
O Toscio pede sete permissões quando você adiciona o bot, e mais nada. Esta página explica para que serve cada uma, a permissão opcional para a apelação de ban, a regra da ordem dos cargos que pega a maioria dos servidores e como conferir as permissões dos canais.
As sete permissões
| Permissão | Por que o Toscio precisa dela |
|---|---|
| Ver canais | Para ver os canais onde ele publica o painel e as fichas da staff. |
| Enviar mensagens | Para publicar o painel “Candidatar-se” e as fichas de candidatura para a staff. |
| Inserir links | Para mostrar painéis e fichas como mensagens organizadas e fáceis de ler (embeds). |
| Anexar arquivos | Para colocar na ficha da staff os arquivos que os candidatos enviam (prints, documentos). |
| Gerenciar cargos | Para dar o cargo que você escolheu quando uma candidatura é aceita, e remover cargos se você configurar isso. |
| Criar tópicos privados | Para abrir um tópico privado de entrevista com o candidato. |
| Enviar mensagens em tópicos | Para escrever nesses tópicos de entrevista. |
Elas já vêm marcadas quando você clica em Adicionar ao Discord no toscio.com. Se você desmarcou alguma, o jeito mais fácil de resolver é adicionar o bot de novo pelo mesmo link: o Discord atualiza as permissões do cargo do Toscio.
Por que o Toscio nunca pede Administrador
Administrador dá a um bot todas as permissões do servidor, inclusive apagar canais e banir membros. O Toscio não precisa de nada disso, então não pede. O Toscio também não lê suas mensagens: ele só recebe os comandos, os cliques nos botões e os formulários que os membros mandam para ele.
Opcional: Banir membros, só para a apelação de ban
Se você usa a apelação de ban, pode dar ao cargo do Toscio a permissão Banir membros. Ela é opcional e o Toscio não pede quando você adiciona o bot: você só adiciona se quiser que a apelação de ban seja totalmente automática. Com ela, o Toscio:
- confere se quem está apelando está mesmo banido (os outros recebem “Você não está banido deste servidor: não há nada para recorrer.”) e mostra o motivo do ban na ficha da staff;
- remove o ban automaticamente quando você aceita a apelação: “🔓 Ban removido.”
Sem ela, a apelação continua funcionando: a ficha mostra “ℹ️ Ban não verificado: dê ao bot a permissão “Banir membros” para verificá-lo e removê-lo automaticamente.” e, ao aceitar, lembra você de remover o ban na mão.
Para adicionar: Configurações do servidor → Cargos → Toscio, ative Banir membros e salve. O Toscio nunca bane ninguém: ele só lê os bans e remove aquele que você aceitou.
A regra da ordem dos cargos
O Discord só deixa um bot dar ou remover cargos que estão abaixo do cargo mais alto dele. É uma regra do Discord, e nenhuma permissão (nem Administrador) passa por cima dela.
Para resolver:
- Abra Configurações do servidor → Cargos.
- Arraste o cargo Toscio para cima de todos os cargos que ele deve dar ou remover ao aceitar.
- Salve.
O Toscio confere isso para você:
- O
/toscio setupavisa: “⚠️ O cargo @cargo está acima do cargo do bot. Em Configurações do servidor → Cargos, arraste o cargo do bot para cima dele, senão o bot não conseguirá dá-lo.” - No editor de formulário do dashboard, os cargos acima do Toscio aparecem em cinza com “— acima do cargo do bot”.
- Se mesmo assim acontecer quando alguém da staff clicar em Aceitar, a candidatura continua pendente e a ficha mostra: “⚠️ Não foi possível dar o cargo: em Configurações do servidor → Cargos, coloque o cargo do bot acima do cargo a ser dado e tente de novo.”
Cargos gerenciados pelo Discord ou por outros bots (cargo de booster, cargos de bot) não podem ser dados por ninguém, então o Toscio recusa esses cargos.
Permissões dos canais
As permissões do servidor podem ser alteradas em cada canal. Se um canal é privado ou tem permissões personalizadas, confira se o Toscio (ou o cargo dele) tem acesso ali.
Canal do painel (onde os membros clicam em Candidatar-se):
- Ver canal, Enviar mensagens, Inserir links: para publicar o painel.
- Criar tópicos privados, Enviar mensagens em tópicos: para as entrevistas, que são abertas como tópicos privados neste canal. Seus candidatos sempre conseguem ver este canal, por isso as entrevistas acontecem aqui e não no canal da staff.
Canal da staff (onde as candidaturas chegam):
- Ver canal, Enviar mensagens, Inserir links: para publicar cada ficha de candidatura.
- Anexar arquivos, se o seu formulário tem perguntas de arquivo: os arquivos vão anexados na ficha. Servidores que adicionaram o Toscio antes de outubro de 2026 podem não ter dado essa permissão: sem ela, as candidaturas chegam do mesmo jeito, mas com um aviso no lugar dos arquivos.
Para conferir: clique com o botão direito no canal → Editar canal → Permissões, adicione o cargo do Toscio se precisar e libere essas permissões.
As entrevistas precisam de um canal de texto comum para o painel. O Discord não permite tópicos privados em canais de anúncios.
Marcar o cargo da staff
A cada nova candidatura, o Toscio menciona os cargos da staff que você escolheu. Se o cargo não for mencionável, o Discord mostra a menção mas não notifica ninguém. Ative Permitir que qualquer um @mencione este cargo nas configurações do cargo, ou dê ao Toscio a permissão “Mencionar @everyone, @here e todos os cargos” no canal da staff.
Quem pode fazer o quê
| Ação | Quem |
|---|---|
Usar o /toscio setup, usar o dashboard |
Membros com Gerenciar servidor (e o dono) |
| Aceitar, recusar, votar, abrir entrevista | Membros com Gerenciar servidor, mais os cargos da staff daquele formulário |
| Se candidatar | Qualquer pessoa que veja o painel e cumpra os requisitos para se candidatar do formulário |
/toscio vote, /toscio privacy, /toscio help |
Todo mundo |
Um membro sem esses direitos que clica num botão da staff recebe: “Só a staff pode analisar as candidaturas.”
Próximo: Primeiros passos · Solução de problemas
Perguntas
Posso dar Administrador ao Toscio para facilitar?
Pode, mas não deveria. O Toscio funciona 100% com as sete permissões dele. E Administrador nem resolveria a regra da ordem dos cargos: um bot nunca consegue dar um cargo que está acima do dele.
Quem pode usar o dashboard?
Qualquer pessoa com a permissão Gerenciar servidor (ou o dono do servidor) pode entrar em app.toscio.com e gerenciar aquele servidor.
O Toscio precisa de Banir membros?
Só se você usa apelação de ban e quer que o Toscio verifique o ban e remova ele quando a apelação for aceita. É opcional, não é pedida quando você adiciona o bot e pode ser dada depois.