Pular para o conteúdo principal

Resumo

O suporte com fóruns deixa os membros pedirem ajuda em um canal de fórum. Eles clicam em um botão de um painel, preenchem um formulário curto, escolhem o tipo de consulta (uma tag do fórum) e o Petto cria a postagem para eles. Dentro da postagem, o autor e a equipe têm ferramentas para bloqueá-la, fechá-la e resolvê-la. Funciona como os Tickets, mas cada pergunta é uma postagem de um fórum que outros membros podem encontrar depois.
O suporte com fóruns fica desligado até você configurar um fórum com !forum setup #forum (Gerenciar servidor). Nada muda em um servidor que não usa. !forum é um comando com prefixo (alias !forums); não há comandos slash. !forumconfig mostra o cartão do módulo.
liam digita !forumconfig e o Petto responde com o cartão de configuração do suporte com fóruns: a configuração ajuda, o fórum dela, o estado e os comandos para mudá-la

No Discord: !forumconfig com a configuração do fórum e todos os comandos do módulo.

Configure

1

Escolha o fórum

!forum setup #suporte ajuda cria uma configuração chamada ajuda para o fórum #suporte. Um servidor pode ter até 5 configurações, uma por canal de fórum. O Petto confere o que falta a ele no fórum e avisa, e cria uma tag Resolvido se o fórum não tiver nenhuma e ele puder editá-lo.
liam digita !forum setup #suporte ajuda e o Petto responde com o cartão da configuração ajuda: o fórum, quem pode fazer o quê, as postagens e a automação, tudo ainda desligado

No Discord: !forum setup com o fórum e um nome; o cartão mostra quem pode fazer o quê e a automação.

2

Escolha a equipe

!forum set staff-roles @Ajudantes diz quais cargos são a equipe deste fórum. Membros com Gerenciar tópicos são equipe em todo lugar.
liam digita !forum set staff-roles @Ajudantes e o Petto responde que salvou staff-roles da configuração ajuda

No Discord: o cargo da equipe é salvo.

3

Poste o painel

!forum panel #info-suporte posta o cartão com o botão Abrir postagem. Se você executar de novo, a mensagem que já está é editada em vez de postar uma nova. Com outro canal, o painel vai para lá.
liam digita !forum panel #info-suporte e o Petto responde que postou o painel da configuração ajuda, com o link

No Discord: !forum panel com o canal do painel.

O painel Abrir uma postagem em #info-suporte: o texto que explica como abrir uma postagem e o botão verde Abrir postagem embaixo

No Discord: o painel com o botão Abrir postagem.

4

Confira

!forum status mostra as configurações, quem pode fazer o quê, a automação e qualquer permissão que falte ao Petto.
liam digita !forum status e o Petto responde com o cartão da configuração e um aviso de que falta a permissão Gerenciar tópicos no fórum, mais três permissões opcionais

No Discord: !forum status com a permissão que falta ao Petto.

Você pode fazer o mesmo, e muito mais, pelo painel web: Comunidade, Fóruns (ao lado de Tickets). Tem as configurações, um editor com prévia ao vivo do painel, o botão de “Postar ou atualizar o painel” e a lista de postagens com botões de Bloquear, Fechar e Resolvida.
A página Fóruns com três configurações: ajuda e opiniões ligadas, bugs desligada, cada uma com o fórum, um link para o painel e os botões Editar e Desligar, e um aviso em opiniões de que o Petto não pode postar lá

Dashboard → Comunidade → Fóruns: as configurações dos seus fóruns, cada uma com o painel e as postagens.

O editor da configuração ajuda com as opções do fórum e do painel à esquerda e a prévia do cartão Abrir uma postagem com o botão verde à direita

Dashboard → Comunidade → Fóruns: o editor de uma configuração: o fórum, o painel e uma prévia ao vivo dele e da primeira mensagem.

A página Postagens de fóruns com a aba Abertas: cinco postagens com o autor, a data, o estado e quem cuida delas, e um botão Bloquear, Fechar e Resolvido em cada uma

Dashboard → Comunidade → Fóruns: as postagens dos seus fóruns com os botões Bloquear, Fechar e Resolvido.

