Bot de tickets com IA para Discord: responda primeiro e encaminhe depois (sem código)

Piotr Grudzień
Publicado em 18 min de leitura
Bot de suporte respondendo no Discord pela base de conhecimento e abrindo uma thread privada com notificação ao cargo de suporte

O Quickchat AI responde às perguntas de suporte no seu servidor do Discord usando sua documentação e abre uma thread privada de ticket somente quando não consegue responder. Este guia cria o bot do início ao fim, sem código, em cerca de meia hora.

Ele funciona como atendimento de primeira linha. Um membro pergunta como redefinir uma chave de API e recebe as etapas reais no canal. Quando pergunta algo ausente na documentação, o bot reconhece a limitação em vez de inventar, abre uma thread privada, adiciona o membro, menciona o cargo de suporte com um resumo e transfere a conversa para uma pessoa que responde pela Inbox.

Escolha a tarefa do seu bot do Discord

Esta configuração responde dúvidas de suporte e encaminha lacunas da documentação. Use o guia de boas-vindas para saudações fixas e o de moderação para comandos de administradores.

TarefaGuiaConexão do Discord
Responder pela documentação e abrir um ticket privado quando faltar informaçãoEste guia de suporte e ticketsSeu próprio aplicativo Discord
Publicar saudação fixa na entrada de um membro ou criação de canalBot de boas-vindasUm clique ou aplicativo próprio
Aplicar timeout, gerenciar cargos ou alterar slowmode quando o administrador pedirBot de moderação com IASeu próprio aplicativo Discord

Você precisa de:

  • um agente do Quickchat AI (crie sua conta)
  • um servidor do Discord no qual seja administrador

Do cadastro ao primeiro teste de suporte

  1. Se usar e-mail e senha, abra o link de verificação recebido. Descreva um agente de suporte do Discord, clique em Create my AI Agent e conclua a configuração, incluindo um plano adequado ao uso.
  2. Adicione os documentos em Knowledge Base. Em External Apps, abra Discord, Use your own Discord app e Advanced setup. O bot compartilhado responde perguntas, mas não executa as Actions de tickets deste guia.
  3. Crie um canal de tickets e um cargo de suporte mencionável no servidor de teste. Em Actions and MCPs, escolha Add Action, Discord Action e instale Open Support Ticket com esse servidor, canal e cargo.
  4. Depois de aplicar as instruções abaixo, mencione o bot com uma pergunta coberta e outra não coberta. A primeira deve receber resposta sem ticket; a segunda deve abrir uma única thread privada e avisar o cargo. Acrescente detalhes à segunda conversa e confirme que não abre um duplicado.

O Free é para uso pessoal e não comercial. Escolha um plano pago antes de usar em um negócio. Termine os dois testes antes de convidar clientes.

As capturas mostram Lumen, o bot de suporte da empresa fictícia de análise de produto Beacon. A empresa foi inventada para um exemplo neutro, mas cada conversa, chamada de API e thread foi criada por um agente real, usando o sistema real de respostas em um servidor real do Discord.

Ferramentas opcionais de configuração

  • Prepare um pequeno pacote de lançamento. Transforme um objetivo, canal, resumo de encaminhamento e até cinco pares de perguntas e respostas em textos de configuração e testes sintéticos. A ferramenta não cria nem avalia um agente de IA.
  • Valide um dataset de teste. Confira se um pequeno dataset fornecido segue o formato aceito, sem executar seu agente de IA.

O que você vai criar

Um membro pergunta, o agente consulta a base e responde no canal ou abre thread privada, adiciona o membro e menciona o cargo de suporte Uma decisão por pergunta. O caminho resolvido não exige nenhuma gravação adicional de ticket no Discord.

Três AI Actions fazem o encaminhamento, instaladas por uma única opção da galeria:

EtapaO que aconteceChamada do Discord
Pergunta cobertaResposta no canal pela base de conhecimentonenhuma
Pergunta não cobertaO agente reconhece que não tem a informaçãonenhuma
… abre um ticketThread privada no canal de ticketsPOST thread do canal
… adiciona o membroA pessoa que perguntou entra na threadPUT membros da thread
… avisa a equipeResumo com menção ao cargo de suportePOST mensagem da thread
Atendimento humanoConversa sinalizada na Inbox e resposta de volta ao DiscordHuman Handoff

O que é a base de conhecimento e como determina o volume de tickets

Se você nunca criou um agente de IA, vale entender este conceito antes de continuar.

