> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lucie.elxy.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Tickets
> Canais privados de suporte entre seus membros e sua equipe: painéis com botões, formulário, transcrições e mais. Tudo grátis.
Os tickets estão em **beta**: por enquanto só funcionam no servidor de suporte da Lucie. Muito em breve chegarão a todos os servidores.
Com os tickets, um membro clica em um botão e a Lucie abre para ele um **canal privado** onde só estão ele e a sua equipe. Ali vocês conversam com calma, resolvem e fecham, e a conversa fica salva como transcrição.
Tudo se configura pelo [painel web](https://lucie.elxy.dev); os comandos são para o dia a dia dentro de cada ticket. E é **totalmente grátis**: não há plano pago nem funções reservadas.
Nesta página, "painel" sozinho é um **painel de tickets**: a mensagem com o botão que abre tickets. O site onde você configura tudo é o **painel web**.
## Colocando para funcionar
Entre em [lucie.elxy.dev](https://lucie.elxy.dev), escolha o servidor e, no grupo **Suporte**, clique em **Tickets**. Você precisa da permissão **Gerenciar Servidor**.
Clique em **Criar o primeiro painel**. Cada painel tem sua própria configuração: equipe, categoria, textos, botões e formulário.
Na aba **Equipe**, escolha os **Cargos da equipe** que vão atender os tickets. Em **Abertura**, escolha a categoria de **Tickets abertos** onde a Lucie vai criar os canais.
Salve com a barra de baixo, escolha o canal na barra do painel e clique em **Publicar**: a Lucie envia ali a mensagem com o botão.
Ligue **Tickets ativos** no cabeçalho e salve. É o último passo de propósito: você pode deixar tudo pronto antes que alguém consiga abrir tickets.
A aba **Resumo** tem uma lista de **Primeiros passos** que marca o que você já fez e te leva ao que falta. Quando estiver tudo certo, `/ticket debug` no Discord confirma que a Lucie tem o que precisa.
## A vida de um ticket
1. **Aberto.** A Lucie cria o canal (por padrão `ticket-0001`; cada painel numera os seus) com uma mensagem de boas-vindas e os botões **Fechar**, **Assumir** e **Ficha**. Só veem o canal quem abriu, a sua equipe e as pessoas adicionadas.
2. **Fechado.** Por padrão, quem abriu continua lendo, mas não escreve mais. O canal vai para a categoria de fechados (se houver) e aparecem os **Controles da equipe**: **Reabrir**, **Transcrição** e **Apagar**.
3. **Apagado.** A Lucie avisa no canal, salva a transcrição se precisar e apaga o canal alguns segundos depois.
Um ticket fechado pode ser reaberto quantas vezes forem necessárias. Se você prefere que fechar seja definitivo, desligue **Manter o ticket fechado** e fechar vai apagá-lo direto.
## O painel web, aba por aba
A seção tem seis abas. **Resumo** vale para o servidor todo; as outras cinco são de um painel, o que você escolhe na barra **Painel:** lá em cima. As alterações de todos os painéis são salvas juntas com a barra de baixo.
### Resumo
* **Contadores**: tickets abertos agora, criados e fechados nos últimos 7 dias, e assumidos.
* **Acesso e limites** (vale para todos os painéis): **Cargos sem tickets** (não podem abrir), **Cargos sem limites** (pulam os limites e esperas) e **Limite do servidor** (100 por padrão; 0 = sem limite).
* **Registro e privacidade**: **Canal de registro**, **Guardar transcrições**, **Painel do /ticket new**, **Ficha do usuário** e **Resumo com IA**.
* **Painéis**: crie, edite, clone ou apague painéis (até 25 por servidor) e veja quais estão publicados.
* **Tickets recentes**: os últimos do servidor, filtráveis por estado ou por ID de usuário, com a transcrição.
* **Histórico de alterações**: quem mudou o quê nos tickets pelo painel web, nos últimos 90 dias.
### Abertura
| Bloco | O que você ajusta |
| - | - |
| **Painel** | Nome, estilo (**Botões**, de 1 a 5 por linha, ou **Menu**) e **Opções da mensagem**: adicione outros painéis para oferecê-los juntos na mesma mensagem. |
| **Categorias** | Até 5 para **Tickets abertos** e 5 para **Tickets fechados**, em ordem: quando uma chega a 50 canais, a Lucie usa a seguinte. |
| **Nome e numeração** | Nome do canal **Ao abrir** (vazio = `ticket-0001`), **Ao fechar** e **Ao assumir** (vazio = não renomeia). Aceita variáveis. |
| **Limites** | **Abertos por pessoa** (1 por padrão), **Fechados por pessoa** (3) e **Abertos no painel** (sem limite). 0 = sem limite. |
| **Formulário** | Até 5 perguntas (texto curto, parágrafo ou menu) respondidas antes de abrir. As respostas aparecem nas boas-vindas. |
Sem categoria de fechados, os tickets fechados ficam na de abertos e vão enchendo ela. E o Discord só deixa renomear um canal 2 vezes a cada 10 minutos, então um nome novo pode demorar a aparecer.
### Mensagens
As 13 mensagens que a Lucie envia —o painel publicado, as boas-vindas, a confirmação de fechamento, os avisos do canal, as DMs para o autor…— podem ser reescritas: um conteúdo e um embed com título, descrição, cor e rodapé. Cada uma usa o texto padrão, no idioma do servidor, até você mudar; **Restaurar** volta para ele. Alguns avisos podem ser desligados com **Não enviar esta mensagem**.
O editor tem **prévia** e um ajudante de **Variáveis**: clique em uma e ela entra onde está o cursor. As menções só notificam se estiverem no conteúdo, não no embed. As variáveis mais úteis:
| Variável | Vira |
| - | - |
| `{ticket.user}` | Menção a quem abriu o ticket (`{ticket.user.name}` é o nome) |
| `{user}` | Quem faz a ação: fecha, reabre, assume… |
| `{ticket.number}` | Número do ticket; `{ticket.number?pl=4}` completa com zeros (`0042`) |
| `{server.name}` · `{panel.name}` | Nome do servidor e do painel |
| `{create.reason}` · `{close.reason}` | Motivo ao abrir e ao fechar |
| `{create.form.0}` … `{create.form.4}` | Respostas do formulário, da primeira à quinta |
| `{claim.user}` | Quem está atendendo o ticket |
| `{transcript.url}` | Link da transcrição |
### Botões
Texto (até 80 caracteres), emoji, cor (azul, cinza, verde ou vermelho) e se aparece, para os 8 botões editáveis: **Abrir ticket**, **Fechar**, **Cancelar fechamento**, **Confirmar fechamento**, **Reabrir**, **Apagar**, **Transcrição** e **Assumir**. Um botão pode ficar sem texto ou sem emoji, mas não sem os dois.
Um emoji de outro servidor só funciona se a Lucie estiver nesse servidor. Se ela não puder usá-lo, a aba avisa e no Discord aparece o emoji padrão.
### Equipe
* **Cargos da equipe** (até 10): veem todos os tickets do painel e podem fechá-los, assumi-los, apagá-los e usar o resto das ações.
* **Cargos adicionais** (até 10): veem os tickets com as permissões da sua linha, mas sem as ações da equipe.
* **Assumir**: **Permitir assumir**, **Só quem assumiu o libera**, **Tomar o ticket de outro** e **Resto da equipe só leitura** (enquanto está assumido, o resto da equipe não escreve).
* **Permissões no canal**: o que cada grupo (autor e adicionados, equipe, adicionais) pode fazer com o ticket **Aberto** e **Fechado**. O `@everyone` nunca vê os tickets.
Quem gerencia o servidor (dono, **Administrador** ou **Gerenciar Servidor**) sempre conta como equipe em todos os painéis. Se um painel não tem cargos de equipe, só essas pessoas vão ver os tickets dele.
### Fechamento
| Bloco | O que você ajusta |
| - | - |
| **Fechamento** | **Pedir confirmação**, **Manter o ticket fechado**, **Pedir motivo**, **O autor pode fechá-lo** e **Espera antes de apagar** (de 3 a 30 segundos; 5 por padrão). |
| **Transcrições** | Salvar **Ao fechar** e **Ao apagar**, **Anexar .html ao registro** e **Enviar o .html ao autor**. |
| **Registro** | Um canal próprio para este painel (vazio = o do servidor) e o que registrar: aberto, fechado, reaberto, apagado, assumido, liberado e transcrição salva. |
| **Mensagens diretas** | Avisar o autor **Ao abrir** (desligado por padrão) e **Ao fechar**, com o motivo e a transcrição. |
## Publicar o painel em um canal
Em qualquer aba de um painel, a barra lá em cima tem o canal e o botão **Publicar**. A Lucie publica o que está **salvo**, então salve antes.
* Depois de publicado, o botão vira **Atualizar**. Se você muda algo e salva, o selo **Alterações não publicadas** te lembra de clicar nele.
* Se você publica em **outro canal**, a Lucie apaga a mensagem anterior: nunca ficam duas cópias do painel funcionando.
* **Atualizar por link** reaproveita um painel de tickets da Lucie que já exista: cole o link dele (clique direito na mensagem › Copiar link) e a Lucie edita ele com este painel.
A Lucie precisa de **Ver canal**, **Enviar mensagens** e **Inserir links** nesse canal.
## Dentro de um ticket
### Abrir
O membro clica no botão do painel (ou escolhe a opção dele no menu). Se o painel tem formulário, ele preenche primeiro; se não, o canal abre na hora e a Lucie responde com o link. Também dá para usar `/ticket new`, que abre com o **Painel do /ticket new**.
### Fechar
**Fechar** nas boas-vindas. Dependendo do painel, a Lucie pede o motivo, pede confirmação (**Fechar ticket** / **Cancelar**) ou fecha direto. Por padrão, quem abriu também pode fechar. `/ticket close` fecha sem passo de confirmação.
### Reabrir e apagar
Com o ticket fechado, a equipe tem **Reabrir** (devolve as permissões de aberto e a categoria de abertos) e **Apagar** (pede confirmação, avisa no canal e apaga depois da espera configurada). Só a equipe pode reabrir e apagar.
### Assumir
**Assumir** atribui o ticket a quem clica, e o botão vira **Liberar**. A Lucie avisa o autor de quem vai atendê-lo, sem mencionar quem assumiu. Se alguém da equipe já está com ele, os outros não podem tomá-lo, a não ser que você ative **Tomar o ticket de outro**; quem gerencia o servidor sempre pode.
### Adicionar e remover
`/ticket add` dá acesso a um usuário ou a um cargo, e `/ticket remove` tira. Os adicionados têm as mesmas permissões que o autor. No máximo **20** usuários e cargos adicionados por ticket.
Não dá para adicionar nem remover o `@everyone`, a Lucie ou o autor, nem remover quem está atendendo o ticket. Os cargos da equipe e os adicionais se mudam no painel web, não por aqui.
### Pedido de fechamento
Quando você achar que a solicitação foi resolvida, `/ticket closerequest` pergunta ao autor se pode fechar. Chega para ele com **Sim, fechar** e **Não, manter aberto**, e só ele pode responder: se aceitar, o ticket fecha; se não, continua aberto e a mensagem avisa.
### Renomear
`/ticket rename` muda o nome do canal. O Discord só permite 2 mudanças de nome a cada 10 minutos por canal, então a Lucie aplica assim que puder.
## Comandos
Todos funcionam com `/ticket` e com `!ticket` (atalhos `tickets` e `tk`). Tirando `new` e `debug`, são usados **dentro do canal do ticket**. `!ticket` sozinho mostra a ajuda. "Equipe" inclui quem gerencia o servidor.
| Subcomando | O que faz | Quem |
| - | - | - |
| `new [motivo]` | Abre um ticket com o **Painel do /ticket new** | Qualquer pessoa |
| `close [motivo]` | Fecha o ticket | Equipe e, se o painel permitir, o autor |
| `reopen` | Reabre um ticket fechado | Equipe |
| `delete [motivo]` | Apaga o ticket | Equipe |
| `claim` · `unclaim` | Assume ou libera o ticket | Equipe |
| `add` · `remove` | Dá ou tira acesso de um usuário ou cargo (menção ou ID) | Equipe |
| `rename ` | Muda o nome do canal | Equipe |
| `transcript` | Salva a transcrição e te dá o link | Equipe |
| `closerequest [motivo]` | Pede ao autor que confirme o fechamento | Equipe |
| `debug` | Diagnostica a configuração e as permissões da Lucie | Equipe |
Com o prefixo, os verbos também funcionam em português: `!ticket novo`, `fechar`, `reabrir`, `apagar`, `assumir`, `liberar`, `adicionar`, `remover`, `renomear`, `transcricao`, `pedirfechamento` e `diagnostico`.
**Exemplos**
```text theme={"dark"}
!ticket novo Não consigo entrar no servidor
!ticket fechar resolvido
!ticket add @usuario
!ticket rename pagamento-pendente
/ticket add usuario: @usuario
```
Se o painel tem formulário, `!ticket new` não consegue mostrá-lo: use o botão do painel ou `/ticket new`.
## A ficha do usuário
O botão **Ficha** das boas-vindas mostra, **só para a equipe** e só para quem clica, o contexto de quem abriu o ticket no seu servidor:
* Quando criou a conta, desde quando é membro e quem o convidou.
* Os tickets anteriores dele no servidor, com link para as transcrições.
* Os casos de moderação, as advertências ativas e se ele tem um banimento global.
O registro de abertura também traz um resumo de uma linha. Dá para desligar em **Resumo** → **Ficha do usuário**.
## Transcrições
Uma transcrição é uma cópia da conversa do ticket: mensagens, respostas, embeds, figurinhas e anexos (as imagens são hospedadas de novo para não se perderem). É salva ao fechar e ao apagar, conforme o painel, e quando alguém da equipe clica em **Transcrição** ou usa `/ticket transcript`.
### O visualizador web
Cada transcrição tem sua página em `lucie.elxy.dev/t/…`. Para vê-la é preciso **entrar com o Discord**, e só veem:
* Quem abriu o ticket e os usuários adicionados.
* Os cargos da equipe do painel e os cargos adicionados ao ticket.
* Quem gerencia o servidor e a equipe da Lucie.
Os canais privados mencionados no ticket aparecem como `#canal-privado`, para o autor não ver nomes de canais internos.
### A cópia .html
Além disso, a Lucie gera uma **cópia portátil**: um único arquivo `.html` que abre em qualquer navegador, sem conta. Por padrão ela é anexada ao **registro** do servidor e à **DM de fechamento** do autor, se couber no limite de envio do Discord. As imagens pequenas vão dentro; o resto dos anexos aponta para a versão web enquanto ela existir.
A cópia `.html` fica no Discord: quem vê o canal de registro (ou a DM) vê ela, e ela **não expira** com a retenção da Lucie. É a cópia duradoura; se não quiser, desligue **Anexar .html ao registro** e **Enviar o .html ao autor** na aba **Fechamento**.
### Por quanto tempo ficam guardadas
Em **Resumo** → **Guardar transcrições** você escolhe **30, 60, 90, 180 ou 365 dias** (60 por padrão). Quando o prazo acaba, a Lucie apaga a transcrição e os arquivos dela, e também as respostas do formulário, os motivos e o resumo IA daquele ticket.
A mudança vale também para o que já está guardado: se você diminui, o mais antigo é apagado para sempre (o painel web pede confirmação). Dá para apagar uma transcrição antes do prazo em **Tickets recentes**.
### Limites
* Até **5.000 mensagens** por transcrição: as mais recentes, com aviso se faltar alguma.
* Anexos de até **8 MB** cada e **100 MB** por transcrição.
* **200 transcrições por dia** e **2 GB** guardados por servidor; passado esse espaço, são salvas sem anexos.
* Clicar em **Transcrição** sem mensagens novas devolve a mesma; com mensagens novas, no máximo uma a cada 5 minutos por ticket.
## Resumo com IA
Opcional e **desligado por padrão**. Se você ativar em **Resumo** → **Resumo com IA**, ao fechar um ticket a Lucie resume a conversa em quatro partes —**Problema**, **O que foi feito**, **Resultado** e **Pendente**— e adiciona ao registro de fechamento e ao cabeçalho da transcrição, no idioma do servidor.
Para isso ela envia à DeepSeek uma versão condensada da conversa, **sem IDs**. Há um máximo de 50 resumos por dia por servidor.
## Permissões que a Lucie precisa
O link oficial de convite já pede tudo o que é necessário. Isto serve se você tirou permissões dela ou se as suas categorias têm substituições.
| Onde | Permissões | Para quê |
| - | - | - |
| Servidor | **Ver canal**, **Gerenciar canais**, **Gerenciar cargos**, **Enviar mensagens**, **Inserir links**, **Anexar arquivos** e **Ler histórico de mensagens** | Criar os canais e ajustar as permissões deles |
| Categorias de tickets | **Ver canal**, **Gerenciar canais** e **Gerenciar cargos** | Criar e mover canais dentro delas |
| Canal do painel | **Ver canal**, **Enviar mensagens** e **Inserir links** | Publicar o painel |
A Lucie só pode dar ou tirar num ticket as permissões que ela mesma tem: se faltar alguma, a tabela **Permissões no canal** avisa. Coloque também o cargo dela acima dos cargos da equipe.
## Limites anti-abuso
Além dos limites de cada painel e do servidor, há alguns fixos para ninguém lotar o servidor de canais:
| Limite | Valor |
| - | - |
| Entre dois tickets da mesma pessoa | 10 segundos |
| Tickets de uma pessoa em uma hora (servidor todo) | 5 |
| Tickets novos no servidor | 10 a cada 10 segundos |
Quem gerencia o servidor e os **Cargos sem limites** pulam todos os limites e esperas, menos os 10 segundos entre tickets. **Cargos sem tickets** bloqueia todo mundo, menos quem gerencia o servidor.
## Se algo der errado
Quando algo falha, a Lucie responde com uma mensagem que traz um **código** (como `TK-PERMS`) e um link para a explicação dele. Em [Erros de tickets](/pt/tickets/errores) você encontra a causa e a solução de cada um.
Para revisar tudo de uma vez, use `/ticket debug`: ele diz se os tickets estão ativos, que permissões faltam para a Lucie, como estão as categorias e que problemas cada painel tem.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.