O que os membros veem

  1. Clicam em Abrir postagem no painel.
  2. Um formulário pede o título e a descrição, e até três perguntas a mais que você adicionar (texto curto, parágrafo ou um menu de opções). Se você ativar as imagens, o formulário tem um envio de imagens.
  3. Se o fórum tem tags, um menu pede o tipo de consulta (a tag). É pulado quando o fórum não tem tags para escolher. Uma tag pode ser opcional (um botão “Postar sem tag”) ou obrigatória.
  4. O Petto cria a postagem e responde com um link privado para ela.
O formulário Abrir uma postagem com o título e a descrição preenchidos, uma pergunta curta sobre a versão e um menu com a plataforma

No Discord: o formulário que abre quando um membro clica em Abrir postagem.

A postagem Não consigo entrar no painel com a tag Bug: o Petto escreveu Postagem aberta por enderwolf e a descrição, depois o formulário enviado com a versão e a plataforma, e um cartão que avisa Ajudantes e lista três regras

No Discord: uma postagem nova: a primeira mensagem, as respostas do formulário e o cartão com as regras e o cargo que é avisado.

O cartão Formulário com o título da janela e os rótulos, o interruptor de imagens e duas perguntas, um texto curto e um menu de opções

Dashboard → Comunidade → Fóruns: o formulário: os textos da janela e até três perguntas a mais.

O cartão da postagem com o estilo da primeira mensagem em linha e cartão, o modo lento, três regras e o cargo Ajudantes que é avisado

Dashboard → Comunidade → Fóruns: a primeira mensagem, as regras e os cargos que são avisados.

Uma postagem com só a linha Postagem aberta por enderwolf como primeira mensagem, a descrição em um cartão verde embaixo, depois o formulário enviado e o cartão de regras

No Discord: a mesma postagem com a primeira mensagem no estilo cartão: uma linha, e a descrição em um cartão.

Embaixo do painel, uma mensagem que só o membro vê: Escolha o tipo de consulta, com o menu aberto mostrando Bug, Pergunta e Conta, e os botões Postar sem tag e Cancelar

No Discord: a etapa para escolher o tipo de consulta, vista só pelo membro.

Uma mensagem que só o membro vê: Sua postagem está pronta, com o link para a nova postagem

No Discord: o Petto responde com um link privado para a nova postagem.

A primeira mensagem da postagem diz Postagem aberta por @membro - título seguida da descrição. Você pode mudar com um modelo que use {user}, {username}, {title}, {description}, {tag}, {server} e {forum}, ou deixar só a primeira linha na mensagem e a descrição em um cartão. Depois vêm as respostas às outras perguntas, as imagens e um cartão com suas regras e os cargos a mencionar.
O texto usual do painel diz, como outros bots, que não dá para anexar imagens ao preencher o formulário e que elas podem ser adicionadas quando a postagem estiver aberta. Se você ativar as imagens no formulário, o texto diz o contrário. Você pode escrever seu próprio texto ou usar um design salvo (um cartão Components V2 feito no designer de embeds): o botão vai embaixo.

Tags

  • Os membros só podem escolher as tags que a configuração permite (todas se você não escolheu nenhuma), nunca as que só moderadores usam nem a tag Resolvido.
  • Uma postagem pode ter até o número de tags que você permitir (de 1 a 5).
  • Se o próprio fórum exige uma tag, o Petto pede uma mesmo que a configuração não peça.
O cartão Tags: tag obrigatória desligada, duas tags por postagem, Resolvido como tag de resolvido e as caixas Bug, Pergunta e Conta marcadas, Resolvido e Moderação desmarcadas

Dashboard → Comunidade → Fóruns: quais tags os membros podem escolher, quantas uma postagem pode ter e a tag que significa resolvido.

Limites e bloqueios

Cada recusa é mostrada só ao membro, no idioma dele, com o motivo.
Embaixo do painel, uma mensagem que só o membro vê: Você já tem 3 postagens abertas (o máximo é 3), com links para elas, e Feche ou resolva uma antes de abrir outra

No Discord: um membro que já tem três postagens abertas é recusado, e só ele vê.

O cartão Quem pode fazer o quê com os cargos da equipe Moderadores e Ajudantes, o cargo bloqueado Silenciado, três postagens abertas por membro, 30 segundos entre postagens e os três interruptores do autor ligados

