Discord

Há duas formas de conectar seu AI Agent ao Discord:

1. Adicionar ao seu servidor do Discord: o fluxo recomendado com um clique. Sem Developer Portal e sem token de bot, no ar em menos de um minuto.
2. Use a sua própria app do Discord: o fluxo avançado em que você cria um aplicativo do Discord e informa você mesmo um token de bot.

Recomendamos o fluxo com um clique. Você pode mudar para seu próprio app depois, se precisar dos recursos avançados.

Novo no Quickchat AI? Crie uma conta gratuita e volte aqui. Você também pode ler mais sobre o Quickchat AI para Discord.

Conectar com o Discord (recomendado)

No painel do Quickchat AI, abra Aplicativos externos na barra lateral esquerda, encontre Discord e abra-o. Em Connect, revise o Nome do bot no novo servidor, preenchido com o nome do seu AI Agent. Você pode alterá-lo ou deixá-lo vazio para usar Quickchat AI. Depois, clique em Adicionar ao seu servidor do Discord. Você precisa da permissão Manage Server no servidor de destino.

Você será redirecionado ao Discord para autorizar o app compartilhado do Quickchat AI. Escolha o servidor desejado e confirme a autorização. O Quickchat aplica o nome escolhido antes de o bot publicar sua mensagem única de apresentação: “Ready! @mention me or use /ask to chat. Powered by Quickchat AI.” Depois, você voltará ao Quickchat AI.

O que acontece a seguir depende do andamento da sua configuração. Se você ainda não terminou a configuração da nova conta, o Quickchat confirma o servidor conectado e pede que você adicione seu site à Base de conhecimento. Adicione o site para continuar a configuração normal ou clique em Ignorar por agora para ir direto à etapa Escolha o seu plano. Depois da etapa do plano, a configuração termina no AI Preview. Se a configuração já estiver concluída, você volta ao painel, onde o servidor aparece como conectado.

A autorização já está concluída. 🎉 Seu AI Agent está ativo no Discord. Os membros iniciam uma conversa mencionando-o com @ em um canal, e ele responde em canais ou threads.

Todas as conversas do Discord aparecem na Caixa de entrada do Quickchat AI. Quando seu AI Agent transfere uma conversa para um colega, ele pode assumir o controle na Caixa de entrada e responder diretamente no mesmo canal, na mesma thread ou na mesma mensagem direta do Discord.

Novos usuários do Quickchat AI recebem uma configuração com a marca do Discord que os leva direto para esse fluxo, então você pode ter conectado seu primeiro servidor durante o onboarding.

Como os membros falam com o bot

O bot não responde a todas as mensagens de um canal. Ele responde quando recebe uma @menção, quando alguém usa o comando /ask, quando alguém responde a uma das mensagens dele e dentro dos tópicos que ele criou. Ignora todo o resto de propósito, para não poluir um servidor movimentado.

Vale avisar os membros, porque uma mensagem comum sem resposta parece um bot quebrado, e não um bot esperando ser chamado.

/ask costuma ser mais fácil de descobrir: digitar / em qualquer canal exibe “Ask the Quickchat AI agent a question” na lista, e o comando funciona onde o conteúdo das mensagens é restrito. Está disponível apenas no bot de um clique, então se você usa seu próprio aplicativo do Discord, recorra às @menções.

Limite de mensagens

Cada resposta é gerada por um modelo de linguagem e conta para o limite de mensagens de IA do seu plano. Um servidor movimentado consome rápido um limite gratuito, e quando ele acaba o bot avisa no canal em vez de responder. O limite é renovado todo mês.

Gerenciando seus servidores

A página do Discord lista todos os servidores em que o bot compartilhado está ativo, em Servidores conectados. A partir daí, você pode:

• Alterar o nome do bot mais tarde. Digite até 32 caracteres em Nome do bot neste servidor e clique em Aplicar. Apague o conteúdo e clique em Aplicar para restaurar o nome compartilhado Quickchat AI.
• Adicionar a outro servidor com o mesmo fluxo de um clique. Revise o Nome do bot no novo servidor antes da autorização, para que um AI Agent possa usar um nome diferente em cada servidor.
• Remover o bot de um servidor. Ele sai daquele servidor e para de responder, e você pode adicioná-lo novamente quando quiser.

Um servidor do Discord pode estar conectado a apenas um AI Agent por vez. Se você vir “Este servidor do Discord já está conectado a outro AI Agent,” remova-o desse Agent primeiro ou escolha um servidor diferente.

Se o Discord conectar o servidor sem aplicar o nome do bot, clique em Aplicar nesse servidor conectado para tentar novamente. Se o Discord informar um problema de permissão, clique em Adicionar a outro servidor, escolha o mesmo servidor e autorize-o novamente. Isso atualiza as permissões do bot sem desconectá-lo, portanto não é preciso removê-lo primeiro.

Quando usar seu próprio app do Discord

O bot de um clique usa o aplicativo e o avatar compartilhados do Quickchat AI, mas você pode dar a ele um nome diferente em cada servidor conectado. Configure seu próprio app do Discord (veja abaixo) quando você quiser:

• Um avatar de bot personalizado
• Mensagens diretas
• Discord AI Actions. O bot compartilhado não expõe seu token como o System Token {{discord_bot_token}} de que essas Actions precisam, então elas exigem seu próprio app.
• Vários bots em um mesmo servidor

O bot compartilhado e o seu próprio bot podem funcionar lado a lado. Seu próprio app só assume um servidor depois que você remove o bot compartilhado daquele servidor.

