O Invite Guard decide quem pode criar um convite para o seu servidor. Todo convite criado por qualquer outra pessoa é revogado assim que aparece.
O próprio Discord não consegue fazer isso: a permissão Create Invite é tudo ou nada por cargo, e qualquer membro que a tenha pode convidar qualquer pessoa, para sempre, de qualquer canal que enxergue. O Invite Guard coloca uma lista na frente dela.
🚪 Como funciona
O bot é notificado no momento em que um convite é criado. Ele descobre quem o criou, compara com a sua lista de permitidos e remove o convite se ninguém concedeu esse direito à pessoa, geralmente em menos de um segundo, antes de o link ser usado.
O criador é lido do próprio convite. Quando o convite não traz autor (o convite de um aplicativo, por exemplo), o bot recorre ao registro de auditoria do seu servidor para nomeá-lo.
✅ Sempre isentos (a menos que você diga o contrário)
Ativar o Invite Guard sem configurar nada não começa a excluir os convites da sua equipe. Quatro isenções vêm ativadas por padrão:
- O próprio YAWBDB - isento permanentemente, para nunca revogar um convite que lhe pediram para criar.
- O dono do servidor - isento permanentemente.
- Membros que podem gerenciar o servidor - ativado por padrão. É isso que evita que você bloqueie a sua própria equipe no minuto em que ativa o recurso. Você pode desativar.
- Aplicativos que você autorizou - ativado por padrão. Bots e integrações mantêm os seus convites. Desative e eles também são revogados; o log diz de qual aplicativo se tratava.
🧩 Convites que o Discord cria por conta própria
O widget do servidor (Server Settings → Engagement) e a Descoberta de servidores criam o próprio convite. Ele não tem autor, não deixa registro de auditoria e o Discord o regenera assim que alguém lê o widget de novo.
Revogá-lo é uma briga que você não pode vencer: o convite volta, o bot o exclui e o seu log se enche. Por isso esses convites são mantidos por padrão.
Se você vê nos seus logs convites sem criador, aparecendo sozinhos dia após dia, isso é o widget, e não um intruso. Desative o widget em Server Settings → Engagement, ou deixe a isenção ativada.
Só desative Permitir convites que o próprio Discord cria se o widget e a Descoberta também estiverem desativados.
🛑 A pausa
Se cinco convites forem revogados em um minuto, o guarda para naquele servidor e publica um aviso no canal de log. Alguma coisa está recriando convites mais rápido do que eles podem ser removidos, e trocar exclusões com ela não geraria nada além de ruído. O aviso diz onde olhar.
O guarda retoma sozinho depois que o minuto passa.
⚙️ Configurações
| Opção | O que faz |
|---|---|
| Cargos autorizados a criar convites | Quem tem um desses cargos pode criar convites livremente. |
| Membros autorizados a criar convites (IDs de usuário) | IDs de usuário do Discord individuais, separados por vírgulas ou quebras de linha, para quem deve manter o direito sem ter um cargo. |
| Sempre permitir membros que podem gerenciar o servidor | Ativado por padrão. Veja acima. |
| Permitir convites criados por aplicativos | Ativado por padrão. |
| Permitir convites que o próprio Discord cria | Ativado por padrão: o widget e a Descoberta. |
| Canais cujos convites nunca são tocados | Os convites que apontam para esses canais são deixados em paz, não importa quem os criou. Útil para o canal para o qual o convite do seu widget leva as pessoas. |
| Avisar o criador sobre por que seu convite desapareceu | Desativado por padrão. Envia uma DM explicando a remoção. Nada é enviado a aplicativos, e uma DM fechada nunca impede a remoção. |
| Canal de log | Onde cada revogação é informada. |
📋 O que é registrado
Toda remoção é escrita no seu canal de log: o código do convite, o canal para o qual ele apontava, quem o criou, por que ele não era permitido e o que aconteceu. Nada é removido em silêncio.
As falhas também são registradas e costumam ser uma de duas coisas:
- Falta ao bot a permissão Manage Server (ou Manage Channels naquele canal).
- O cargo do bot está baixo demais para agir. Suba o cargo do YAWBDB.
Para não enterrar o log, um aviso de falha é publicado no máximo uma vez por minuto, e não uma vez por convite.
🔑 Permissões
O Invite Guard precisa de:
- Manage Server (ou Manage Channels no canal para o qual o convite aponta) para excluir um convite.
- View Audit Log - opcional, mas sem ela o convite de um aplicativo não pode ser atribuído e é tratado como sem autor.
Veja Permissões dos recursos.
↔️ Não é o mesmo que a regra de convites do Automod
O Automod pode excluir mensagens que contêm um link de convite: alguém divulgando outro servidor no seu chat.
O Invite Guard age um passo antes: ele remove convites para o seu próprio servidor que não deveriam existir. Os dois são independentes e muitas vezes usados juntos.
💡 Configuração recomendada
- Ative o Invite Guard e defina primeiro um canal de log.
- Deixe todas as isenções ativadas e observe o log por um dia: você verá exatamente o que o seu servidor de fato cria.
- Adicione os cargos da sua equipe a Cargos autorizados a criar convites.
- Só então decida se vai desativar as isenções de aplicativos ou de administradores.
- Se o seu widget está ativado e você quer mantê-lo, deixe Permitir convites que o próprio Discord cria ativado, ou adicione o canal do widget à lista de isentos.