A base de conhecimento reúne sua própria documentação, carregada no agente e indexada para busca durante a conversa. Você pode fornecer a URL do centro de ajuda para a Quickchat AI extrair as páginas, colar artigos manualmente ou enviar arquivos. Ao responder, o agente pesquisa esse conteúdo e usa o que encontra, em vez de depender apenas do que o modelo de linguagem aprendeu sobre o mundo. Se ainda não tiver documentação, como criar uma base de conhecimento para chatbot explica o que escrever e em qual ordem.

Documentação, artigos colados e arquivos são indexados; perguntas cobertas recebem respostas e lacunas geram tickets O fluxo responde ao que a documentação cobre e encaminha o que falta.

Essa cobertura é o principal fator para reduzir tickets neste projeto. Não depende de um truque no prompt nem apenas da capacidade do modelo. Quando o bot encaminha mais perguntas do que você esperava, os tickets mostram quais páginas ou informações ainda faltam na documentação.

Exemplo ilustrativo de uma base pequena gerando mais tickets e de novos artigos movendo perguntas para respostas O gráfico é ilustrativo, não uma medição. Ele mostra a direção esperada: adicionar documentação permite responder a mais perguntas sem encaminhamento.

Respostas de suporte com IA no Discord

Para perguntas documentadas, o bot fornece as etapas reais. Este é o teste resolvido, sem edição:

Membro pergunta a Lumen como redefinir uma chave de API Beacon e recebe as etapas exatas da base Resposta pelo artigo no canal. Nenhum ticket foi necessário.

Quando a resposta não existe, o bot informa:

Lumen explica que não tem as etapas de SSO, não vai adivinhar e abriu um ticket A limitação reconhecida. A base omite SSO empresarial de propósito para testar o ticket.

Inventar um procedimento plausível de SSO é pior que encaminhar. Teste esse comportamento, como veremos em testes, em vez de presumir que acontecerá.

Duas conexões do Discord e por que tickets precisam da segunda

O Quickchat AI oferece duas conexões diferentes.

ConexãoRespostas da documentação e Google Sheets ActionsDiscord API Actions para tickets privados
Bot compartilhado de um cliqueDisponívelRequer seu próprio aplicativo Discord
Seu próprio aplicativo DiscordDisponívelDisponível com as permissões necessárias do bot

Para uma fila pública de feedback que funciona com o bot compartilhado, veja o fluxo de feedback e lacunas na documentação. As Actions de tickets privados descritas abaixo precisam da credencial do seu próprio bot do Discord.

One-click é rápida. Em External Apps, abra Discord, clique em Add to your Discord server e autorize. O bot compartilhado entra em cerca de um minuto e responde a menções ou /ask. Para muitos servidores isso basta.

Você pode dar um nome. Bot name in the new server vem preenchido com o nome do agente. Cada servidor mantém Bot name in this server para alterações futuras. É um apelido por servidor, com até 32 caracteres; apagá-lo restaura Quickchat AI. Avatar e @username continuam compartilhados porque uma única aplicação atende todos os servidores.

Painel de conexão com Bot name in the new server acima do botão de instalação O bot leva o nome do agente ao servidor, alterável depois por servidor.

Advanced setup usa seu aplicativo Discord. Crie um bot no Developer Portal e cole o token uma vez. Em cerca de dez minutos você terá avatar e @username próprios, mensagens diretas, vários bots no servidor e as AI Actions necessárias aqui.

Uma AI Action chama a API como seu bot, com credencial inserida no envio. O token do bot compartilhado não pertence a você e não fica disponível nas suas Actions. Sem aplicativo próprio conectado, a galeria explica a limitação e desativa as opções para evitar uma configuração que não funcione.

External Apps do Quickchat AI com a integração Discord Os dois caminhos começam em External Apps. Advanced setup fica no final do painel Discord.

Preparação necessária

Conecte seu próprio aplicativo Discord. Em External Apps, abra Discord, encontre Use your own Discord app e escolha Advanced setup. Crie o aplicativo e o bot no Developer Portal do Discord, ative Message Content Intent, mantenha Require OAuth2 Code Grant desativado e cole o token do bot. A Quickchat AI o valida enquanto você preenche o campo. O guia criar um bot com IA para Discord explica as etapas do portal para quem ainda não fez essa configuração.