Dashboard → Comunidade → Fóruns: os cargos da equipe, quem pode abrir postagens, os limites e o que o autor pode fazer.

Comandos

Dentro de uma postagem de fórum funcionam as ferramentas abaixo. Cada uma responde com um cartão verde pequeno, por exemplo @equipe: #postagem foi bloqueada com sucesso, com uma menção silenciosa.
chu digita !tl com um motivo e o Petto responde com o cartão verde: chu, bloqueou a postagem com sucesso, e o motivo em letra pequena

No Discord: !tl com um motivo bloqueia a postagem.

chu digita !tul e o Petto responde com o cartão verde: desbloqueou a postagem com sucesso

No Discord: !tul deixa os membros escreverem de novo.

enderwolf digita !forum close com um motivo e o Petto responde com o cartão verde de postagem fechada com sucesso e o motivo

No Discord: o autor fecha a própria postagem; o cartão é a última mensagem.

kira digita !forum reopen em uma postagem fechada e o Petto responde com o cartão verde de postagem aberta de novo com sucesso

No Discord: uma postagem fechada é aberta de novo.

Depois que a kira ajuda, enderwolf digita !forum solved e o Petto responde com o cartão verde de postagem marcada como resolvida e uma nota de que ela será fechada amanhã

No Discord: o autor marca a postagem como resolvida; o cartão diz quando ela será fechada.

enderwolf pede para reabrir o assunto e digita !forum unsolved; o Petto responde com o cartão verde dizendo que a postagem não está mais resolvida

No Discord: a tag Resolvido sai.

enderwolf digita !forum rename com um título novo e o Petto responde com o cartão verde: o título da postagem agora é o novo, em negrito

No Discord: o autor muda o título da própria postagem.

shi digita !forum tag add Bug e depois !forum tag remove Pergunta; o Petto responde a cada um com um cartão verde

No Discord: uma tag é adicionada e outra removida.

enderwolf digita !forum tag list e o Petto responde com um cartão que lista Bug, Pergunta, Conta, Resolvido e Moderação (só equipe), com Pergunta em negrito porque a postagem tem essa tag

No Discord: as tags do fórum, com as da postagem em negrito.

kira digita !forum claim e o Petto responde Quem cuida é kira; mais tarde kira digita !forum unclaim e o Petto responde que ela não cuida mais da postagem

No Discord: um membro da equipe diz que cuida da postagem e depois a solta.

kira digita !forum list e o Petto responde com o cartão Postagens do fórum, mostrando Abertas: cinco postagens com link, autor, estado e hora, e um menu para ver os outros estados

No Discord: as postagens abertas dos fóruns, com o autor, o estado e quem cuida delas.

Com mais de uma configuração, adicione --setup <nome> aos comandos de configuração (eles também são achados pelo fórum em que você os digita).

Quem pode usar as ferramentas

  • O autor de uma postagem pode fechá-la, marcá-la como resolvida e mudar o título, só na própria postagem. Você pode desligar cada uma (author-close, author-solve, author-rename).
  • Os cargos da equipe da configuração e os membros com Gerenciar tópicos podem usar todas as ferramentas em qualquer postagem.
  • Um membro da equipe que só tem um cargo de equipe não pode agir na postagem de um membro cujo cargo mais alto esteja acima do dele (a mesma regra dos comandos de moderação). Gerenciar tópicos não é barrado por ela.
  • Em um fórum sem configuração, só membros com Gerenciar tópicos podem usar as ferramentas, então !tl funciona em qualquer fórum para os moderadores.
  • Fora de uma postagem de fórum, as ferramentas respondem que não é uma postagem de fórum. O Petto confere as próprias permissões e diz qual falta.
enderwolf digita !tl na própria postagem e o Petto responde com um cartão amarelo: Só a equipe deste fórum pode fazer isso

No Discord: um membro que não é da equipe não pode bloquear uma postagem.

Mover uma mensagem para o fórum

Responda a uma mensagem (ou dê o link ou o ID dela) e digite !forum move. O Petto cria uma postagem no fórum com o cartão Mensagem original (o que dizia e quem escreveu) e uma nota de quem moveu, e deixa uma resposta sob a mensagem que aponta para a postagem e menciona o autor. A mensagem original não é apagada. Adicione o fórum e um título se precisar: !forum move #suporte Não consigo entrar.
Nova pergunta sobre o cartão de nível dela no #general, kira responde com !forum move e um título, e o Petto responde embaixo da mensagem que a moveu para a nova postagem

