Como configurar um bot de tickets Discord

Configure o TicketCord em um aplicativo Discord seu: crie o bot, conecte-o, escolha as funções da equipe, publique um painel de tickets e depois abra, reivindique e feche um ticket de teste.

12 minutos de leituraAtualizado a 30 de setembro de 2026

Este guia leva você do Discord Developer Portal vazio até um ticket de teste fechado com transcrição. Ele segue os mesmos passos do assistente de configuração que aparece depois de entrar no TicketCord e não exige código nem servidor próprio.

Seu próprio bot, não um bot compartilhado

Muitos bots de tickets do Discord são um único bot compartilhado: você o adiciona com o link de convite do fornecedor, e ele mostra o nome e o avatar do fornecedor em todos os servidores que o usam. O TicketCord funciona de outro jeito. Você cria um aplicativo Discord na sua própria conta do Developer Portal, conecta o token dele, e o TicketCord executa o bot para você. Os membros veem o nome e o avatar do seu bot, e o aplicativo continua na sua conta Discord.

Por isso o TicketCord não tem link de convite público e este guia começa no Developer Portal. Isso acrescenta alguns minutos à configuração. No plano Free, as mensagens do bot também levam o rodapé Powered by TicketCord.com; os planos pagos o removem.

O que você precisa

Uma conta Discord com permissão de Administrador, ou como dono, no servidor de destino (o próprio Discord também exige Gerenciar Servidor para adicionar qualquer bot)
Uma conta TicketCord. Contas novas começam com um teste de 14 dias do plano Enterprise, sem necessidade de cartão.
Um navegador da web conectado ao Discord

Assista ao passo a passo

A mesma configuração em vídeo, do Developer Portal até um ticket de teste fechado e sua transcrição.

Gravado em 7 de junho de 2026 · 9:24 · Assistir no YouTube

O player só é carregado do YouTube depois que você clica em reproduzir.

O que mudou desde a gravação

Conectar o bot agora exige apenas o token. O client secret colado no vídeo não é mais solicitado.
A última tela de configuração agora pode publicar o painel de tickets para você. O comando /embed mostrado no vídeo continua funcionando.
As configurações do servidor estão agrupadas de outra forma. As opções de fechamento automático, encerramento e reivindicação ficam em Ciclo de vida dos tickets, e não mais em Automação (Automation).
Contas novas agora começam com um teste de 14 dias do plano Enterprise, sem cartão, em vez do teste e do código de desconto mencionados no final.
O site mudou de ticketcord.net para ticketcord.com.

Capítulos

Passo a passo

1. Crie um aplicativo Discord

Acesse o Developer Portal do Discord, entre com a conta que deve ser dona do bot e clique em New Application. O nome e o avatar que você definir se tornam a identidade do bot que seus membros veem, e você pode alterá-los depois, já que o TicketCord sempre os lê em tempo real do Discord. Desative Public Bot para que estranhos não possam adicionar seu bot aos próprios servidores.

2. Adicione um usuário bot e copie o token

Abra a aba Bot, redefina o token e copie-o imediatamente: o Discord o mostra apenas uma vez. Trate-o como uma senha. Cole-o somente no painel do TicketCord, nunca o compartilhe em outro lugar, e redefina-o novamente se perdê-lo ou suspeitar que vazou.

3. Habilite as intenções necessárias

Ainda na aba Bot, ative Server Members Intent e Message Content Intent em Privileged Gateway Intents. O TicketCord precisa das duas para verificar funções da equipe e ler mensagens de tickets para transcrições, ModMail e recursos de IA. Presence Intent não é necessário. O Discord retorna o erro de gateway 4014 até que as intenções privilegiadas exigidas sejam ativadas; o TicketCord faz uma tentativa automática de ativá-las, e se o bot ainda assim não conectar, ative-as manualmente e reinicie-o pelo painel.

4. Conecte o bot ao TicketCord

Entre no TicketCord com o Discord. Uma conta nova abre o assistente de configuração; em uma conta existente, escolha Adicionar um bot. Cole o token, escolha Verificar token / Continuar, confira o nome e o avatar do bot que o TicketCord leu do Discord e escolha Conectar bot / Adicionar este bot. O TicketCord criptografa o token antes de gravá-lo no armazenamento.

5. Convide o bot pelo TicketCord

Escolha Adicionar bot no assistente de configuração, ou Convidar na página do bot, selecione um servidor que você possui ou administra e autorize o bot no Discord. O TicketCord detecta a entrada sozinho. Não convide o bot com um link criado no Discord Developer Portal: um convite manual geralmente fica sem permissões ou sem o escopo de comandos de barra. Se isso já aconteceu, expulse o bot e convide-o novamente pelo TicketCord; o token continua válido.

6. Corrija a posição da função do bot

O Discord coloca a função de um bot recém-convidado no final da lista de funções. Abra Configurações do Servidor, depois Funções, e arraste a função do bot para cima das funções da sua equipe, para que ele possa gerenciar as permissões por ticket para elas. Uma função de bot posicionada abaixo das funções que ela precisa gerenciar é uma das causas mais comuns de um canal de ticket abrir com as permissões erradas.