Conceda somente as permissões necessárias ao suporte. No canal de tickets, o bot precisa de View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads e Manage Threads. Não precisa de Kick, Ban ou Timeout, e essas permissões não foram concedidas no servidor de teste. Um bot de suporte não precisa moderar; deixar esses direitos ausentes reduz o que ele pode fazer por engano.

Crie no Discord os dois destinos usados pelas Actions. Esta etapa acontece no cliente Discord, não na Quickchat AI, e é a única configuração de destinos que você faz ali:

  1. Um canal onde os tickets serão abertos. Pode ser qualquer canal de texto. Use o + ao lado da lista de canais ou reutilize um existente. No servidor de teste, ele se chama #support.
  2. Um cargo para notificar quando houver um ticket. Abra Server Settings, depois Roles e Create Role. No servidor de teste, é @support.

Perguntas em canal público, tickets em threads privadas dentro de suporte e acesso para o membro, o bot e a equipe Três espaços com funções diferentes. Apenas o canal onde a pergunta começa é público.

Você selecionará esses destinos na etapa 3. Durante a instalação do modelo, a Quickchat AI consulta seu servidor no Discord e apresenta três menus. Um deles é Role, com os cargos encontrados. Você escolhe o cargo de suporte ali, sem digitar um ID.

Menu Role com os cargos mencionáveis encontrados no servidor O menu consulta o Discord, então o cargo que você acabou de criar aparece quando a lista é atualizada.

Há um detalhe necessário: o menu só lista cargos que o Discord informa como mencionáveis e exclui @everyone. Se o cargo de suporte não permitir menções, ele não aparece na lista. O filtro existe porque a finalidade da notificação é mencionar esse cargo. Ative a opção ao criá-lo:

Configurações do cargo de suporte com Allow anyone to @mention this role ativado Em Server Settings, Roles, escolha o cargo de suporte e ative a opção em Display. Sem ela, o cargo não chega ao menu da instalação.

Como decide entre responder e abrir ticket

Bots como Ticket Tool e TicketsBot normalmente publicam um painel fixado com o botão Create Ticket, ou registram um comando slash. O membro clica, um ticket é aberto e sua equipe o lê. É um fluxo previsível, mas dez pessoas perguntando como redefinir uma chave de API na mesma semana podem gerar dez tickets.

Um bot por botão encaminha todas as perguntas; o bot que responde primeiro resolve as cobertas pela documentação As perguntas são as mesmas. O que muda é o trabalho que chega à equipe.

Um bot que responde primeiro consulta a documentação antes de decidir. Quando precisa encaminhar, abrir o ticket exige quatro informações:

  • qual canal receberá a thread;
  • de qual servidor veio a pergunta;
  • quem está perguntando, para adicionar essa pessoa à thread;
  • o assunto do ticket e um resumo do problema em uma linha.

Esses valores chegam de três maneiras diferentes. Somente os textos do último item são escritos pela IA:

Valores escolhidos na instalação, metadados enviados pelo Discord e textos escritos pelo agente chegam à mesma requisição Você não digita IDs Discord, e o modelo não recebe o canal nem o cargo como opções que possa alterar.

Valores que você escolhe uma vez. O canal de tickets e o cargo de suporte são selecionados nos menus durante a instalação. A Quickchat AI os grava na Action. O modelo não vê esses destinos e não pode mudá-los.

Valores fornecidos pelo Discord. A integração informa, em cada mensagem, de qual servidor ela veio e quem está falando, por meio de {{metadata_discord_guild_id}} e {{metadata_discord_author_id}}. O token do bot é disponibilizado como System Token, inserido apenas no envio e ocultado em todos os registros da chamada. Nenhum desses valores é escrito pelo modelo. Uma mensagem enviada pelo chat público ou pela API não pode fornecê-los como se viesse do Discord.

Valores escritos pelo agente. O assunto e o resumo do problema. Essas são as decisões de redação necessárias para o ticket, o que deixa poucos campos para ajustar posteriormente.

Etapa 1: crie o agente e adicione conhecimento

Abra Knowledge Base no agente e adicione a URL dos documentos para extração ou escreva artigos. Criar um agente de suporte pela documentação detalha a extração.

Knowledge Base com cinco artigos Beacon Redefinição de API, painel vazio, instalação do rastreamento, planos e cobrança, exportação de dados.

SSO empresarial foi omitido de propósito. Toda base tem lacunas; o importante é testar o comportamento quando encontra uma. SSO é esse caso neste guia.

Os membros mencionam seu bot em um canal visível. Não há comando para registrar. /ask pertence ao bot compartilhado.

