Um bot de boas-vindas do Discord publica uma mensagem pronta quando algo acontece no servidor: um membro entra, uma thread é aberta ou um canal é criado. O Quickchat AI envia essas mensagens a partir de três regras configuradas em um painel, sem código nem hospedagem.
Este tutorial configura e testa as três e mostra o que acontece quando alguém responde à saudação e começa uma conversa com IA. Ele cobre as duas maneiras de conectar o Discord ao Quickchat AI, incluindo a configuração adicional do Developer Portal exigida pela regra de membros quando você usa seu próprio bot.
Por que criamos isso: três pedidos do nosso Discord
Os membros do nosso servidor do Discord pediam a mesma coisa de três formas diferentes. Em cada caso, nosso bot de suporte precisava dizer que não era possível.
Juntos, os três pedidos são um só: deixe o bot falar primeiro. Receba quem entra. Cumprimente quem abre uma thread. Diga olá em um novo canal de ticket, antes que a pessoa tenha de descobrir que existe um bot ali.
A pergunta chegou o ano inteiro, pelo Discord e pelo widget. Desde esta semana, as três opções existem como regras de mensagens automáticas ativadas em uma caixa de diálogo. Este artigo configura todas, do início ao fim.
Por que um bot do Discord não cumprimenta ninguém por padrão
Um bot do Quickchat AI no Discord responde quando é mencionado ou quando alguém responde a uma mensagem dele. O bot compartilhado com um clique também aceita /ask. Isso é intencional: responder a tudo tornaria o bot inviável em um servidor movimentado. O efeito colateral é que, em um canal criado há dez segundos, ninguém sabe que ele está presente. Ele não fala primeiro e, por isso, ninguém fala com ele.
É o problema do início da conversa, ainda pior em um canal de ticket recém-criado, no qual o membro tem uma pergunta e não sabe que há algo capaz de responder.
A mensagem automática permite que o bot fale primeiro. É um texto fixo, sem custo, que não pode dizer nada além do que você escreveu e termina explicando como iniciar uma conversa real. As três regras correspondem aos pedidos anteriores: New member joins, New channel e New thread or forum post.
O que você vai criar
O servidor de demonstração é o Nebula Lounge, uma comunidade cujo agente se chama Orbit. Ao final, terá três saudações ativas:
| Regra | Quando dispara | Onde publica |
|---|---|---|
| New member joins | Uma pessoa entra no servidor | Um canal escolhido, #welcome |
| New thread or forum post | Uma thread pública ou postagem de fórum é aberta | Dentro da nova thread |
| New channel | Um canal de texto é criado | Dentro do novo canal |
Você precisa de uma conta gratuita no Quickchat AI e permissão para adicionar um bot a um servidor do Discord. Um bot de tickets como Ticket Tool é opcional e necessário apenas para o fluxo de tickets da última seção.
Como funcionam as mensagens automáticas do Discord
Uma mensagem automática segue um processo determinístico, sem chamar um modelo. O Discord envia o evento, o Quickchat AI verifica se ele está no escopo da regra, aguarda o atraso configurado, preenche os campos e publica o texto.
Nenhuma etapa pergunta a um modelo o que dizer. Isso torna a mensagem previsível para deixá-la ativa em um servidor público e explica por que não custa créditos.
A conversa com IA é um sistema separado que começa depois, quando um membro menciona o bot ou responde a ele.
O que as mensagens automáticas não fazem
Quatro coisas que se pode esperar de um “bot de boas-vindas” estão fora desse recurso.
- Verificação. Não há CAPTCHA, verificação de idade ou identidade, nem cargo de verificado. Use um bot de verificação específico junto com este.
- Texto escrito por IA. A mensagem é o seu texto com os campos preenchidos. O modelo não recebe o evento nem escreve a saudação.
- Criação de tickets. O Quickchat AI não abre o canal. Seu bot de tickets o cria e o Quickchat AI recebe a pessoa dentro dele.
- Envio em massa ou agendamento. Cada regra responde a um evento do Discord. Não há “publique toda segunda-feira” nem envio para uma lista de membros.
Conecte o bot ao servidor do Discord
Abra External Apps no painel do Quickchat AI e escolha Discord. Defina Bot name in the new server se quiser um nome próprio, clique em Add to your Discord server e autorize. Esse é o fluxo com um clique: o bot compartilhado Quickchat AI entra no servidor e você não cria aplicações nem lida com tokens.
Garanta que o bot tenha View Channel e Send Messages em todos os destinos. Canais que ele não pode ver não aparecem nos menus, e destinos onde não pode publicar são ignorados silenciosamente no envio.
Qual configuração você usa e o que muda
O Quickchat AI se conecta ao Discord de duas maneiras, e as mensagens automáticas funcionam em ambas. A opção escolhida muda onde ficam as regras e se você precisa de uma configuração no Developer Portal.
| Com um clique | Sua aplicação do Discord (Advanced) | |
|---|---|---|
| Qual bot publica | A aplicação compartilhada Quickchat AI | A aplicação que você criou |
| Onde ficam as regras | Automated messages de um servidor em Connected servers | Automated messages na página do Discord, com Configure por servidor |
| New channel e New thread or forum post | Aplicação imediata | Atualização em cerca de um minuto |
| New member joins | Aplicação imediata | Exige Server Members Intent e atualiza em cerca de um minuto |
A última linha se deve a uma regra do Discord, não do Quickchat AI. Entendê-la explica a única etapa manual deste tutorial.
Um intent é o sistema de inscrição em eventos do Discord. Ao conectar, o bot declara quais categorias de eventos quer receber, e o Discord envia somente essas. A maioria dos intents basta solicitar. Três são privilegiados: o Discord só os libera quando o proprietário da aplicação os ativa manualmente. Um deles cobre os membros do servidor.
Assim, uma aplicação só recebe eventos de entrada de membros se Server Members Intent estiver ativado no Developer Portal. Ele vem desativado em aplicações novas. Criar canais e threads não são eventos privilegiados, então as outras regras não exigem nada.
A aplicação compartilhada com um clique já tem esse intent ativado. Se você conectou assim, não precisa fazer essa configuração.
Se usa sua aplicação, o Quickchat AI verifica a opção por você. Abra New member joins: a regra informa quando o intent está desativado e não mostra aviso quando está ativo. Para ativá-lo, abra sua aplicação no Discord Developer Portal, vá para Bot → Privileged Gateway Intents, ative Server Members Intent, salve e salve novamente a regra no Quickchat AI. O bot continua respondendo normalmente durante todo o processo; apenas essa regra aguarda.
Um limite a considerar: se seu bot está em mais de 100 servidores, o Discord exige verificar a aplicação antes de conceder o intent.
Abra Automated messages
Encontre seu servidor e abra Automated messages, em Connected servers na configuração com um clique ou pelo botão Configure na seção Automated messages da aplicação própria. As três regras aparecem, cada uma com seu interruptor, inicialmente desativadas.
Dois detalhes dessa tela influenciam como você trabalha nela.
Cada regra é salva separadamente. Abrir, editar e clicar em Save salva apenas aquela regra e retorna à lista. As outras duas não mudam.
Os interruptores da lista salvam imediatamente. Não é necessário pressionar mais nada. A configuração com um clique se aplica na hora; bots via Advanced atualizam as regras em cerca de um minuto. Se uma saudação gerar mais mensagens que o esperado, um clique inicia a mudança.
Receba cada novo membro
Selecione New member joins. A regra abre com interruptor, destino, modelo de mensagem e atraso próprios.
Defina Welcome channel como #welcome. Depois, configure Message template:
Welcome to {server_name}, {username}! I'm {bot_name}. Mention me or use /ask whenever you need help.Deixe Delay em 2 segundos, ative Turn this message on e clique em Save.
Se usa sua própria aplicação do Discord, remova a parte sobre /ask. Esse comando existe apenas na aplicação compartilhada Quickchat AI.
Os botões abaixo do modelo inserem um campo onde está o cursor, sem precisar memorizar sua grafia. {username} é o membro que entrou, {server_name} é o servidor e {bot_name} é o nome do bot nesse servidor, incluindo o nome definido durante a conexão.
Para testar, entre com uma segunda conta do Discord.
O intervalo entre o aviso do Discord e a saudação é o atraso funcionando. Todas as regras têm essa opção, que vai de nenhum atraso a trinta segundos.
Teste negativo: convide outro bot ao servidor. Nada será publicado. A regra ignora contas de bots de propósito, para não enviar boas-vindas a um software quando uma aplicação ou webhook é instalado.
Cumprimente novas threads e postagens de fórum
Selecione New thread or forum post e defina Parent channel como seu fórum de ajuda. A regra dispara para threads públicas e postagens criadas sob esse canal pai e ignora threads privadas.
Parent channel é o canal em que novas threads aparecem. Dois tipos de canal podem contê-las: um canal de texto comum, no qual a thread parte de uma mensagem existente, e um canal de fórum, no qual cada postagem é uma thread e não existe histórico comum de mensagens no canal. Os fóruns só ficam disponíveis quando Community está ativado nas configurações do servidor. Ambos funcionam, mas um fórum de ajuda é uma escolha natural, pois cada pergunta já vira sua própria thread. Fóruns também não contêm threads privadas, então todas as postagens se qualificam.
Hi {username}, I'm {bot_name}. Mention me in this thread if you'd like help. If you prefer a human, leave your question here and they'll follow up.
Aqui, {username} é quem abriu a thread, informado diretamente pelo Discord e, portanto, sempre correto. {channel_name} é a própria thread.
Essa regra atende ao padrão solicitado de “responder apenas nas threads criadas para cada pergunta”: cada nova thread começa com o bot presente, explicando como usá-lo.
Teste negativo: selecione um canal pai de texto adequado e abra nele uma thread privada. Nada será publicado. Threads privadas são excluídas, mantendo silenciosas as conversas privadas de moderadores. Canais de fórum não permitem criar threads privadas.
Cumprimente todo novo canal ou apenas sua categoria de tickets
Selecione New channel. Por padrão, a regra publica em todo novo canal de texto do servidor, algo útil em comunidades pequenas: qualquer canal criado recebe a apresentação do bot.
Hi {username}, I'm {bot_name}. Reply to me or mention me if you need help. If you'd rather wait for a human, share your question and they'll get back to you as soon as possible.Para restringir, troque Any category por Only in this category e escolha uma categoria.
Uma categoria no Discord é o grupo recolhível de canais na barra lateral esquerda: o título cinza com os canais recuados abaixo. Bots de tickets quase sempre criam canais em uma categoria, normalmente chamada Tickets ou Support, o que a torna um filtro útil.
Esse é o fluxo de tickets. Aponte a regra para a categoria onde o bot de tickets cria canais. Canais criados em outros lugares do servidor serão ignorados.
Teste negativo: com a regra limitada a Active Tickets, crie um canal em outra categoria. Nada será publicado ali, e um ticket aberto logo depois ainda receberá a saudação.
Como a saudação chega ao ticket
O Ticket Tool cria ticket-0042 em Active Tickets e publica seu painel. Alguns segundos depois, o Quickchat AI publica a saudação abaixo dele. O atraso garante essa ordem: com No delay, as mensagens competem, e a saudação pode aparecer acima do painel que o membro deveria ler primeiro. Cinco segundos é um bom começo, pois também é preciso dar tempo para o bot aplicar as permissões do canal.
Como o bot identifica quem abriu o ticket
Em um canal de ticket, {username} é deduzido, não informado diretamente. O evento de criação do Discord informa canal e categoria, mas não a pessoa a quem o ticket pertence, pois, para o Discord, foi o bot de tickets que o criou.
O evento inclui, porém, as sobrescritas de permissões do canal.
Uma sobrescrita de permissão é uma configuração de um canal para um cargo ou uma pessoa, que substitui as permissões gerais do servidor. É assim que canais privados funcionam: View Channel é retirado de @everyone e concedido novamente às poucas pessoas que devem ver o canal.
Bots de tickets usam exatamente esse mecanismo. Eles concedem ao solicitante uma permissão pessoal View Channel no canal novo, para que apenas ele e o suporte tenham acesso. O Quickchat AI lê essas permissões e procura a única pessoa entre elas. Como a maioria dos bots também concede acesso a si mesma, cada permissão pessoal é verificada no Discord e os bots são descartados. Se resta exatamente uma pessoa, ela é o solicitante. Qualquer outro resultado, inclusive uma conta que não pôde ser consultada, usa there em vez de adivinhar.
Quando faltam evidências ou há mais de uma pessoa possível, {username} vira there, por isso o modelo em inglês acima funciona nos dois casos. Escreva o seu levando esse fallback em conta e não trate o nome como verificação de identidade: é uma conveniência deduzida de uma permissão, não um usuário autenticado.
Campos de substituição e seus valores
| Campo | New member joins | New thread or forum post | New channel |
|---|---|---|---|
{username} | Membro que entrou | Pessoa que abriu a thread | Solicitante deduzido das permissões ou there |
{bot_name} | Nome do bot neste servidor | Igual | Igual |
{server_name} | Nome do servidor | Igual | Igual |
{channel_name} | Canal de boas-vindas | Nova thread | Novo canal |
Os modelos aceitam até 1.500 caracteres. Campos que não sejam um desses quatro são rejeitados ao salvar, em vez de aparecerem depois como {chaves} literais. Assim, um erro de digitação é detectado no painel, não diante da comunidade.
Escolhendo o atraso
| Atraso | Quando usar |
|---|---|
| No delay | Nenhum outro bot publica no destino e você quer que a saudação seja a primeira mensagem |
| 2 segundos | Padrão. Outro bot publica primeiro um painel ou embed, como na maioria dos fluxos de tickets e integração inicial |
| 5 a 30 segundos | O outro bot é lento, publica várias mensagens ou renomeia o canal após criá-lo |
Um atraso maior também dá tempo para o bot de tickets aplicar as permissões usadas para obter {username}. Essa disputa costuma terminar em um ou dois segundos; portanto, aumentar o atraso não resolve uma saudação que sempre usa there.
O que acontece depois da saudação
A saudação termina explicando como chamar o bot. Depois, segue a conversa normal do Quickchat AI: ele responde com a base de conhecimento e um colega pode assumir a qualquer momento pela Inbox do Quickchat AI. O membro permanece no Discord.
Os dois sistemas dividem o trabalho: a mensagem fixa inicia o contato e a IA conduz a conversa seguinte.
Solução de problemas
| Sintoma | Causa |
|---|---|
| Nenhuma saudação | Faltam View Channel ou Send Messages no destino; o bot ignora o envio sem gerar erro |
| Nenhuma saudação em thread nova | Falta Send Messages in Threads ou a thread é privada |
| Sem saudação ao entrar um membro, com aplicação própria | Server Members Intent está desativado; ative no Developer Portal e salve a regra novamente |
| Nada quando um bot entra | Comportamento esperado; a regra de membros ignora bots |
{username} aparece como there nos tickets | Ninguém ou mais de uma pessoa tem View Channel pessoal; não é possível deduzir quando o bot concede acesso por cargo |
| Saudação acima do painel do ticket | Atraso curto demais; aumente para 5 segundos |
| Saudação em canais inesperados | New channel está em Any category; restrinja com Only in this category |
| Ao salvar, uma seleção não está mais disponível | O canal ou categoria foi excluído no Discord; escolha um existente e salve novamente |
Colocando em produção
Ative uma regra por vez e observe por um dia antes de acrescentar a próxima. A de membros é a mais segura para começar, pois o destino é um canal escolhido. New channel com Any category gera mais mensagens, já que publica em todo canal criado; acompanhe-a desde o início se usar essa configuração.
Meça saudações e conversas separadamente. Cada tentativa de saudação é gratuita. O que importa é quantas mensagens entregues levam alguém a conversar de fato com o bot. Se não houver entrega, verifique as permissões no Discord.
FAQ
Como criar um bot de boas-vindas no Discord?
Adicione o Quickchat AI ao servidor com um clique, abra o servidor em Connected servers e selecione Automated messages. Ative New member joins, escolha o canal, edite o modelo e clique em Save. Não é necessário hospedar nada, programar ou criar uma aplicação do Discord.
Um bot do Discord pode enviar mensagem quando alguém entra?
Sim. New member joins tenta enviar uma mensagem fixa no canal escolhido sempre que uma pessoa entra. O bot precisa poder ver e enviar mensagens nesse canal. Entradas de bots são ignoradas, então instalações de aplicações ou webhooks não disparam a regra.
O bot pode cumprimentar alguém quando um canal de ticket é criado?
Sim, e esse é o motivo do recurso existir. O Ticket Tool ou uma aplicação similar cria o canal, e New channel publica sua saudação. Mantenha um atraso, começando por cinco segundos, para que o bot de tickets publique o painel e aplique as permissões primeiro.
O bot pode publicar em todo novo canal ou apenas em uma categoria?
Ambos. New channel publica em todo novo canal de texto por padrão. Para limitar à categoria de tickets, troque Any category por Only in this category e escolha a categoria. Canais criados fora dela são ignorados.
Posso atrasar uma mensagem de boas-vindas?
Sim. Escolha No delay ou 2, 5, 10 ou 30 segundos. O padrão é dois segundos porque um bot de tickets ou de integração inicial costuma publicar um painel primeiro. A saudação fica mais legível abaixo dele do que escondida acima.
Posso personalizar a mensagem de boas-vindas?
Sim. Cada regra tem um modelo de até 1.500 caracteres e aceita {username}, {bot_name}, {server_name} e {channel_name}. Selecione um campo abaixo da caixa para inseri-lo na posição do cursor.
A mensagem de boas-vindas consome créditos de IA?
Não. É um texto fixo com campos preenchidos. Não chama o agente de IA, não consome créditos de conversa e não executa AI Actions. Créditos só são usados se o membro conversar depois com o bot.
Preciso de código para criar isso?
Não. É uma configuração no painel do Quickchat AI. No fluxo com um clique, você não cria aplicações do Discord, não hospeda nada e não manipula tokens.
Funciona se conectei o Discord com meu próprio token de bot?
Sim. As mensagens automáticas funcionam nos dois modos. No Advanced, as regras ficam em Automated messages na página do Discord, com Configure por servidor. Há uma etapa extra: New member joins exige Server Members Intent ativado na sua aplicação.
O que é Server Members Intent e por que a regra precisa dele?
O Discord trata a lista de membros como informação privilegiada. O bot só recebe eventos de entrada se Server Members Intent estiver ativado no Developer Portal. As regras de canais e threads usam um intent ativo por padrão e não exigem alterações. O Quickchat AI verifica a opção e avisa na regra quando está desativada.
O que acontece depois de publicar a saudação?
Nada até alguém responder. A saudação é fixa, e a conversa com IA só começa quando alguém menciona o bot ou responde a ele. O bot compartilhado também aceita /ask. Esse é o objetivo: mostrar às pessoas de um canal recém-criado que há algo ali com que conversar.
Esse é um bot de verificação do Discord?
Não. As mensagens não exibem CAPTCHA, não verificam identidade ou idade e não concedem cargo de verificado. Para isso, use um bot de verificação específico junto com este.
Pode enviar uma despedida quando alguém sai?
Não. As regras disparam na entrada de um membro, na abertura de thread ou postagem de fórum e na criação de canal. O evento de saída não está incluído. Se precisa das duas coisas, use também um bot dedicado a boas-vindas e despedidas.
Isso substitui o Ticket Tool?
Não. O Ticket Tool cria o canal e o Quickchat AI recebe a pessoa dentro dele. Os dois funcionam juntos, por isso existe o atraso.
Funciona com outros bots de tickets além do Ticket Tool?
Sim. Nada é específico do Ticket Tool. Qualquer bot que cria um canal e concede View Channel pessoal ao solicitante funciona da mesma forma, assim como um canal criado manualmente. O Ticket Tool é citado por ser comum, não obrigatório.
O bot saberá quem abriu o ticket?
Geralmente. Bots de tickets concedem View Channel pessoal ao solicitante, e o Quickchat AI lê essa permissão para preencher {username}, ignorando as que pertencem a bots. Se não houver permissão pessoal ou houver mais de uma pessoa, usa there. Escreva o modelo levando esse fallback em conta.
O bot cumprimenta threads privadas?
Não. Só threads públicas e postagens de fórum sob o canal pai escolhido disparam a regra. Threads privadas são ignoradas.
De quais permissões do Discord o bot precisa?
View Channel e Send Messages em cada destino, além de Send Messages in Threads para a regra de threads. Se não puder enviar, o bot ignora a mensagem sem mostrar erro. Verifique as permissões primeiro quando a saudação não aparecer.
Posso desligar uma regra rapidamente se ela gerar mensagens demais?
Sim. O interruptor da lista salva imediatamente, então basta um clique. A configuração com um clique vale na hora. Bots via Advanced atualizam suas regras em cerca de um minuto. Não é preciso abrir a regra nem salvar mais nada.
Quanto custa um bot de boas-vindas do Discord?
Nada para configurar. As mensagens automáticas são configuração, não uso de IA, e não consomem créditos em nenhum plano. O plano gratuito permite usar as três regras.
Outros projetos para Discord
- Crie um bot de IA para Discord: conecte um agente e dê a ele uma base de conhecimento.
- Bot de tickets com IA para Discord: crie a thread privada e o encaminhamento humano que podem seguir a saudação.
- Bot de moderação com IA para Discord: use AI Actions para timeout, banimento e cargos.
- Melhores bots de IA para Discord: compare os usos dos diferentes bots.
- A documentação do canal Discord descreve todas as configurações desta página.