> ## Documentation Index > Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt > Use this file to discover all available pages before exploring further. # Configurando um sistema de tickets > Monte um painel de suporte passo a passo: publique, adicione categorias com os próprios cargos de staff e nomes, e teste, ou deixe o !ticket setup fazer com menus. Um passo a passo completo do módulo de [Tickets](https://wiki.petto.sbs/pt-br/community/tickets.md), montando um sistema de suporte com duas categorias. > [!TIP] > > Com pressa? `!ticket setup` faz tudo isso com menus e botões em um só painel: o canal, os cargos de suporte, o canal de logs, o texto e os tipos de ticket. Os passos abaixo mostram o que cada parte faz manualmente. **1. Crie uma categoria de canais e um canal para o painel** Crie uma categoria de canais do Discord (ex.: "Tickets") onde os canais dos tickets serão criados, e um canal de texto (ex.: `#support`) onde a mensagem do painel vai ficar. **2. Publique o painel** ```javascript theme={null} !ticket panel create #support "Precisa de ajuda?" "Escolha uma categoria abaixo" --style button ``` Isso devolve um `panel_id`, que você vai precisar para cada categoria que adicionar. ![liam digita !ticket panel create #suporte com um título, um texto e o estilo de botões; o Petto publica o card Precisa de ajuda? e responde que o painel 1 foi publicado e como adicionar categorias](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-step-2.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=389f06420503ea7d2ca4bb92370a2742) No Discord: o painel publicado em #suporte, sem botões até ter categorias. **3. Adicione sua primeira categoria** ```javascript theme={null} !ticket category add 1 support "Suporte geral" "Tickets" @Staff 🎫 ``` `key` (`support` aqui) é como você vai se referir a esta categoria em todos os outros comandos; `parent` é a categoria de canais onde os novos canais de ticket são criados. ![O painel agora tem um botão Suporte geral; liam digitou !ticket category add 1 support com a categoria de canais Tickets e @Staff, e o Petto responde que a categoria support foi adicionada ao painel 1](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-step-3.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=2ad5a1d01f77fdcf5a7401edff42f108) No Discord: a primeira categoria: o painel ganha o botão. **4. Adicione uma segunda categoria** ```javascript theme={null} !ticket category add 1 billing Financeiro "Tickets" @Finance 💳 ``` Um painel com `style` `button` aceita até 5 categorias; mude o `style` para `select` ao criar o painel se precisar de mais (até 25, como um menu suspenso em vez de botões). ![O painel agora tem os botões Suporte geral e Financeiro; liam digitou !ticket category add 1 billing com @Finance, e o Petto responde que a categoria billing foi adicionada ao painel 1](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-step-4.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=fd5afe07a35d438af5d8baf79a4def74) No Discord: a segunda categoria, ao lado da primeira. **5. Adicione mais cargos, se um não for suficiente** ```javascript theme={null} !ticket support-role add support @Trainee !ticket ping-role add support @on-call ``` `support-role` controla quem pode ver/gerenciar os tickets da categoria, `ping-role` controla quem é mencionado quando um é aberto; eles não precisam ser iguais. ![liam adiciona @Trainee como cargo de suporte e @on-call como cargo mencionado de support, e o Petto confirma cada um](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-step-5.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=a9df30419988d15b6dedf05fbe7580f6) No Discord: mais um cargo de suporte e um cargo mencionado para support. **6. Defina um padrão de nome (opcional)** ```javascript theme={null} !ticket category edit support --naming ticket-{number} ``` Aceita `{number}`, `{username}`, `{userid}` e `{category}`; o padrão é `ticket-{number}`. Veja os [placeholders de tickets](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md#tickets). ![liam digita !ticket category edit support --naming ticket-\{number} e o Petto responde que a categoria support foi atualizada](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-step-6.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=b0ee252d8cf311b2e59b9a0c66339420) No Discord: o padrão de nome de support. **7. Teste você mesmo** Clique no seu próprio painel. Lá dentro, use `!ticket claim` para assumir o ticket e `!ticket close "Testando"` para fechá-lo e gerar um link da transcrição. ![Abaixo do painel o Petto responde só para liam: Ticket aberto: #ticket-0001](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-step-7-open.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=dfb7a4affca9baa6966bf424e19e6ac4) No Discord: liam aperta Suporte geral no próprio painel. ![Em #ticket-0001 o card de boas-vindas menciona @on-call; liam digita !ticket claim e o Petto publica Ticket assumido, depois !ticket close Testando e o Petto publica Ticket 0001 fechado com Reabrir, Apagar e Ver transcrição](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-step-7.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=60b5e97a550013a93dfef26fae306d59) No Discord: dentro do ticket de teste: as boas-vindas mencionam @on-call, depois assumir e fechar. ![liam publica o painel no #suporte: Precisa de ajuda?, Escolha uma categoria abaixo, e os botões Suporte geral e Pagamentos](https://mintcdn.com/wikipetto/ym43wKcqHRA_RnWi/images/discord/guides/pt-br/ticket-panel.webp?fit=max\&auto=format\&n=ym43wKcqHRA_RnWi\&q=85\&s=efa573524e5780d12938c83b715f84ba) No Discord: o painel deste guia com as duas categorias. ## Usando um embed salvo para o painel ou a mensagem de boas-vindas Em vez de `title`/`description` simples, `!ticket panel create` aceita o nome de um embed salvo com `--embed_template`, e `!ticket category add` (e `edit`) aceita um para a mensagem de boas-vindas com `--welcome_embed`; veja [Embeds](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md) para saber como criar um antes. ![liam digita !ticket panel create #suporte --embed\_template support-panel e o Petto publica o embed Suporte do Petto Land e responde que o painel 1 foi publicado](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-embed.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=e20befeb8a8d6c5e2193d786375dd04e) No Discord: um painel feito com um embed salvo. ## Fazer perguntas antes de abrir um ticket (opcional) Uma categoria pode usar um [formulário](https://wiki.petto.sbs/pt-br/community/tickets.md#formulários): um pop-up que o membro preenche ao clicar no botão, para que a primeira mensagem já traga os detalhes. Além de respostas curtas ele pode ter opções, caixas de seleção, um seletor de membro, cargo ou canal e um **envio de arquivos** onde os membros anexam imagens (uma captura de tela do problema, por exemplo). As respostas, com as imagens desenhadas, são publicadas no novo ticket e guardadas na [transcrição](https://wiki.petto.sbs/pt-br/community/tickets.md#transcrições). ```javascript theme={null} !ticket form create bug "long_text|what|O que aconteceu?||required;file|shot|Captura de tela||optional|images,2" "Relatar um erro" !ticket category edit support --form bug ``` ## Erros comuns > [accordion] "Category key already in use" > > O Petto responde "Já existe uma categoria com a chave `billing`." O Petto responde "Já existe uma categoria com a chave `billing`." O Petto responde "Já existe uma categoria com a chave `billing`." O Petto responde "Já existe uma categoria com a chave `billing`." O Petto responde "Já existe uma categoria com a chave `billing`." A `key` deve ser única por servidor, não só por painel. Escolha algo específico como `billing-eu` em vez de reutilizar `billing` em dois painéis. > > ![liam digita de novo !ticket category add 1 billing e o Petto responde que já existe uma categoria com a chave billing](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-key-taken.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=f89d3fa06d54c29021355fd83d5f0172) > > No Discord: a chave billing já está em uso. > [accordion] Painel publicado, mas sem botões/menu > > Você precisa de pelo menos uma categoria adicionada ao painel antes que ele mostre qualquer elemento interativo; um painel vazio é só o título/descrição. > > ![O card Precisa de ajuda? com o texto e nada embaixo](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-empty-panel.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=e6f8e7ccf472747d4eeb55ca2c577fe2) > > No Discord: um painel ainda sem categorias. > [accordion] Um membro não consegue abrir um segundo ticket > > Isso é o `max_open`, que por padrão é 1 por categoria. Aumente com `!ticket category edit` se o seu servidor quiser que os membros tenham vários tickets abertos ao mesmo tempo. > > ![Abaixo do painel o Petto responde só para o membro que ele já tem 1 ticket aberto nesta categoria (limite 1)](https://mintcdn.com/wikipetto/-NPyec-GdEakT1iK/images/discord/guides/pt-br/ticket-system-setup-second-ticket.webp?fit=max\&auto=format\&n=-NPyec-GdEakT1iK\&q=85\&s=3b77ce4eeaf077ea127cd72fdcddb8a0) > > No Discord: um membro com um ticket aberto aperta o botão de novo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.