Crie um bot de IA para Discord em 10 minutos (sem código)

Coloque seu chatbot de IA no Discord

Quer criar um bot inteligente de IA conversacional para o seu servidor do Discord? Este guia passo a passo mostra como fazer isso em apenas 10 minutos, sem precisar programar!

Assista ao vídeo

Escolha a configuração: bot compartilhado ou sua própria aplicação do Discord

O bot compartilhado aceita @menções e /ask. Com sua própria aplicação, use @menções. Consulte as opções e os limites na documentação da conexão com o Discord.

5 passos simples para criar seu bot de IA

Para usar sua própria aplicação do Discord, siga estes cinco passos:

1. Crie um servidor do Discord
2. Crie uma aplicação no Discord
3. Adicione o bot ao seu servidor
4. Crie uma conta no Quickchat AI
5. Integre seu bot do Discord ao Quickchat AI

Como será seu bot de IA

Após a configuração, seu bot estará ativo no Discord, pronto para manter conversas naturais com os membros do servidor.

O caminho mais rápido: instalação com um clique

Se você já tem uma conta no Quickchat AI, pode pular o Developer Portal. No painel, abra External Apps na barra lateral esquerda, selecione Discord e, em Connect, clique em Add to your Discord server.

A tela de conexão com um clique em External Apps → Discord.

O Discord pede que você autorize a aplicação compartilhada Quickchat AI e escolha um servidor. Clique em Authorize e o bot estará no ar, pronto para os membros mencionarem com @ em qualquer canal. O único requisito é ter a permissão Gerenciar servidor no servidor escolhido.

Novos cadastros no Quickchat AI recebem uma configuração com a identidade visual do Discord que os leva diretamente a esse fluxo.

Novos usuários começam em uma tela com a identidade visual do Discord que leva à conexão com um clique.

Para configurar conhecimento e testes após a instalação, siga o guia do bot de ChatGPT para Discord, com regras para copiar, Main Prompt e testes de perguntas que as fontes não conseguem responder.

Os passos abaixo mostram a alternativa manual, a opção Use your own Discord app: você cria sua própria aplicação no Discord e a conecta com um token de bot. Use esse caminho quando quiser um avatar personalizado, mensagens diretas, Discord AI Actions ou vários bots em um servidor. As Discord Actions exigem a conexão com seu próprio bot porque ela fornece o token usado nas chamadas à API do Discord. O bot compartilhado já permite usar um nome diferente em cada servidor.

1. Crie um servidor do Discord

Se você ainda não tem uma conta no Discord, crie uma em discord.com. Depois, configure seu primeiro servidor:

2. Crie uma aplicação no Discord

Abra o Discord Developer Portal e crie uma nova aplicação.

3. Adicione seu bot ao servidor do Discord

Lembre-se de permitir que o bot receba o conteúdo das mensagens ativando a opção abaixo:

Depois de criar seu bot, você precisa adicioná-lo ao servidor. Para fazer isso, monte uma URL do Discord e cole-a no navegador:

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

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

O número de permissões (309237713920) corresponde à solicitação das seguintes permissões:

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

Esse é o conjunto mínimo de permissões necessário para que o bot funcione corretamente. Você pode conferir acessando discord.com/developers/applications, selecionando sua aplicação, clicando em Bot à esquerda e rolando a página:

Onde encontrar YOUR 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 caso, o client ID é 1234567890123456789, então a URL completa que você deve acessar para adicionar o bot ao servidor será:

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

Se algo der errado neste passo:

• “Integration requires code grant”: sua aplicação está com Require OAuth2 Code Grant ativado. No Developer Portal, abra a aplicação, vá para Bot, desative essa opção, salve e abra a URL de convite novamente. (detalhes)
• Aparece uma tela com um bolo / “baked”: essa é a página de sucesso do Discord, seu bot foi adicionado. Confirme em Configurações do servidor → Integrações → Bots e aplicativos.
• Dica: depois que você cola o token do bot no painel do Quickchat AI (passo 5), a página de integração do Discord monta essa URL de convite e mostra uma lista de configuração. Assim, você pode dispensar a montagem manual da URL acima.