Etapa 2: explique quando responder e encaminhar

Use AI Main Prompt, em Identity, adaptando:

Você é Lumen, assistente de suporte da Beacon, ferramenta hospedada de análise de produto para equipes de software. Responde aos clientes no Discord da comunidade Beacon.
Responda pela Knowledge Base sempre que puder. Use duas ou três frases curtas e práticas com etapas concretas.
Se a pergunta não estiver na Knowledge Base, não adivinhe nem invente etapas. Diga claramente que não tem a informação e abra um ticket:
1. Chame open_support_ticket uma vez, com ticket_subject de 2 a 4 palavras descrevendo o problema.
2. Chame add_ticket_requester para adicionar o cliente à thread.
3. Chame post_in_ticket com issue_summary de uma linha sobre a pergunta.
Depois informe que o ticket está aberto e a equipe responderá na nova thread.
Nunca peça ID Discord do cliente, do canal ou da thread. Eles são preenchidos automaticamente.

Identity com AI Main Prompt de Lumen Campo sempre disponível, não uma lista separada de diretrizes.

“Não adivinhe nem invente etapas” transforma lacunas em respostas honestas. Nomear as três Actions em ordem cria a sequência. A ordem está no prompt, mas também é imposta por condições, explicadas adiante.

Etapa 3: instale as Actions com um clique

Abra Actions & MCPs, Add Action, Discord Action.

Add Action com Discord Action ao lado de HubSpot e Google Sheets A galeria aparece junto às outras integrações de um clique.

Support & Tickets contém este modelo; Moderation contém outros sete.

Galeria com Support and Tickets e sete modelos de moderação Oito opções. Apenas Open Support Ticket exige escolhas.

Selecione Open Support Ticket. Este é o único formulário:

Diálogo Open Support Ticket com servidor, canal e cargo Três listas e explicação do que será instalado.

As listas vêm do Discord e mostram opções válidas. Canais são somente de texto:

Lista de canais de texto do Beacon Community Threads serão criadas dentro do canal escolhido.

Cargos são mencionáveis, sem @everyone:

Lista de cargos mencionáveis Esse filtro oculta o cargo sem menções ativadas.

Escolha os três:

Diálogo preenchido com Install and enable pronto Servidor, canal e cargo completam a configuração.

Clique em Install and enable. Três Actions são criadas ativas em uma única transação.

Página Actions com três ações de tickets Discord Três cartões ativos, sem campos adicionais.

Os sete modelos de moderação não precisam de configuração, pois seus valores vêm da solicitação Discord. Um clique instala. Instalar duas vezes cria outra cópia editável, útil para variantes.

O que a instalação realmente criou

Mesmo sem preencher os campos manualmente, vale entender o que foi criado: é aqui que você fará qualquer ajuste futuro.

Uma instalação gera três HTTP Request Actions com método, URL, parâmetros, filtro, memória e condições São três HTTP Request Actions comuns. Não há uma marca especial que impeça sua edição.

As Actions se conectam por duas funções já disponíveis no editor:

Save to memory captura um valor da resposta e o armazena na conversa. open_support_ticket usa essa função para guardar o ID da nova thread. O Discord retorna o objeto da thread; $.id extrai o ID, salvo como discord_ticket_thread_id. As duas Actions seguintes leem esse valor na URL. Assim, atuam sobre a thread recém-criada, sem que você precise nomeá-la antecipadamente. Veja Save to memory na documentação.

Run only when condiciona uma Action ao estado da conversa. A Quickchat AI verifica a condição antes de enviar qualquer requisição. Veja Run only when na documentação.

Save to memory guarda o ID e as condições o leem para impedir ações seguintes antes da criação da thread As condições organizam três Actions independentes em uma sequência.

Leia o diagrama nos dois sentidos, pois ele faz duas verificações:

  • As Actions seguintes exigem que o ID da thread exista. Assim, o agente não pode notificar sua equipe sobre uma thread que nunca foi criada.
  • open_support_ticket exige que o ID não exista. Portanto, o agente não consegue abrir um segundo ticket na mesma conversa, independentemente do que for escrito no chat. Mesmo que o membro acrescente detalhes por mais dez mensagens, aquela conversa continua com um ticket. No modo de resposta no canal, cada troca no canal tem sua própria conversa; uma nova pergunta ainda pode abrir seu próprio ticket.

