Discord

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

Assista ao vídeo

Play

Criando e configurando um servidor do Discord

Criar um servidor do Discord

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.

Criar um aplicativo do Discord

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

Configurar seu aplicativo do Discord

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.

Adicionar o bot ao seu servidor do Discord

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:

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

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

Integrar seu bot do Discord com o Quickchat AI

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

1. Vá para Bot Settings → Reset Token → Copy Token

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

🎉 Seu bot de IA está online!

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

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.

Solução de problemas

Se o Quickchat AI relatar um erro na página de integração do Discord, ele leva direto à seção correspondente abaixo.

Message Content Intent

PrivilegedIntentsRequired: seu bot se conectou, mas o Message Content Intent está desativado, então ele não consegue ler as mensagens. No Developer Portal, abra sua aplicação, vá em Bot → Privileged Gateway Intents, ative o Message Content Intent e salve. O bot reinicia automaticamente, aguarde cerca de um minuto.

Token de bot inválido

InvalidToken: o token que o Quickchat AI tem está incorreto ou foi regenerado. Um token de bot é exibido apenas uma vez, e redefini-lo invalida o anterior. No Developer Portal, abra sua aplicação, vá em Bot, clique em Reset Token, copie o novo token, depois clique em Reconnect no Quickchat AI e cole-o.

Require OAuth2 Code Grant

Se aparecer “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”

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.

O bot não responde após a configuração

O bot reinicia sempre que você muda o token ou as configurações, então aguarde até um minuto após salvar. Se ele ainda não ficar online ou não responder:

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 um link para a correção exata.
2. Confirme que o Message Content Intent está ativado (veja acima) e que o token está atual (use Reset Token na dúvida).
3. Mencione o bot com @ em um canal ao qual ele tenha acesso, e verifique se as permissões de cargo e de canal incluem Send Messages, Create Public Threads, Send Messages in Threads e Read Message History.
4. Escolha se ele responde no canal ou em uma thread com a configuração Modo de resposta em External Apps → Discord.

Dica

A página de integração do Discord no painel do Quickchat AI mostra o status da conexão, o campo Bot Token, um seletor de Modo de resposta (Responder no canal ou Responder em threads) e um link para entrar na nossa comunidade do Discord e obter ajuda.

---

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