4. Crie uma conta no Quickchat AI

Cadastre-se no Quickchat AI para equipar seu bot com IA conversacional que interage de forma natural.

O Quickchat AI permite criar agentes de IA com bases de conhecimento personalizadas, AI Actions e muito mais, ideais para bots do Discord, sites e outros canais.

5. Integre seu bot ao Quickchat AI

Para conectar seu bot ao Quickchat AI, obtenha o token do bot do Discord no Developer Portal.

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

2. No painel do Quickchat AI, abra External Apps → Discord, escolha Use your own Discord app e cole seu token. O Quickchat AI liga o bot e informa seu status durante a inicialização.

Se o bot não ficar online

Quando um bot não inicia, a página de integração do Discord mostra o erro exato e um link direto para a solução. Os dois mais comuns são:

• Token inválido: o token está errado ou foi gerado novamente (redefinir um token invalida o anterior). Abra o bot no Developer Portal, vá para Bot → Reset Token, copie o novo token, clique em Reconnect no Quickchat AI e cole-o. Veja Token de bot inválido para conferir a captura de tela correspondente.
• Message Content Intent está desativado (informado como PrivilegedIntentsRequired): o bot se conectou, mas não consegue ler as mensagens. Abra o bot no Developer Portal, vá para Bot → Privileged Gateway Intents, ative Message Content Intent e salve. Veja Message Content Intent para localizar a opção exata.

O bot reinicia sempre que você altera o token ou as configurações. Aguarde até um minuto para que ele fique online.

Se seu próprio bot estiver online, mas nunca responder

Verifique se o bot compartilhado Quickchat AI, instalado com um clique, ainda está no mesmo servidor. Quando os dois bots estão no mesmo servidor, o bot compartilhado responde e seu próprio bot permanece em silêncio, mesmo com token, intents e permissões corretos. Abra External Apps no painel do Quickchat AI, encontre o servidor em Connected servers na configuração com um clique e remova-o ali. Seu próprio bot assume imediatamente. Veja Os dois bots estão no mesmo servidor.

Seu bot de IA está no ar!

Volte ao Discord. Seu bot deve estar online e pronto para conversar! Basta mencioná-lo com @ para começar.

Quando for mencionado com @, o bot responderá no canal por padrão. Se você escolher Thread na configuração Reply in, ele criará uma thread na qual os usuários poderão continuar a conversa sem mencionar o bot.

Como o bot responde

O bot pode ser acionado de várias maneiras, cada uma com um comportamento diferente em relação ao histórico da conversa:

Uma mensagem comum em um canal não aciona nada. Isso é intencional, para que o bot fique em silêncio em servidores movimentados, e é o motivo mais comum para um bot recém-adicionado parecer não funcionar. O /ask existe, em parte, como uma alternativa mais fácil de descobrir: digitar / em qualquer canal exibe o comando, e ele funciona onde o conteúdo das mensagens é restrito. Ele é registrado no bot compartilhado com um clique. Portanto, se você conectar sua própria aplicação, as @menções são a forma de começar.

A configuração “Reply in”

No painel do Quickchat, em Channels > External Apps > Discord, há um menu “Reply in:” com duas opções:

• Channel (padrão): o bot responde diretamente no canal em que foi mencionado. Cada @menção inicia uma nova conversa, sem memória das interações anteriores.
• Thread: o bot cria uma nova thread para cada @menção. A thread recebe o nome do bot e do usuário (por exemplo, “Aria & john_doe”). Dentro dela, o bot responde a todas as mensagens sem exigir uma @menção, e o histórico completo da conversa é preservado.

Mensagens diretas

