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.
| Tarefa | Guia | Conexão do Discord |
|---|---|---|
| Responder pela documentação e abrir um ticket privado quando faltar informação | Este guia de suporte e tickets | Seu próprio aplicativo Discord |
| Publicar saudação fixa na entrada de um membro ou criação de canal | Bot de boas-vindas | Um clique ou aplicativo próprio |
| Aplicar timeout, gerenciar cargos ou alterar slowmode quando o administrador pedir | Bot de moderação com IA | Seu 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
- 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.
- 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.
- 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.
- 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
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:
| Etapa | O que acontece | Chamada do Discord |
|---|---|---|
| Pergunta coberta | Resposta no canal pela base de conhecimento | nenhuma |
| Pergunta não coberta | O agente reconhece que não tem a informação | nenhuma |
| … abre um ticket | Thread privada no canal de tickets | POST thread do canal |
| … adiciona o membro | A pessoa que perguntou entra na thread | PUT membros da thread |
| … avisa a equipe | Resumo com menção ao cargo de suporte | POST mensagem da thread |
| Atendimento humano | Conversa sinalizada na Inbox e resposta de volta ao Discord | Human 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.
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.
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:
Resposta pelo artigo no canal. Nenhum ticket foi necessário.
Quando a resposta não existe, o bot informa:
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ão | Respostas da documentação e Google Sheets Actions | Discord API Actions para tickets privados |
|---|---|---|
| Bot compartilhado de um clique | Disponível | Requer seu próprio aplicativo Discord |
| Seu próprio aplicativo Discord | Disponível | Disponí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.
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.
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:
- 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. - Um cargo para notificar quando houver um ticket. Abra Server Settings, depois Roles e Create Role. No servidor de teste, é
@support.
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.
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:
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.
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:
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.
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.
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.
A galeria aparece junto às outras integrações de um clique.
Support & Tickets contém este modelo; Moderation contém outros sete.
Oito opções. Apenas Open Support Ticket exige escolhas.
Selecione Open Support Ticket. Este é o único formulário:
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:
Threads serão criadas dentro do canal escolhido.
Cargos são mencionáveis, sem @everyone:
Esse filtro oculta o cargo sem menções ativadas.
Escolha os três:
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.
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.
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.
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_ticketexige 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.
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.
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.
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.
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.
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:
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:
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.
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.
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 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:
- Explique como acessar o bot. Informe no tópico do canal que podem mencioná-lo. Um bot desconhecido não evita tickets.
- Observe o primeiro dia. Logs guardam requisição e resposta; Inbox guarda conversas. Veja o que respondeu e encaminhou.
- 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
- Criar bot com IA para Discord, preparação
- Bot de moderação, mesma galeria
- Melhores bots com IA, comparação
- Bots gratuitos, custo da hospedagem própria
- Bot de roleplay, agente como personagem
- Conectar ao HubSpot, galeria CRM
- Ações confiáveis, condições e memória
- Conectar a qualquer API, receita geral
- Criar base de conhecimento, cobertura
- Human Handoff, configurações
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.