Cada Action também possui Response filter. Esse filtro é uma lista de campos permitidos: ele indica quais caminhos da resposta o agente pode ver. O restante é removido antes de chegar ao modelo. Veja Response filter na documentação.

Objeto de thread do Discord reduzido aos dois campos permitidos para o agente O Discord retorna vários campos do servidor. O agente recebe apenas os dois incluídos no filtro.

O ID necessário para a sequência é capturado pela Quickchat AI usando Save to memory. O agente não precisa transportá-lo no texto da conversa. Os demais dados da resposta ficam fora da visão do modelo. Se você reduzir a lista de campos, ele verá menos; nunca verá mais do que a lista permite.

Como uma pessoa assume a conversa

Sim. Criar uma thread não basta se ninguém da equipe a acompanha; o atendimento precisa continuar.

Human Handoff é uma Action integrada e separada das três Actions Discord. Ative-a e descreva em Handoff Rules quando o atendimento deve chegar a uma pessoa. Por exemplo: “quando o cliente pedir atendimento humano ou quando o agente não conseguir responder pela base de conhecimento”. A Quickchat AI sinaliza a conversa na Inbox e inclui um resumo escrito pela IA. Quem assume pode ler um parágrafo antes de examinar o histórico completo. O tutorial de Human Handoff detalha cada configuração.

Pergunta no Discord, encaminhamento à Inbox e resposta humana enviada de volta ao canal O operador trabalha na Inbox. O membro continua no Discord.

Atribua a conversa a você e responda no editor da Inbox. A mensagem é entregue diretamente ao canal Discord em que o membro já estava conversando. Ele não precisa criar uma conta no seu sistema, abrir uma conversa por e-mail ou entrar em um portal. A IA para de responder quando uma pessoa assume a conversa, evitando respostas concorrentes do bot.

Em #ask-beacon, o agente reconhece que faltam as instruções de SSO e abre um ticket; depois chega a resposta humana O mesmo canal, com três dias de intervalo. O agente reconheceu a limitação e encaminhou. A mensagem abaixo do separador foi escrita por uma pessoa na Inbox da Quickchat AI. Ela aparece com o nome do bot porque essa é a identidade usada para publicar no Discord.

Conversa encaminhada na Inbox com pergunta, recusa, chamadas de Actions e resposta humana A mesma conversa vista pela equipe: a resposta do agente, as duas chamadas de Actions mostradas nesse trecho, a resposta do operador e os detalhes que identificam Discord e o assunto single sign-on.

Enquanto isso, a thread privada do ticket continua sendo o espaço de trabalho da equipe. O membro foi adicionado e o cargo de suporte foi notificado. A resposta escrita na Inbox volta ao local onde a pergunta foi feita.

Ciclo de um ticket desde a pergunta sem resposta, passando pelas três gravações Discord, até a resposta pela Inbox Seis etapas. Três delas gravam informações no Discord, e só são necessárias porque faltou uma resposta na documentação.

Teste os dois caminhos

Teste os dois caminhos antes de depender deste bot. Dê atenção especial à situação em que ele precisa reconhecer que não sabe responder.

Pergunta coberta. Mencione o bot em um canal que ele consiga ver e faça uma pergunta respondida pela Knowledge Base. Ele deve fornecer os passos reais no próprio canal, sem criar uma thread de ticket. Esse é o caminho que economiza tempo da equipe e que a documentação pode ampliar.

Pergunta não coberta. Pergunte algo que a documentação não explica. O agente deve reconhecer a lacuna e encaminhar. Nesse momento, o ticket aparece:

Thread privada ticket-Okta SAML SSO, com Lumen mencionando o cliente e o cargo de suporte junto ao resumo O agente deu à thread um nome baseado no problema, adicionou o membro, notificou o cargo e escreveu o resumo.

Confira também a lista de membros e a indicação de privacidade da thread:

Thread marcada PRIVATE com a lista mostrando somente o cliente e Lumen O ticket usa uma thread privada; a conversa de suporte não fica aberta a todos no canal.

Teste uma conversa inteira, não só uma mensagem. A proteção contra duplicação é relevante no segundo turno, quando o membro acrescenta detalhes e um fluxo sem essa condição poderia abrir outro ticket.

As condições não deduplicam toda tentativa. Elas bloqueiam chamadas fora de ordem, mas executar manualmente a Action de notificação outra vez publica uma segunda mensagem. Leve isso em conta antes de repetir Actions em um ticket real.

