Skip to content

Visão geral dos canais Discord

Depois de instalar o bot, seu servidor Discord ganha um layout de canais pequeno e previsível. Esta página é um tour por toda categoria e canal que o bot gerencia — o que aparece quando, para que serve cada um e com qual recurso web ele se pareia.

Só um canal aparece no momento da instalação

Um /guild pair recém-feito cria exatamente uma categoria e um canal: 🛡 AO Master + #⚙️-guild-settings. A categoria 🎯 Enlist aparece depois quando você clica no botão Enable Enlist. Sem bagunça de cara.


1. Categoria 🛡 AO Master

O contêiner para todo canal que o bot gerencia. Criado uma vez pelo /guild pair e mantido até você desparear. Suas sobrescritas de permissão decidem quem pode ver todos os canais dentro — então você define a visibilidade na categoria, não em cada canal.

Configurações da Categoria Discord → Permissões para a categoria 🛡 AO Master. Toggle "Categoria Privada" está ON (azul), com descrição "Tornando uma categoria privada, apenas membros e funções selecionados poderão ver esta categoria. Canais vinculados nesta categoria automaticamente combinarão com essa configuração." Uma seção "Quem pode acessar esta categoria?" lista duas funções (🔵 AO Master com badge Administrator, 🔴 Admin com badge Administrator) e um membro (Zilo, marcado como Server Owner). Um link "Permissões avançadas" é visível embaixo.

Dentro da lista de acesso você sempre verá:

  • Função 🔵 AO Master — o Discord auto-cria essa para o próprio bot. O bot usa para bypassar regras de visibilidade nos seus próprios canais. Deixe quieto.
  • Seu owner de servidor — você, a pessoa que rodou /guild pair.
  • Qualquer função Discord que você escolheu no passo de visibilidade do assistente (veja Instalar — §9).

Para ampliar ou estreitar a visibilidade depois, clique direito na categoria no Discord → Editar Categoria → Permissões e adicione ou remova funções. Cada canal dentro herda a nova lista automaticamente.


2. Canal #⚙️-guild-settings

O hub de configurações. Abra uma vez, fixe nos favoritos — toda ação do bot em nível de guilda fica aqui atrás de uma mensagem fixada com botões.

Visão do canal Discord #⚙️-guild-settings. Barra lateral (truncada) mostra a categoria 🛡 AO Master aberta com o canal selecionado. Painel principal mostra a intro do canal "Bem-vindo ao # ⚙️-guild-settings! Este é o início do canal privado #⚙️-guild-settings." Embaixo: uma linha de botões "Adicionar membros ou funções" + "Editar Canal", e uma pequena linha de avatar mostrando chips da função AO Master + função Admin. Embaixo do divisor de data: post fixado do bot AO Master intitulado "⚙️ Configurações da Guilda" com corpo longo explicando "Controles em nível de guilda para a integração do bot AO Master. Cada botão abaixo é verificado contra suas permissões web — ter visibilidade no canal é suficiente para ver os botões, mas cada ação só passa se sua função web tiver a permissão correspondente." Depois uma lista bullets de cinco ações: 🔍 View Config (snapshot de pareamento + mapeamento de canal), 🟢 Enable Enlist (configurar pipeline de recrutamento + canal 📋-enlist-here + categoria de ticket para candidatos), 🆘 Help (checklist de recuperação + índice de slash commands), 🔄 Refresh UI (re-postar toda mensagem fixada gerenciada pelo bot nesta guilda — só owner), 🔄 Force Re-sync All (re-alinhar funções Discord de cada membro com o estado web do AO Master — só owner; envia DM aos membros afetados). Botões embaixo dos bullets: View Config, Enable Enlist (verde), Help, Refresh UI, Force Re-sync All (vermelho).

A mensagem fixada tem cinco botões:

BotãoO que fazQuem pode usar
🔍 View ConfigMostra um snapshot do pareamento atual — ID do servidor Discord, guilda AO Master, mapeamentos de canal, e quais funções Discord têm quais funções web.Qualquer um com visibilidade no canal.
🟢 Enable EnlistAbre o painel 🎯 Manage Enlist. De lá você escolhe funções Discord de recrutador, confirma, e o bot provisiona o pipeline de Inscrição#📋-enlist-here + a categoria 🎯 Enlist + o botão [Inscrever-se] fixado. O mesmo botão lê 🎯 Manage Enlist depois que Inscrição está configurada.Owner da guilda ou Manage Integrations.
🆘 HelpChecklist de recuperação quando o bot parece quebrado (expulso, canais excluídos, etc.) + um índice de todo slash command.Qualquer um.
🔄 Refresh UIRe-posta toda mensagem fixada gerenciada pelo bot nesta guilda. Útil se um admin Discord acidentalmente excluiu uma mensagem fixada.Só owner da guilda.
🔄 Force Re-sync AllCaminha por todo membro vinculado e reconcilia suas funções Discord contra o estado web do AO Master. Envia DM a quem tiver função mudada.Só owner da guilda.

