Configuracao do Bot no Discord

Guia passo a passo para conectar seu agente Claw Buff ao Discord

Conecte seu agente de IA Claw Buff a um servidor Discord. Seu bot respondera a DMs e mensagens em canais. A configuracao leva cerca de 10 minutos.

Pre-requisitos

Uma conta no Discord
Um servidor Discord onde voce tenha permissao de Gerenciar Servidor
Um agente Claw Buff implantado (Primeiros Passos)

Passo 1: Crie um Aplicativo Discord

Abra o Portal de Desenvolvedores

Va para o Portal de Desenvolvedores do Discord e clique em New Application. De um nome a ele (ex.: "Meu Agente IA").

Crie um Bot

Na barra lateral, clique em Bot. Personalize o username e avatar do bot se desejar.

Habilite o Message Content Intent

Role ate Privileged Gateway Intents e habilite:

Message Content Intent — Necessario para ler mensagens
Server Members Intent — Recomendado para acesso baseado em cargos

Clique em Save Changes.

Copie o Token do Bot

Clique em Reset Token (ou Copy se exibido) para obter seu token do bot. Salve-o — voce precisara dele em seguida.

Seu token do bot e um segredo. Nunca o compartilhe publicamente. Se ele for comprometido, redefina-o imediatamente no Portal de Desenvolvedores.

Passo 2: Convide o Bot para Seu Servidor

Gere um link de convite

Na barra lateral do Portal de Desenvolvedores, clique em OAuth2 → URL Generator.

Selecione estes escopos:

bot
applications.commands

Em seguida, selecione estas permissoes do bot:

View Channels
Send Messages
Read Message History
Embed Links
Attach Files

Convide o bot

Copie a URL gerada e abra-a no seu navegador. Selecione o servidor ao qual deseja adicionar o bot e clique em Authorize.

Passo 3: Conecte ao Claw Buff

Abra o Console do Claw Buff → pagina de Canais
Encontre o card do Discord e clique em Connect
Cole seu Token do Bot do Passo 1
Clique em Save & Activate

Seu bot ficara online em segundos.

Passo 4: Pareie Sua Conta

Antes que o bot responda, voce precisa parear sua conta do Discord:

Envie uma DM ao bot — Clique no nome do bot na lista de membros do servidor e envie qualquer mensagem (ex.: "ola")
O bot respondera com um codigo de pareamento (ex.: X7QTGBD4)
Va para o Console do Claw Buff → pagina de Canais
Voce vera uma secao de Solicitacoes de Pareamento Pendentes — clique em Approve ao lado do codigo

Uma vez aprovado, o bot respondera suas DMs imediatamente.

Passo 5: Habilite Canais do Servidor (Opcional)

Por padrao, o bot so funciona em DMs. Para usa-lo em canais do servidor:

No Discord, clique com o botao direito no icone do servidor → Copiar ID do Servidor

Se voce nao ve "Copiar ID do Servidor", habilite o Modo Desenvolvedor primeiro: Configuracoes do Usuario → Avancado → ative o Modo Desenvolvedor.

No Console, va para Canais → clique em Manage no card do Discord
Em Servidores Autorizados, cole o ID do Servidor e clique em Add

O bot agora respondera a @mencoes nos canais desse servidor. Voce pode adicionar varios servidores.

Ao mencionar o bot, certifique-se de selecionar o usuario do bot (mostrado em "Membros" com a tag APP), nao o cargo com o mesmo nome. O Discord cria um cargo com o mesmo nome do seu bot — mencionar o cargo nao acionara uma resposta.

Recursos

Recurso	Suportado
Mensagens Diretas	Sim
Mensagens em Canal	Sim (mencao necessaria)
Respostas em Streaming	Sim (edicao em tempo real)
Comandos Slash	Sim
Embeds Ricos	Sim
Anexos de Arquivos	Sim
Canais de Voz	Sim

Perguntas Frequentes

1. Bot esta offline no Discord?

Verifique o token — Certifique-se de que colou o token completo
Verifique os intents — O Message Content Intent deve estar habilitado no Portal de Desenvolvedores
Verifique o Console — A pagina de Canais mostra o status da conexao e logs de erro

2. Bot nao responde a mensagens?

Certifique-se de que o Message Content Intent esta habilitado (Passo 1)
Em canais, o bot requer uma @mencao para responder
Certifique-se de mencionar o usuario do bot, nao o cargo — Ao digitar @, selecione o bot na secao "Membros" (com a tag APP), nao na secao "Cargos". O Discord cria um cargo com o mesmo nome do seu bot, mas mencionar o cargo nao acionara uma resposta.
Verifique se o bot tem permissoes de View Channels e Read Message History no canal

3. Erro "Missing Permissions"?

O bot precisa das permissoes corretas no canal. Verifique se ele tem no minimo: View Channels, Send Messages, Read Message History e Embed Links.