As DMs exigem sua própria aplicação no Discord. O bot compartilhado com um clique responde apenas em servidores, pois responder a DMs não solicitadas usando uma única identidade compartilhada afetaria todos os servidores atendidos.

Na sua própria aplicação, não é necessário mencionar o bot com @ em uma DM. Ele responde a todas as mensagens, e o histórico da conversa persiste durante a sessão. O bot não tem acesso ao histórico dos canais do servidor ao responder a DMs.

Observação: o bot só responde em threads que ele mesmo criou. Se alguém criar uma thread manualmente e escrever nela, o bot não responderá.

Como o bot entende o contexto do canal

Quando alguém menciona o bot com @ em um canal, ele não vê apenas a mensagem em que foi mencionado. Ele busca automaticamente as mensagens recentes do canal e as inclui no prompt da IA como uma transcrição com data e hora. Isso permite que o bot entenda a conversa em andamento e faça referência ao que as pessoas disseram antes.

Veja um exemplo de como esse contexto aparece para a IA:

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

O bot também lê mensagens de threads ativas e arquivadas no canal, incluindo essas discussões no contexto.

Quando alguém usa o recurso Responder do Discord para responder a uma mensagem específica, o bot limita o contexto às mensagens imediatamente próximas à mensagem respondida, em vez de buscar todo o histórico recente. Isso fornece contexto direcionado para a conversa específica à qual o usuário se refere.

Conteúdos especiais nas mensagens (figurinhas, GIFs, imagens, embeds e reações) são representados por anotações, para que o bot saiba que estão presentes, mesmo sem visualizá-los na transcrição do contexto. Os tokens de @menção são substituídos por nomes de exibição legíveis.

Nenhuma configuração é necessária. O contexto do canal fica ativado por padrão em todos os bots do Quickchat AI no Discord.

Busca inteligente com IA no histórico do servidor

Por padrão, o bot só lê mensagens do canal em que foi mencionado. Com Smart AI search over server history ativado, a IA pode consultar mensagens de qualquer canal de texto do servidor. Ela decide qual canal consultar com base na pergunta do usuário.

Por exemplo, se alguém perguntar em #general “qual foi a conclusão em #engineering sobre a migração?”, o bot poderá ler o histórico recente de #engineering e responder com base no que encontrar.

O recurso também permite filtrar por período e usar paginação, para que a IA possa buscar mensagens mais antigas quando necessário.

Observação: Smart AI search over server history está em beta. Se tiver interesse, entre em contato por e-mail ou pelo servidor do Quickchat no Discord.

Enviando imagens ao bot

Os usuários podem anexar uma imagem ao mencionar o bot com @, e a IA a processará usando seus recursos de visão. Os formatos aceitos são PNG, JPG, JPEG, GIF e WebP. Se várias imagens forem anexadas, o bot processará a primeira.

A URL da imagem na CDN do Discord é enviada junto com o texto da mensagem ao modelo de IA como entrada multimodal. Assim, a IA vê o texto e a imagem na mesma interação. Nenhuma configuração é necessária. A compreensão de imagens fica ativada por padrão.

Alguns exemplos práticos para comunidades do Discord:

• Comunidade de desenvolvedores: um usuário envia uma captura de tela de um stack trace ou de uma mensagem de erro e pede uma explicação ao bot.
• Comunidade de design: um usuário compartilha um protótipo de interface e pede feedback ao bot.
• Comunidade de jogos: um usuário compartilha uma captura das configurações de um jogo e pede dicas de otimização ao bot.
• Suporte de e-commerce: um cliente envia uma foto de um produto com defeito ao bot de suporte.

Conectando AI Actions ao Discord

As AI Actions permitem que o bot chame APIs e ferramentas externas durante uma conversa no Discord. Elas são configuradas uma única vez no painel do Quickchat, em AI Agent > Actions & MCPs, e funcionam em todos os canais (Discord, widget do site, WhatsApp, Telegram etc.).

Dois tipos de ação estão disponíveis:

