Pular para o conteúdo

Guia passo a passo para integrar seu Agente Quickchat AI ao Discord. Crie um bot, configure as permissões e coloque-o no ar no seu servidor.

Neste guia, veremos como integrar seu Assistente de IA ao seu servidor do Discord. Visão geral do que abordaremos:

  1. Criar um servidor do Discord
  2. Criar um aplicativo do Discord
  3. Configurar seu aplicativo do Discord
  4. Adicionar o bot ao seu servidor do Discord
  5. Integrar seu bot do Discord com o Quickchat AI
Play

Para iniciar a integração, você precisa de um servidor do Discord. Se não tiver conta, acesse discord.com e crie uma. Depois de entrar, siga este guia para criar seu servidor do Discord.

Acesse discord.com/developers/applications enquanto estiver logado na sua conta do Discord e crie um novo aplicativo.

Antes de adicionar o bot ao servidor, ative o Message Content Intent para o seu aplicativo. Isso permite que o bot leia mensagens enviadas pelos usuários no seu servidor.

Interface do Quickchat AI

Agora você precisa adicionar o bot ao seu servidor. Para isso, construa a seguinte URL do Discord e cole no seu navegador:

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237712896&scope=bot

De onde vem o número de permissões?

O número de permissões (309237712896) corresponde às seguintes permissões:

  • Send Messages
  • Create Public Threads
  • Send Messages in Threads
  • Read Message History

Esse é o conjunto mínimo de permissões necessário para o funcionamento correto do bot. Você pode verificar em discord.com/developers/applications, selecionando seu aplicativo, clicando em Bot à esquerda e rolando para baixo:

Permissões do seu bot

Onde encontrar o SEU CLIENT ID?

A maneira mais fácil é olhar a barra de endereços do navegador e copiar o número longo que faz parte do endereço:

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

Seu client ID

Neste exemplo, o client id é 1234567890123456789, o que significa que a URL completa para adicionar o bot será:

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237712896&scope=bot

Para conectar seu bot ao Quickchat AI, recupere seu Discord Bot Token no Developer Portal.

  1. Vá para Bot SettingsReset TokenCopy Token

Redefinir token

  1. No Painel do Quickchat AI, vá para External Applications, abra a integração do Discord, ative Habilitar Discord e cole seu token.

Colar token

Volte ao Discord – seu bot deve estar online e pronto para conversar! Basta mencioná‑lo com @ para iniciar uma conversa. 🤖💬

Bot ativo

Por padrão, quando for @mencionado, o bot responde no mesmo canal. Você pode alterar isso com a configuração Modo de resposta na integração: Responder no canal (padrão) ou Responder em threads. Com Responder em threads, o bot responde dentro de um tópico e os usuários podem continuar a conversa ali sem mencioná‑lo novamente.

Conversa em tópico

”Integration requires code grant” ao adicionar o bot

Seção intitulada “”Integration requires code grant” ao adicionar o bot”

Sua aplicação está com Require OAuth2 Code Grant ativado, o que bloqueia o fluxo simples de convite do bot. No Developer Portal, abra sua aplicação, vá em Bot, desative Require OAuth2 Code Grant, salve e abra a URL de convite novamente.

A página de autorização mostra um bolo ou uma mensagem “baked”

Seção intitulada “A página de autorização mostra um bolo ou uma mensagem “baked””

Essa tela curiosa é a página de sucesso do Discord: o bot foi adicionado. Para confirmar, abra Configurações do servidor → Integrações → Bots e aplicativos e procure seu bot na lista.

  1. No painel do Quickchat AI, abra External Apps → Discord e verifique o status da conexão. Um token inválido ou um intent faltando é reportado ali com instruções.
  2. Tokens de bot são exibidos apenas uma vez. Na dúvida, clique em Reset Token no Developer Portal, copie o novo token e cole-o novamente no Quickchat.
  3. Confirme que Message Content Intent está ativado em Bot → Privileged Gateway Intents.
  4. Aguarde até um minuto após salvar: o bot reinicia quando as configurações mudam.

Mencione o bot com @ em um canal ao qual ele tenha acesso. Verifique se as permissões de cargo e de canal incluem Send Messages, Create Public Threads, Send Messages in Threads e Read Message History. Se ele responde no canal ou em threads é configurado no Quickchat em External Apps → Discord.


Junte‑se ao nosso servidor do Discord para aprender mais sobre como aproveitar ao máximo o Quickchat AI 👉 discord.gg/KqkHwvPRNH