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

5 passos simples para criar seu bot de IA

Seguindo estes passos, você terá um chatbot de IA totalmente funcional no seu servidor do Discord:

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.

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 nome e avatar personalizados, 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.

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.

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