Para avaliar várias formulações sem digitá-las todas no Discord, use Simulations em Testing. Crie um dataset de mensagens de clientes, execute-o no agente real e revise as respostas e notas. Misture perguntas cobertas e não cobertas no mesmo dataset, porque os dois caminhos podem falhar de maneiras diferentes.

Simulations concluído com seis perguntas de suporte Discord, mostrando resposta, nota e justificativa Quatro perguntas cobertas e duas sem resposta na base. As linhas 5 e 6 reconhecem a limitação e recebem notas tão boas quanto as respostas completas.

Escreva os critérios de avaliação para um avaliador que só vê a transcrição. Ele não vê o efeito no Discord: sem uma explicação, pode interpretar “abri um ticket para você” como uma capacidade inventada. Também não vê a Knowledge Base e pode considerar um número correto como uma invenção, por não conseguir conferi-lo. Explique essas duas limitações nos critérios. A nota da simulação não substitui verificar o ticket e os logs no Discord.

Como evitar tickets demais

Normalmente o ajuste principal não é o prompt.

O volume depende da base. Cada lacuna vira ticket. Leia-os como lista de perguntas ausentes nos documentos. Cobrir as lacunas reduz diretamente os encaminhamentos.

Insights mostra o que documentar. Conversas são agrupadas por assunto. Complete os três mais frequentes e observe a taxa de encaminhamento.

AI-Detected Topics em Insights Advanced com preços, chaves API, exportação e SSO Assuntos identificados sem configuração manual; contagens priorizam a documentação.

Preços e API foram mais frequentes, então escreva esses artigos primeiro e compare na semana seguinte. Você também define tópicos em Manage Topics. Consulte AI-Detected Topics, Conversation Topics e gerenciamento de tópicos.

Encaminha cedo demais: ajuste a descrição para agir somente após informar que não tem a resposta. Encaminha pouco e começa a adivinhar: reforce “não adivinhe nem invente etapas” no prompt principal.

Segurança em um servidor público

Um bot com o qual qualquer pessoa de um canal público pode falar precisa de controles claros. Neste fluxo, eles estão nas configurações que você pode consultar no editor e não dependem apenas da formulação do prompt.

O modelo solicita, a Quickchat AI verifica condições e filtra a resposta, e o Discord aplica as permissões do bot O membro consegue falar com o modelo, mas a solicitação ainda precisa passar pelas verificações da Quickchat AI e do Discord.

Cada Action de ticket exige uma mensagem real do Discord, vinda do seu servidor. Duas das três condições em cada Action verificam se a mensagem chegou pela integração Discord e se veio do servidor escolhido na instalação. A integração fornece esses valores; o texto da mensagem não os define. Uma mensagem de chat público ou API não pode fornecê-los nem herdar uma cópia antiga armazenada. Se você tentar chamar essas Actions pela API pública do agente, elas recusam a execução.

A Action que adiciona alguém à thread privada não tem parâmetros editáveis pelo modelo. A URL termina com o ID do autor que a integração forneceu para a mensagem atual. O agente não consegue substituir esse ID por outro, portanto não pode convidar um membro arbitrário para o ticket de outra pessoa.

As menções são limitadas na instalação. A Action de notificação envia uma lista explícita contendo o membro que perguntou e o cargo escolhido, com a interpretação automática de menções desativada. Uma menção que o agente escrever no resumo não é ativada, e @everyone não notifica o servidor inteiro. Confira isso no teste: a menção ao membro e ao cargo funciona, mas um @everyone literal na mesma mensagem não dispara uma notificação geral.

As threads são privadas e não permitem convites pelos membros. São criadas com type: 12 e invitable: false. Assim, uma pessoa adicionada ao ticket não pode trazer outra por conta própria.

O bot não pode moderar. A configuração deste guia não concede Kick, Ban ou Timeout. Se alguém convencer o agente a abrir um ticket desnecessário, ele continua limitado a uma thread que essa pessoa poderia solicitar pelo fluxo normal, sem ganhar poderes de moderação.

O token não é exposto. Ele fica em um System Token, é inserido apenas no envio e é ocultado em todos os registros da chamada.

Decida também quem deve ter acesso ao cargo de suporte. As threads são privadas, mas as pessoas desse cargo podem lê-las. Isso é necessário para o atendimento e deve ser considerado quando membros puderem enviar dados sensíveis. Oriente o uso do canal de e-mail apropriado para informações que exijam tratamento confidencial.

Quanto custa um bot de suporte com IA para Discord