7. Escolha funções da equipe, categorias e canais

Na etapa de configuração, escolha as funções da equipe que veem os novos tickets, a categoria em que os tickets são abertos, opcionalmente uma categoria para tickets fechados e os canais de transcrições e de logs, depois escolha Salvar e continuar. O TicketCord pode sugerir uma configuração inicial; revise-a antes. Se precisar de funções ou canais, pressione Criar para mim para criar os que faltam no seu servidor e selecioná-los no formulário. Se uma função ou um canal que você acabou de criar não aparecer, escolha Atualizar. Você também pode executar /setup no Discord para criar um conjunto padrão de categorias, canais e funções, depois selecioná-los em Equipe, Abertura de tickets, Fechamento de tickets e Geral nas configurações do servidor e salvar. Só o /setup não salva nada no TicketCord.

8. Publique o painel de tickets

Na última tela de configuração, escolha o Canal do painel em que os membros devem abrir tickets e escolha Publicar painel de tickets. Mais tarde, você pode publicar painéis em Painéis e mensagens nas configurações do servidor, ou com o comando /embed no Discord. Escolha /embed no menu de comandos do Discord: colar o comando como texto não o executa.

9. Abra e reivindique um ticket de teste

Clique no botão do painel como um membro faria. O bot abre um ticket privado que só o membro, suas funções da equipe e o bot conseguem ver, e publica uma mensagem com os botões Reivindicar e Fechar. Escolha Reivindicar, ou execute /claim, para assumir o ticket. A equipe também pode responder pelo painel do TicketCord, e a resposta é publicada no ticket pelo seu bot.

10. Feche o ticket e confira a transcrição

Escolha Fechar e confirme, ou execute /close. O canal de logs registra o fechamento. Execute /transcript em um ticket para salvar uma transcrição em HTML no seu canal de transcrições. Para arquivar todos os tickets automaticamente, ative “Publicar a transcrição quando um ticket fecha” em “Fechamento de tickets” nas configurações do servidor. Se “Excluir o canal ao fechar” também estiver ativado, a transcrição é publicada antes de o canal ser excluído. Para enviar uma mensagem ao membro quando o ticket dele for fechado, ative Ativar DM ao Fechar no mesmo lugar.

Problemas comuns e soluções

Erro de gateway 4014 ao conectar o bot

Uma das duas intenções privilegiadas ainda está desativada. Ative Server Members Intent e Message Content Intent na aba Bot do Developer Portal, depois reconecte o bot pelo painel.

O Discord não deixa desativar Public Bot

O Discord bloqueia aplicativos privados que ainda têm um link de instalação padrão. Defina Installation, Install Link como None, salve e depois desative Public Bot.

O bot é validado, mas o convite falha com "Integration requires code grant"

Requires OAuth2 Code Grant está ativado para o aplicativo. Abra a aba Bot no Developer Portal, desative-o, salve e convide o bot novamente pelo painel.

A configuração continua esperando o bot entrar

Convide o bot com o botão Adicionar bot ou Convidar no TicketCord, em um servidor que você possui ou administra, e permita pop-ups para que a janela de autorização do Discord possa abrir.

Uma função ou um canal não aparece nas listas de configuração

Escolha Atualizar depois de criá-lo no Discord. Se ainda não aparecer, verifique se a função do bot consegue ver esse canal ou categoria.

/setup ou /embed não aparece no menu de comandos do Discord

Recarregue o Discord depois de convidar o bot (Ctrl+R, ou Cmd+R no Mac). O Discord mostra /setup apenas para membros com Administrador, ou com Gerenciar Canais e Gerenciar Cargos juntos, e /embed apenas para membros com Gerenciar Mensagens.

Os comandos de barra não aparecem no servidor

Faltava ao convite o escopo applications.commands, geralmente por ter sido construído manualmente em vez de usar o do painel. Expulse o bot, convide-o novamente pelo painel e recarregue o Discord.

O botão do painel não faz nada

Falta ao bot Ver Canal, Gerenciar Canais, Gerenciar Permissões, Enviar Mensagens ou Inserir Links na categoria de ticket. Corrija as substituições de permissão da categoria para a função do bot, depois execute /diagnose.

A equipe não vê os tickets que deveria ver

A função dela não está selecionada em Equipe no painel, ou a função do bot está abaixo da dela em Configurações do Servidor, depois Funções. Selecione a função no painel e arraste a função do bot para cima dela no Discord.

"Este servidor ainda não foi configurado"

Os itens essenciais do painel, funções de equipe, categorias de tickets e a categoria de tickets fechados nunca foram salvos. Salve-os em Estrutura e Equipe no painel, depois tente novamente.

Todos os códigos de erro do TicketCord e como resolvê-los

Seu fluxo de trabalho de tickets está pronto

Os membros podem abrir tickets no painel, e a equipe pode responder no Discord ou na caixa de entrada do painel. O bot continua funcionando depois que você fecha esta aba: não há nada para implantar ou hospedar por conta própria. Nos planos Pro e Enterprise, também é possível usar os rascunhos de resposta do Atlas e os recursos da base de conhecimento quando esses controles estão ativados.