No Discord: kira responde a uma mensagem com !forum move; o Petto responde embaixo da mensagem com o link para a nova postagem.

A nova postagem no fórum: a mensagem original da Nova, depois o cartão Mensagem original com quem escreveu e onde, a citação e quem moveu

No Discord: a nova postagem, com o cartão Mensagem original.

Opções de !forum set

max-open, cooldown, slowmode, require-tag, max-tags, images, adopt, tag-wait, inactive-days, inactive-action (lock ou close), solved-action (none, lock ou close), solved-delay (horas), author-close, author-solve, author-rename, staff-roles, ping-roles, required-roles, blocked-roles, guidelines, first-message, first-message-style (plain ou card), panel-title, panel-text, panel-footer, panel-image, panel-color, panel-design, button-label, button-emoji, button-style, modal-title, title-label e description-label. Use none para apagar um texto ou uma lista. As perguntas extras do formulário e os eventos do registro são configurados no painel web.

Automação

Uma tarefa roda a cada minuto e só lê um índice das postagens que chegaram a hora, então custa quase nada. Tudo é opcional e vem desligado.
  • Postagens sem atividade: inactive-days bloqueia ou fecha uma postagem em que ninguém escreveu por esses dias.
  • Postagens resolvidas: solved-action e solved-delay bloqueiam ou fecham uma postagem depois desse tempo desde que foi marcada como resolvida.
  • Postagens feitas à mão: com adopt ligado, uma postagem feita no fórum sem o painel é guardada, recebe as regras e a menção à equipe e pode usar as ferramentas. Se require-tag está ligado e a postagem não tem tag, o Petto pede ao autor que escolha uma e fecha a postagem quando passam tag-wait minutos.
Uma mensagem em uma postagem guarda sua última atividade no máximo uma vez a cada 5 minutos.
O cartão Automação com as postagens sem atividade fechadas depois de 7 dias, as resolvidas fechadas 24 horas depois e o interruptor para manter as feitas à mão com 10 minutos para escolher uma tag

Dashboard → Comunidade → Fóruns: postagens sem atividade, postagens resolvidas e postagens feitas à mão.

Registro

A categoria de registro forums (!logs add #canal forums) avisa quando uma postagem é aberta, bloqueada, fechada ou resolvida, quem fez (ou que o Petto fez sozinho) e por quê. Cada um dos quatro pode ser desligado no painel web, para cada configuração. Veja Registros.
O cartão Registro com os quatro eventos marcados: postagens abertas, bloqueadas, fechadas e resolvidas

Dashboard → Comunidade → Fóruns: o que é contado no registro de cada configuração.

Permissões de que o Petto precisa

No canal de fórum: Ver canal, Enviar mensagens (para criar postagens), Enviar mensagens em tópicos e Gerenciar tópicos (para bloquear, fechar e marcar com tags). Criar tópicos públicos, Anexar arquivos (copiar as imagens do formulário) e Gerenciar canais (criar a tag Resolvido) são opcionais. No canal do painel: Ver canal e Enviar mensagens. !forum status lista o que falta.

Solução de problemas

Dê ao Petto as permissões acima no canal de fórum (ou na categoria dele) e execute !forum status de novo.
Um fórum tem no máximo 20 tags e o Petto precisa de Gerenciar canais para adicionar uma. Adicione você mesmo uma tag chamada Resolvido, ou escolha outra tag no painel web.
O painel pertence a uma configuração que foi desligada ou removida, ou o fórum foi apagado. Execute !forum status e depois !forum panel para postá-lo de novo.
Use dentro de uma postagem de um fórum. Em um fórum sem configuração você precisa de Gerenciar tópicos.
chu digita !tl no #general e o Petto responde com um cartão amarelo: Isto não é uma postagem de fórum. Use dentro de uma postagem de um fórum

No Discord: !tl digitado em um canal normal.

Olhe inactive-days, solved-action e tag-wait em !forum status. A categoria de registro forums diz qual regra fez isso.