O Free inclui AI Actions, Human Handoff, base, Topics e Insights com 50 créditos de IA por mês para uso pessoal e não comercial. Uso empresarial exige plano pago, que também oferece mais créditos. Bots gratuitos com IA para Discord compara hospedagem própria e tempo necessário.

Depois de passar pelos dois testes:

  1. Explique como acessar o bot. Informe no tópico do canal que podem mencioná-lo. Um bot desconhecido não evita tickets.
  2. Observe o primeiro dia. Logs guardam requisição e resposta; Inbox guarda conversas. Veja o que respondeu e encaminhou.
  3. Transforme tickets em tarefas de documentação. Eles indicam perguntas ainda sem cobertura.

O mesmo agente atende outros canais. Base, prompt e Human Handoff são do agente. Ele funciona no widget web, Slack, WhatsApp e e-mail, com a mesma Inbox. Somente as três Actions são específicas. Se sua equipe trabalha no Slack, envie a notificação lá.

Outras funções do agente Discord

Moderation inclui timeout, kick, ban, unban, cargos, slowmode e anúncios. Os modelos vêm com author_is_admin is true, verificado a partir do Discord. Somente administradores passam. É outra configuração, no guia de moderação.

Outros endpoints seguem a receita: HTTP Request Action, Authorization: Bot {{discord_bot_token}}, parâmetros e descrição. Criar um agente que executa ações introduz e conectar a qualquer API generaliza.

O mesmo agente pode interpretar personagem. Bot de roleplay do Discord usa conhecimento e memória para persona; a construção completa aborda prompt, cânone e consistência.

Apêndice: requisições exatas

Você não precisa digitá-las, mas mostram o que montaria manualmente em outra plataforma. {{...}} é preenchido no envio.

1. Abrir thread privada

POST https://discord.com/api/v10/channels/YOUR_TICKET_CHANNEL_ID/threads
Authorization: Bot {{discord_bot_token}}
Content-Type: application/json

{ "name": "ticket-{{ticket_subject}}", "type": 12, "auto_archive_duration": 1440, "invitable": false }

type: 12 torna privada. auto_archive_duration usa minutos: 1440 arquiva após um dia inativo. Save to memory salva $.id como discord_ticket_thread_id.

2. Adicionar quem perguntou

PUT https://discord.com/api/v10/channels/{{metadata_discord_ticket_thread_id}}/thread-members/{{metadata_discord_author_id}}
Authorization: Bot {{discord_bot_token}}

Sem corpo nem parâmetros. IDs vêm da memória e integração.

3. Avisar a equipe

POST https://discord.com/api/v10/channels/{{metadata_discord_ticket_thread_id}}/messages
Authorization: Bot {{discord_bot_token}}
Content-Type: application/json

{
  "content": "<@{{metadata_discord_author_id}}> seu ticket está aberto. <@&YOUR_SUPPORT_ROLE_ID> novo ticket: {{issue_summary}}",
  "allowed_mentions": { "parse": [], "users": ["{{metadata_discord_author_id}}"], "roles": ["YOUR_SUPPORT_ROLE_ID"] }
}

Use Bot, não Bearer. Em allowed_mentions, combine parse vazio com listas explícitas de users e roles, bloqueando @everyone e permitindo as menções escolhidas. parse não vazio junto de lista explícita do mesmo tipo é rejeitado com 400 MESSAGE_ALLOWED_MENTIONS_PARSE_EXCLUSIVE.

Guias relacionados

Perguntas frequentes

Como configuro um bot de tickets no Discord?

Conecte seu aplicativo em External Apps, adicione a base e abra Actions and MCPs, Add Action, Discord Action, Open Support Ticket. Escolha servidor, canal e cargo e clique Install and enable. Não precisa de hospedagem; no Discord, crie canal e cargo.

Como crio um bot de tickets?

Crie um agente Quickchat AI, conecte seu aplicativo e instale Open Support Ticket da galeria. As três escolhas e Install and enable criam três Actions completas. Adicione conhecimento primeiro porque sua cobertura determina o volume.

A IA responde dúvidas de suporte no Discord?

Sim. Busca na base e responde no canal. Perguntas documentadas recebem resposta e lacunas viram tickets. Essa cobertura é o principal fator.

Preciso programar?

Não. Escolha modelo, servidor, canal e cargo. Quickchat AI configura método, URL, headers, corpo, parâmetros, resposta e condições. Sem IDs digitados ou JSON editado.

Quantas Actions são instaladas?