Veja alguns exemplos do que você pode criar com AI Actions no Discord:

• Bot de rastreamento de pedidos: conecte uma API Action ao backend do seu e-commerce para que os membros perguntem “onde está meu pedido #12345?” e recebam o status em tempo real.
• Bot de issues do GitHub: conecte um Remote MCP ao seu repositório do GitHub para que desenvolvedores perguntem “há bugs abertos com a tag critical?” diretamente no Discord.
• Bot de tickets de suporte: permita que o bot responda com base na sua documentação e abra uma thread privada de ticket com menção ao cargo de suporte apenas para o que não conseguir resolver.
• Assistente de moderação: escolha os modelos de timeout, expulsão, banimento e modo lento para que moderadores possam executá-los usando linguagem natural.
• Agendamento de reuniões: conecte um Remote MCP ao Cal.com ou ao Google Calendar para que os usuários agendem reuniões com sua equipe pelo Discord.
• Integração com CRM: conecte ao HubSpot para que o bot registre leads ou crie tickets de suporte a partir das conversas no Discord.
• Registro de leads e feedback: conecte o Google Sheets para que o bot registre leads, perguntas sem resposta e pedidos de demonstração das conversas no Discord diretamente em uma planilha que sua equipe já usa.
• Feedback da comunidade sobre o produto: crie um bot de FAQ e feedback para Discord que registra o feedback enviado explicitamente para a equipe revisar e mantém as perguntas sem resposta sobre o produto em um backlog de documentação separado.

Configurando uma API Action

1. No painel do Quickchat, vá para AI Agent > Actions & MCPs.
2. Clique em Add Action. Para uma operação do Discord compatível, escolha Discord Action e selecione um modelo. O modelo de suporte solicita servidor, canal e cargo; os modelos de moderação são instalados diretamente. O Quickchat cria para você a requisição editável, a descrição, os parâmetros, o tratamento da resposta e as condições de execução.
3. Somente quando precisar de um endpoint fora da galeria, escolha uma ação HTTP Request personalizada. Dê um nome a ela (por exemplo, “Consultar status do pedido”) e uma descrição que indique à IA quando usá-la (por exemplo, “Use quando um usuário perguntar sobre o status do pedido. Primeiro, peça o número do pedido.”).
4. Defina o método HTTP (por exemplo, GET), a URL do endpoint e os parâmetros necessários. Depois, salve.

A ação agora fica disponível para o agente nos canais compatíveis. As Discord Actions da galeria são ações HTTP Request comuns e editáveis. Portanto, revise a autorização, os destinos e os parâmetros depois de alterá-las. Para um passo a passo mais detalhado, veja o tutorial de AI Actions com HubSpot, o guia de bot de moderação do Discord (timeout, expulsão, banimento, cargos e modo lento como AI Actions) ou a documentação de Actions.

Continue lendo

Estes guias abordam assuntos relacionados com mais detalhes:

• Como criar um chatbot de IA para roleplay que mantém o personagem: transforme o mesmo bot em um personagem persistente com seu próprio cânone.
• Como criar um chatbot de IA para Telegram: publique o mesmo agente de IA no Telegram.
• Crie um bot de IA para WhatsApp: guia de integração com o WhatsApp.
• AI Actions com HubSpot: tutorial passo a passo para configurar API Actions.
• Bot de tickets com IA para Discord: responda com sua base de conhecimento e encaminhe o restante para threads privadas de tickets.
• Bot de boas-vindas do Discord: receba novos membros, novas threads e novos canais de tickets com uma mensagem fixa.
• Conecte um agente de IA aos tickets do Jira: exemplo de Remote MCP com Jira.
• MCP explicado: o que é o Model Context Protocol e como funciona.
• Documentação de Actions: referência completa.

Cadastre-se no Quickchat AI para começar a criar seu agente de IA ou participe da comunidade no Discord: discord.gg/KqkHwvPRNH