Visibilidade ≠ permissão

Qualquer um que pode ver o canal vê esses botões. Os próprios botões ainda verificam sua função web no AO Master — clicar em Refresh UI como membro regular não faz nada; o bot só responde com uma mensagem "você não tem permissão". Use as permissões de categoria do Discord para manter o canal visível só à staff que realmente usa esses botões.


3. Categoria 🎯 Enlist (dinâmica)

Aparece na primeira vez que você clica em 🟢 Enable Enlist em #⚙️-guild-settings (ou roda a configuração de Inscrição pela web). A categoria contém:

  • #📋-enlist-here — o canal público que candidatos encontram. Fixado no topo está um único botão [Inscrever-se]. Um clique abre um ticket privado por candidato dentro da mesma categoria.
  • 🗄 enlist-archive — um canal de fórum onde o bot armazena uma transcrição completa de cada ticket fechado (com os nomes de autor originais, avatares e anexos). Criado lazy — não aparece até o primeiro /enlist done. O nome do fórum pega o prefixo do template de nome de canal, então se você mudou o template para apply-{user} o fórum vira 🗄 apply-archive.
  • Canais #enlist-{username} — um canal privado por candidato, criado quando ele clica em [Inscrever-se]. Visível só para o candidato + suas funções de recrutador. Fica aberto após Aprovar (para recrutadores continuarem conversando) e só é excluído quando um recrutador roda /enlist done. O template do nome de canal é configurável; padrão é enlist-{user}.

Walkthrough completo está em Fluxo de inscrição no Discord.


4. A função Discord AO Master

Separada de qualquer categoria, mas vale conhecer: o Discord automaticamente cria uma função chamada AO Master quando o bot entra. É a função vinculada à conta de usuário do bot.

Configurações do Servidor Discord → aba Funções. Barra lateral mostra cabeçalho "MINION TEST" com seções: Perfil do Servidor / Tag do Servidor / Engajamento / Perks de Boost, depois EXPRESSÃO (Emoji / Stickers / Soundboard), depois PESSOAS (Membros / Funções — selecionado / Convites / Acesso), depois APPS (Integrações / App Directory). Painel principal: título "Funções", "Use funções para agrupar os membros do seu servidor e atribuir permissões.", um card Permissões Padrão para @everyone, um input Buscar Funções e botão Criar Função, depois lista "FUNÇÕES — 4": AO Master (1 membro), Admin (2 membros), Member (0 membros), Guest (0 membros) — cada linha tem um botão lápis de editar e menu …

Você verá ela na lista de funções com contagem 1 (o próprio bot é o único "membro"). É como o Discord concede ao bot a permissão Administrator pelo servidor.

Não:

  • Exclua (o bot perde seu poder de admin e a integração quebra).
  • Atribua a um humano (concederia a um humano o escopo de permissão elevado do bot no Discord — não é útil e é confuso).
  • Escolha como função de visibilidade no assistente (/pt-br/discord/install#step-9-pick-channel-visibility) — o bot já bypassa sobrescritas para ele mesmo; marcar a função não faz nada extra.

Juntando tudo

Após instalação nova:

Servidor Discord
├── (canais integrados — #welcome, voz etc.)
├── 🛡 AO Master                      ← estático, criado por /guild pair
│   └── #⚙️-guild-settings            ← estático, o painel de controle
└── (sem outras categorias ainda)

Após habilitar Inscrição + um candidato ter clicado [Inscrever-se] uma vez + um recrutador ter rodado /enlist done pelo menos uma vez:

Servidor Discord
├── (canais integrados)
├── 🛡 AO Master
│   └── #⚙️-guild-settings
└── 🎯 Enlist                          ← dinâmico, ao Enable Enlist
    ├── #📋-enlist-here                 ← o botão público [Inscrever-se]
    ├── 🗄 enlist-archive (fórum)       ← aparece no primeiro /enlist done
    └── #enlist-newbie01                ← ticket por candidato (fica aberto até /enlist done)

O bot possui e poda todo canal acima. Não renomeie ou mova manualmente — o bot procura por nome de categoria para recuperar de falhas, e um canal renomeado à mão acaba duplicado ou órfão.