Ao desenvolver um bot do Discord que precisa ler o conteúdo de mensagens de canais, você deve solicitar aprovação para a Intent de Conteúdo de Mensagens. Sem essa intent privilegiada, seu bot não consegue ver o texto digitado pelos usuários na maioria dos servidores, mesmo com as permissões adequadas. O Discord introduziu esse requisito para proteger a privacidade dos usuários e limitar a coleta de dados por bots. Este artigo explica o processo exato de solicitação, os critérios de elegibilidade e as armadilhas comuns a evitar ao solicitar aprovação.
Principais Conclusões: Aprovação da Intent de Conteúdo de Mensagens do Bot do Discord
- Discord Developer Portal > Application > Bot > Privileged Gateway Intents: Ative a Intent de Conteúdo de Mensagens para solicitar aprovação.
- Verificação do Bot > Formulário de Verificação: Envie um caso de uso detalhado explicando por que seu bot precisa acessar o conteúdo das mensagens.
- Bot em menos de 100 servidores: Bots menores podem receber aprovação automática após a verificação.
O que é a Intent de Conteúdo de Mensagens e por que ela requer aprovação?
A Intent de Conteúdo de Mensagens é uma intent de gateway privilegiada que permite que um bot receba o conteúdo das mensagens enviadas em servidores onde o bot está presente. Sem essa intent, um bot só pode ver o conteúdo das mensagens em mensagens diretas, em mensagens que mencionam o bot ou em mensagens onde o bot recebeu permissão explícita por meio de um prefixo de comando. O Discord introduziu essa restrição em setembro de 2022 para reduzir a coleta em massa de dados por bots e dar aos usuários mais controle sobre sua privacidade.
A aprovação é necessária para qualquer bot que precise ler todas as mensagens em um canal, como bots que realizam varreduras de moderação, registram conversas ou analisam texto. Bots que respondem apenas a comandos de barra ou que leem mensagens apenas quando invocados explicitamente não precisam dessa intent. O processo de aprovação garante que os desenvolvedores tenham um motivo legítimo para acessar o conteúdo das mensagens e que estejam em conformidade com os Termos de Serviço para Desenvolvedores do Discord.
Critérios de Elegibilidade para Aprovação
Para ser elegível para a aprovação da Intent de Conteúdo de Mensagens, seu bot deve atender às seguintes condições:
- Seu bot deve ser verificado pelo Discord. A verificação exige que seu bot esteja em pelo menos 75 servidores e passe por um processo de revisão.
- Seu bot deve ter um caso de uso claro e documentado que exija a leitura do conteúdo das mensagens. Razões genéricas como “melhor experiência do usuário” são rejeitadas.
- Seu bot não deve violar os Termos de Serviço para Desenvolvedores ou a Política de Privacidade do Discord.
O que acontece se você não obtiver aprovação?
Se seu bot não tiver a Intent de Conteúdo de Mensagens aprovada, ele receberá strings vazias para o conteúdo das mensagens em todos os canais de guildas. O bot ainda pode ver IDs de mensagens, IDs de autores, IDs de canais e timestamps, mas o campo de conteúdo ficará em branco. Essa limitação impede que o bot execute qualquer função de análise de texto ou registro que dependa do texto das mensagens.
Passos para Solicitar a Aprovação da Intent de Conteúdo de Mensagens
Siga estes passos para ativar a Intent de Conteúdo de Mensagens e enviar sua solicitação de aprovação através do Discord Developer Portal.
- Acesse o Discord Developer Portal
Vá para https://discord.com/developers/applications e faça login com sua conta do Discord. Clique na aplicação do seu bot na lista. - Navegue até a página de configurações do Bot
Na barra lateral esquerda, clique em Bot. Esta página mostra o nome de usuário, token e configurações de permissão do seu bot. - Role até a seção Privileged Gateway Intents
Abaixo do cabeçalho Privileged Gateway Intents, você verá três alternâncias: Presence Intent, Server Members Intent e Message Content Intent. Ative a alternância Message Content Intent para a posição LIGADO. Uma caixa de diálogo de confirmação aparece. Clique em Yes, I’m sure. - Salve suas alterações
Clique no botão Save Changes na parte inferior da página. A alternância agora aparecerá como ativada, mas a intent ainda não está aprovada. - Envie uma solicitação de verificação
Se seu bot ainda não foi verificado, você deve primeiro solicitar a verificação do bot. Vá para a página General Information na barra lateral esquerda. Role até a seção Bot Verification e clique em Submit for Verification. Preencha o formulário de verificação com o nome, descrição e número de servidores do seu bot. - Preencha a seção da Intent de Conteúdo de Mensagens no formulário de verificação
No formulário de verificação, você verá um campo rotulado Why does your bot need the Message Content Intent? Escreva uma explicação clara e específica. Inclua os recursos exatos que exigem o conteúdo das mensagens, como “filtragem de palavras-chave para moderação automática” ou “análise de prefixo de comando para comandos personalizados”. Evite declarações vagas. - Envie o formulário e aguarde a revisão
Clique em Submit para enviar sua solicitação de verificação. A equipe do Discord revisa a solicitação em alguns dias a algumas semanas. Você receberá uma notificação no endereço de e-mail associado à sua conta de desenvolvedor.
Se seu bot já estiver verificado
- Abra a aplicação do bot no Developer Portal
Vá para https://discord.com/developers/applications e selecione a aplicação do seu bot. - Vá para Bot > Privileged Gateway Intents
Ative a Intent de Conteúdo de Mensagens e salve as alterações. - Envie um ticket de suporte para aprovação da intent
Visite https://dis.gd/contact e selecione a categoria Bot Verification & Intents. Explique que você precisa da aprovação da Intent de Conteúdo de Mensagens para seu bot já verificado. Inclua o ID da aplicação do seu bot e uma breve descrição do caso de uso.
Motivos Comuns de Rejeição e Como Evitá-los
“Meu bot precisa ler todas as mensagens para melhor funcionalidade”
Este motivo é muito vago. O Discord espera que você nomeie o recurso específico que requer o conteúdo das mensagens. Por exemplo, se seu bot filtra palavras ofensivas, diga “moderação automática que verifica cada mensagem em busca de palavrões e envia alertas aos moderadores”. Se seu bot registra mensagens para fins de auditoria, diga “registro de mensagens que arquiva todas as mensagens em canais especificados para conformidade”. Seja preciso.
“Meu bot usa um sistema de comando com prefixo”
Comandos com prefixo por si só não exigem a Intent de Conteúdo de Mensagens. O Discord fornece o conteúdo das mensagens aos bots quando uma mensagem começa com um prefixo de comando registrado, como ! ou ?. Você só precisa da intent se seu bot precisar ler mensagens que não começam com o prefixo. Se seu bot responde apenas a comandos com prefixo, você pode desativar a intent e ainda funcionar corretamente.
“Meu bot está em menos de 75 servidores”
O Discord exige a verificação do bot antes de aprovar a Intent de Conteúdo de Mensagens. A verificação exige que seu bot esteja em pelo menos 75 servidores. Se seu bot for menor, você ainda pode ativar a intent no Developer Portal, mas ela não será aprovada até que você atinja o limite de servidores. Você pode testar a intent localmente com um pequeno número de servidores, mas o uso em produção sem aprovação pode resultar na desativação do seu bot.
“Enviei o formulário, mas nunca recebi resposta”
Os prazos de revisão variam. Se você não recebeu uma resposta após duas semanas, envie um ticket de suporte de acompanhamento via https://dis.gd/contact. Inclua seu número de ticket original e um pedido educado de atualização. Não envie múltiplos tickets duplicados, pois isso pode atrasar o processo.
Níveis de Verificação do Bot: Intents Aprovadas vs Bots Não Verificados
| Item | Bot Não Verificado | Bot Verificado com Intent de Conteúdo de Mensagens Aprovada |
|---|---|---|
| Acesso ao Conteúdo de Mensagens | Limitado a DMs e mensagens que mencionam o bot | Acesso total a todo o conteúdo de mensagens em guildas onde o bot está presente |
| Exigência de Servidores | Nenhum mínimo | Pelo menos 75 servidores para se qualificar para verificação |
| Processo de Aprovação | Nenhuma aprovação formal necessária para testes locais | Enviar formulário de verificação e aguardar revisão |
| Risco de Desativação | O bot pode ser desativado se a intent for usada em produção sem aprovação | Em conformidade com a política do Discord |
Após a aprovação da sua Intent de Conteúdo de Mensagens, seu bot pode processar o conteúdo das mensagens em todos os servidores onde tem permissão para ler mensagens. Isso permite recursos como moderação baseada em palavras-chave, análise de mensagens e sistemas de comando personalizados que não dependem de prefixos. Lembre-se de que você ainda deve respeitar a privacidade do usuário e cumprir os Termos de Serviço para Desenvolvedores do Discord. Se a funcionalidade do seu bot mudar, talvez seja necessário atualizar sua solicitação de aprovação. Um próximo passo prático é implementar o registro do processamento de mensagens do seu bot para garantir que você permaneça dentro do escopo do seu caso de uso aprovado.