Três: abrir thread e guardar ID, adicionar membro e publicar resumo mencionando suporte. Chegam habilitadas e conectadas.

Como sabe quando abrir um ticket?

A descrição permite quando a resposta não está na base. Condições garantem a sequência: thread ausente para criar, presente para ações posteriores.

Pode abrir tickets duplicados?

Não na mesma conversa. Open Support Ticket exige que o ID não esteja em memória. Depois da criação, outra abertura é bloqueada, independentemente do prompt.

Uma pessoa pode assumir?

Sim. Human Handoff sinaliza na Inbox com resumo. Atribua e responda; a mensagem chega ao canal Discord. Sem conta adicional ou saída do Discord.

Por que preciso de aplicativo Discord próprio?

AI Actions chamam a API como seu bot e precisam de seu token. O bot compartilhado conversa, mas não libera seu token para Actions. Use Advanced setup em External Apps, Discord, em cerca de dez minutos.

Quais permissões precisa?

View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads e Manage Threads no canal. Não precisa de Kick, Ban ou Timeout.

Por que o cargo de suporte não aparece?

Somente cargos mencionáveis entram na lista, sem @everyone. Ative a opção em Server Settings, Roles; do contrário a notificação não poderia mencionar o cargo.

É seguro usar em servidor público?

Os controles estão na configuração, não só no prompt. Cada Action exige mensagem real do servidor escolhido. Adicionar o membro não tem parâmetros que o modelo altere. Menções limitadas, threads privadas sem convite e condições antes do envio restringem efeitos.

Quanto custa o suporte com IA no Discord?

Free inclui 50 créditos de IA mensais para uso pessoal e não comercial, com AI Actions, Human Handoff, base, Topics e Insights. Uso empresarial exige plano pago, que também oferece mais créditos.

Qual a diferença para Ticket Tool ou TicketsBot?

Eles abrem ticket após Create Ticket, mesmo quando a documentação já responde. Este bot responde primeiro e só encaminha o que não resolve, reservando a equipe para perguntas que precisam de pessoa.

ChatGPT, Claude ou Gemini podem executar o bot?

Sim, pelo Quickchat AI. O agente usa modelos atuais e AI Actions para responder pela base e abrir threads reais. Você escolhe as Actions disponíveis e permitidas.

O mesmo agente atende outros canais?

Sim. Base, prompt e Human Handoff são do agente. Widget, Slack, WhatsApp e e-mail compartilham recursos. Só as três Actions são específicas de Discord.

Como membros iniciam a conversa?

Mencionam seu bot em canal visível. Ele responde ali e só abre thread quando falta resposta. /ask pertence ao bot compartilhado de um clique.

Como reduzo tickets demais?

Melhore a cobertura da base primeiro. Tickets mostram lacunas e Insights prioriza temas. Só depois ajuste a descrição da Action.

Posso editar as Actions da galeria?

Todos os campos. São HTTP Request Actions normais, sem bloqueio ou política separada. Altere URL, corpo, descrição ou condições, ou instale outra cópia.

Posso ter tickets sem helpdesk?

Sim. Ticket é thread privada e Inbox é fila de atendimento. Sem Zendesk, Intercom ou Jira ou migração. Se já usa helpdesk, outra Action cria tickets nele, como a galeria HubSpot.

Pode responder pelo centro de ajuda?

Sim. Adicione URL para extração, arquivos ou artigos. O agente busca a cada pergunta, sem reescrever documentos. Criar agente pela documentação explica.

Pode saudar ao criar canal de ticket?

Sim, por outro recurso. Ticket Tool cria e New channel publica saudação fixa após alguns segundos. Sem modelo ou créditos. Boas-vindas para membros, threads e tickets configura.

Como meço perguntas resolvidas sem ticket?

Conte conversas sem thread sobre todas as conversas. Chamadas open_support_ticket mostram escalonamentos e Insights agrupa o resto por tema. Meça por tema para identificar lacunas. Analítica de chatbots aborda outras métricas.

Resumo

Base de conhecimento e instalação de galeria criam atendimento de primeira linha: responde o que está documentado, reconhece limites, abre thread privada para o restante, adiciona membro, avisa suporte com resumo e transfere para uma pessoa na Inbox. O membro não sai do Discord. Três Actions e condições mantêm a sequência, sem IDs manuais. Você continua responsável por fornecer documentação adequada.

Quickchat AI Quickchat AI Ask Quickchat AI a question