Pular para o conteúdo
Guia de instalação

Instale o Pro Ticket no seu servidor

O template do Railway sobe o bot, o painel web e o banco de dados juntos. Você cria a aplicação no Discord, preenche três variáveis e, em poucos minutos, publica o painel de tickets.

Abrir o template no Railway (abre em nova aba)

Antes de começar

  • Uma conta no Railway
  • Um servidor do Discord em que você é Administrador
  • Opcional: uma chave da API da Steam, só para mostrar a foto do perfil durante a verificação Steam — a verificação funciona sem ela
Parte 1

Crie o bot no Discord

Tudo acontece no Discord Developer Portal. Os nomes dos botões aparecem em inglês porque é assim que o portal é.

  1. Abra o Discord Developer Portal (abre em nova aba), clique em New Application, dê um nome e crie.
  2. Na aba Bot, desligue Public Bot e ligue Server Members Intent e Message Content Intent. A Presence Intent não é necessária.
  3. Ainda em Bot, clique em Reset Token e copie o token. Ele é o BOT_TOKEN.
  4. Na aba OAuth2, clique em Reset Secret e copie o Client Secret. Ele é o DISCORD_CLIENT_SECRET.
  5. Ainda em OAuth2, no gerador de URL, marque os escopos bot e applications.commands e a permissão Administrator. Abra o link gerado e autorize o bot no seu servidor.
  6. No Discord, ligue o Modo desenvolvedor (Configurações de usuário → Avançado), clique com o botão direito no ícone do servidor e escolha Copiar ID do servidor. Ele é o GUILD_ID.
O token aparece uma vez só e dá controle total do bot. Guarde num lugar seguro e não compartilhe com ninguém.
Parte 2

Faça o deploy no Railway

Abra o template: ele já inclui o MongoDB. Preencha as variáveis abaixo e clique em Deploy.

  • BOT_TOKENObrigatória

    O token do bot, copiado no passo 3.

  • DISCORD_CLIENT_SECRETObrigatória

    O Client Secret, copiado no passo 4. É o que liga o login no painel web.

  • GUILD_IDObrigatória

    O ID do seu servidor, copiado no passo 6.

  • STEAM_API_KEYOpcional

    Só para mostrar a foto do perfil Steam durante a verificação. Sem ela, a verificação funciona normalmente. Gere a chave na Steam (abre em nova aba).

O resto o template configura sozinho: MONGO_URI, BASE_URL, PORT e AI_MASTER_KEY. O deploy leva de 2 a 5 minutos.

O AI_MASTER_KEY criptografa as chaves de API da IA no seu banco. Nunca o troque depois de cadastrar uma chave no painel: a leitura falha e todas as chaves precisam ser cadastradas de novo.
Abrir o template no Railway (abre em nova aba)
Parte 3

Depois do deploy

  1. Confira se o bot aparece online no seu servidor.
  2. No Railway, abra o serviço do bot em Settings → Networking e copie o domínio público. No Developer Portal, em OAuth2 → Redirects, adicione este endereço com o seu domínio:
    https://SEU_DOMINIO/api/auth/discord/callback
  3. Abra o domínio no navegador, entre com o Discord e faça a configuração inicial em Configurações → Visão Geral — ou use /start no Discord. É onde você define fuso horário, idioma, categoria dos tickets, canais de transcrição e de anexos e o cargo da staff.
  4. Publique o painel de abertura de tickets com /ticket setup-panel, ou pelo painel web.
  5. Ligue o Auto Deploy: no Railway, abra o serviço do bot em Settings → Source e clique em Enable se ele estiver desligado. É o que mantém o bot atualizado — sem ele, o projeto fica na versão do dia do deploy.
Parte 4

Opcionais

Verificação Steam

Configure a verificação no painel web, em Configurações → Verificação, e publique os botões no Discord com /config-steam-buttons. Ela usa a rede pública do serviço na porta 8080, que o template já deixa pronta. Não precisa da chave da API da Steam: a STEAM_API_KEY só acrescenta a foto do perfil durante a verificação.

Assistente IA

No painel web, abra Assistente IA, escolha um provedor compatível e o modelo, cadastre a sua chave de API e ligue o sistema. O painel sugere modelos gratuitos e pagos, e o uso deles é tratado direto com o provedor. O módulo tem teste grátis e, depois dele, uma assinatura de valor simbólico — veja em Preços.

E depois?

Na primeira vez que o bot liga, ele se registra aqui sozinho. Entre com o Discord para ver a situação do seu servidor, acompanhar o teste do módulo de IA e assiná-lo quando quiser.

Entrar com Discord

Travou em algum passo?

Chame no Discord de suporte — é lá que as dúvidas de instalação são respondidas.

Não quer hospedar você mesmo? Fale com a gente no Discord (abre em nova aba).