Usar seu próprio app do Discord (Configuração avançada)

Este é o caminho avançado e leva cerca de 10 minutos. No painel, abra Aplicativos externos → Discord e abra Use a sua própria app do Discord pelo link Configuração avançada. Você cria seu próprio aplicativo do Discord, adiciona-o ao seu servidor e o conecta ao Quickchat AI com um token de bot.

Play

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=309237713920&scope=bot

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

O número de permissões (309237713920) corresponde às 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 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=309237713920&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, abra Aplicativos externos → Discord, escolha Use a sua própria app do Discord pela Configuração avançada e cole seu token. O Quickchat AI ativa o bot e informa o status conforme ele inicia.

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.

Ações do Discord

Com seu próprio app do Discord conectado, abra Ações & MCPs, clique em + Add Action e escolha Ação Discord. A galeria instala Ações completas de suporte e moderação:

• Suporte e tickets: selecione um servidor e um canal de texto e, opcionalmente, um cargo de suporte mencionável. Uma instalação cria três Ações editáveis que abrem uma thread privada, adicionam o solicitante e, opcionalmente, notificam o suporte.
• Moderação: timeout, expulsão, banimento, desbanimento, atribuição de cargo, slowmode e envio de anúncio. Cada template cria uma Ação editável.

O Quickchat preenche no backend o método, a URL, os cabeçalhos, o corpo, os parâmetros, a descrição, o tratamento da resposta e as condições de Executar somente quando de cada Ação. As Ações resultantes usam o editor normal e continuam totalmente editáveis.

Todos os templates de moderação começam com author_is_admin is true. O Discord fornece esse valor para o autor da mensagem atual, e o Quickchat o verifica antes de chamar a Ação. O chat público e os metadados da API não podem defini-lo. Mantenha essa condição, a menos que você tenha criado outra barreira de autorização confiável. Os templates não adicionam mensagens de confirmação, proteção contra replays, tratamento de novas tentativas nem uma policy separada de permissões e hierarquia de cargos. O Discord ainda verifica as permissões e a posição do cargo do bot.

Cuidado

As Ações do Discord precisam do token do bot da Configuração avançada com seu próprio app do Discord. O bot compartilhado de um clique não consegue fornecê-lo sozinho. Teste as Ações de moderação no servidor do Discord com uma conta de administrador e outra sem esse acesso; o AI Preview não fornece um remetente autorizado do Discord.

Suporte e tickets usa Salvar na memória e Executar somente quando em vez de um runtime especial de fluxo. A primeira Ação salva o ID da thread retornado pelo Discord como discord_ticket_thread_id. As duas seguintes leem esse valor para adicionar o solicitante e publicar a notificação. Descreva a mesma ordem no prompt principal do Agent. Se o resultado for incerto, verifique o Discord e o log da Ação antes de tentar novamente. O ID da thread salvo não é apagado automaticamente, portanto o template aceita um ticket por conversa do Quickchat. Para outro ticket, inicie uma nova conversa ou thread no Discord, ou edite as Ações para adicionar o ciclo de vida da memória de que você precisa.

Para Suporte e tickets, conceda ao bot View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads e Manage Threads no canal de tickets selecionado. A notificação de um cargo é opcional. Se você selecionar um cargo de suporte, torne-o mencionável e dê aos seus membros acesso às threads privadas. Sem um cargo selecionado ou quando nenhum cargo mencionável estiver disponível, os tickets continuarão sendo abertos normalmente sem notificar um cargo. O seletor lista canais de texto e cargos mencionáveis, mas não verifica todas as substituições de permissões do canal.

Consulte Ações para ver a configuração gerada e as limitações do MVP.

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.

Conexão com um clique

O fluxo de um clique raramente apresenta erros. Se a conexão não for concluída:

• “Este servidor do Discord já está conectado a outro AI Agent”: o servidor está mapeado para um Agent diferente. Remova-o desse Agent primeiro ou escolha um servidor diferente.
• “Você não tem permissão para conectar o Discord para este AI Agent”: conectar um canal é uma ação de editor. Peça a um admin ou editor da conta para conectá-lo e verifique se você tem a permissão Manage Server no servidor do Discord que você escolheu.
• “A autorização do Discord foi cancelada”: você fechou a tela de autorização do Discord antes de concluir. Nada foi conectado, então clique em Adicionar ao seu servidor do Discord e tente novamente.

As seções abaixo se aplicam ao fluxo Use a sua própria app do Discord.

O bot está no meu servidor mas nunca responde

Quase sempre isso significa que ninguém se dirigiu a ele ainda. O bot responde a @menções, a /ask, a respostas às próprias mensagens dele e a mensagens dentro dos tópicos que ele criou, e ignora todo o resto. Mencione-o com @ e veja se ele responde.

Se ainda assim não responder, verifique se o cargo dele e as exceções de permissão do canal permitem View Channel, Send Messages e Read Message History naquele canal específico.

Se ele respondia antes e agora ficou em silêncio, verifique se o limite de mensagens de IA do mês acabou.

/ask não aparece quando eu digito /

O Discord pode levar até uma hora para distribuir os comandos a todos os clientes depois que um bot entra. Reiniciar seu cliente do Discord costuma adiantar. Enquanto isso, mencione o bot com @.

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 Aplicativos externos → 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 Aplicativos externos → Discord.

Dica

A página de integração do Discord no painel do Quickchat AI mostra seus Servidores conectados para o bot de um clique e, na Configuração avançada, o campo Bot Token do seu próprio app, 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