Saltar al contenido principal

Resumen

El soporte con foros deja que los miembros pidan ayuda en un canal de foro. Pulsan un botón de un panel, rellenan un formulario corto, eligen el tipo de consulta (una etiqueta del foro) y Petto crea la publicación por ellos. Dentro de la publicación, el autor y el staff tienen herramientas para bloquearla, cerrarla y resolverla. Funciona como los Tickets, pero cada pregunta es una publicación de un foro que otros miembros pueden encontrar después.
El soporte con foros está apagado hasta que configures un foro con !forum setup #foro (Gestionar servidor). No cambia nada en un servidor que no lo usa. !forum es un comando con prefijo (alias !forums); no hay comandos slash. !forumconfig muestra la tarjeta del módulo.
liam escribe !forumconfig y Petto responde con la tarjeta de configuración del soporte con foros: la configuración ayuda, su foro, su estado y los comandos para cambiarla

En Discord: !forumconfig con la configuración del foro y todos los comandos del módulo.

Configúralo

1

Elige el foro

!forum setup #soporte ayuda crea una configuración llamada ayuda para el foro #soporte. Un servidor puede tener hasta 5 configuraciones, una por canal de foro. Petto revisa qué le falta en el foro y lo dice, y crea una etiqueta Resuelto si el foro no tiene ninguna y puede editarlo.
liam escribe !forum setup #soporte ayuda y Petto responde con la tarjeta de la configuración ayuda: el foro, quién puede hacer qué, las publicaciones y la automatización, todo aún apagado

En Discord: !forum setup con el foro y un nombre; la tarjeta muestra quién puede hacer qué y la automatización.

2

Elige el staff

!forum set staff-roles @Ayudantes indica qué roles son el staff de este foro. Los miembros con Gestionar hilos son staff en todas partes.
liam escribe !forum set staff-roles @Ayudantes y Petto responde que guardó staff-roles de la configuración ayuda

En Discord: el rol del staff se guarda.

3

Publica el panel

!forum panel #info-soporte publica la tarjeta con el botón Abrir publicación. Si lo ejecutas otra vez, el mensaje que ya está se edita en lugar de publicar uno nuevo. Con otro canal, el panel se mueve allí.
liam escribe !forum panel #info-soporte y Petto responde que publicó el panel de la configuración ayuda, con el enlace

En Discord: !forum panel con el canal del panel.

El panel Abrir una publicación en #info-soporte: el texto que explica cómo abrir una publicación y el botón verde Abrir publicación debajo

En Discord: el panel con el botón Abrir publicación.

4

Compruébalo

!forum status muestra los ajustes, quién puede hacer qué, la automatización y cualquier permiso que le falte a Petto.
liam escribe !forum status y Petto responde con la tarjeta de la configuración y un aviso de que le falta el permiso Gestionar hilos en el foro, más tres permisos opcionales

En Discord: !forum status con el permiso que le falta a Petto.

Puedes hacer lo mismo, y mucho más, desde el panel web: Comunidad, Foros (junto a Tickets). Tiene las configuraciones, un editor con vista previa en vivo del panel, el botón de “Publicar o actualizar el panel” y la lista de publicaciones con botones de Bloquear, Cerrar y Resuelta.
La página Foros con tres configuraciones: ayuda y opiniones activadas, errores apagada, cada una con su foro, un enlace a su panel y los botones Editar y Apagar, y un aviso en opiniones de que Petto no puede publicar ahí

Dashboard → Comunidad → Foros: las configuraciones de tus foros, cada una con su panel y sus publicaciones.

El editor de la configuración ayuda con los ajustes del foro y del panel a la izquierda y la vista previa de la tarjeta Abrir una publicación con su botón verde a la derecha

Dashboard → Comunidad → Foros: el editor de una configuración: el foro, el panel y una vista previa en vivo de él y del primer mensaje.

La página Publicaciones de foros con la pestaña Abiertas: cinco publicaciones con su autor, fecha, estado y quién las atiende, y un botón Bloquear, Cerrar y Resuelto en cada una

Dashboard → Comunidad → Foros: las publicaciones de tus foros con los botones Bloquear, Cerrar y Resuelto.

Qué ven los miembros

  1. Pulsan Abrir publicación en el panel.
  2. Un formulario pide el título y la descripción, y hasta tres preguntas más que añadas (texto corto, párrafo o un menú de opciones). Si activas las imágenes, el formulario tiene una subida de imágenes.
  3. Si el foro tiene etiquetas, un menú pide el tipo de consulta (la etiqueta). Se omite cuando el foro no tiene etiquetas que elegir. Una etiqueta puede ser opcional (un botón “Publicar sin etiqueta”) u obligatoria.
  4. Petto crea la publicación y responde con un enlace privado a ella.
El formulario Abrir una publicación con el título y la descripción rellenados, una pregunta corta sobre la versión y un menú con la plataforma

En Discord: el formulario que se abre cuando un miembro pulsa Abrir publicación.

La publicación No puedo entrar al panel con la etiqueta Error: Petto escribió Publicación abierta por enderwolf y la descripción, luego el formulario enviado con la versión y la plataforma, y una tarjeta que avisa a Ayudantes y lista tres normas

En Discord: una publicación nueva: el primer mensaje, las respuestas del formulario y la tarjeta con las normas y el rol al que se avisa.

La tarjeta Formulario con el título de la ventana y las etiquetas, el interruptor de imágenes y dos preguntas, un texto corto y un menú de opciones

Dashboard → Comunidad → Foros: el formulario: los textos de la ventana y hasta tres preguntas más.

La tarjeta de la publicación con el estilo del primer mensaje en línea y tarjeta, el modo lento, tres normas y el rol Ayudantes al que se avisa

Dashboard → Comunidad → Foros: el primer mensaje, las normas y los roles a los que se avisa.

Una publicación con solo la línea Publicación abierta por enderwolf como primer mensaje, la descripción en una tarjeta verde debajo, luego el formulario enviado y la tarjeta de normas

En Discord: la misma publicación con el primer mensaje al estilo tarjeta: una línea, y la descripción en una tarjeta.

Bajo el panel, un mensaje que solo ve el miembro: Elige el tipo de consulta, con el menú abierto que muestra Error, Pregunta y Cuenta, y los botones Publicar sin etiqueta y Cancelar

En Discord: el paso para elegir el tipo de consulta, que solo ve el miembro.

Un mensaje que solo ve el miembro: Tu publicación está lista, con el enlace a la nueva publicación

En Discord: Petto responde con un enlace privado a la nueva publicación.

El primer mensaje de la publicación dice Publicación abierta por @miembro - título seguido de la descripción. Puedes cambiarlo con una plantilla que use {user}, {username}, {title}, {description}, {tag}, {server} y {forum}, o dejar solo la primera línea en el mensaje y la descripción en una tarjeta. Después vienen las respuestas a las otras preguntas, las imágenes y una tarjeta con tus normas y los roles a mencionar.
El texto habitual del panel dice, como otros bots, que no se pueden adjuntar imágenes al rellenar el formulario y que se pueden añadir cuando la publicación esté abierta. Si activas las imágenes en el formulario, el texto dice lo contrario. Puedes escribir tu propio texto o usar un diseño guardado (una tarjeta Components V2 hecha en el diseñador de embeds): el botón va debajo.

Etiquetas

  • Los miembros solo pueden elegir las etiquetas que permite la configuración (todas si no elegiste ninguna), nunca las que solo usan los moderadores ni la etiqueta Resuelto.
  • Una publicación puede tener hasta el número de etiquetas que permitas (de 1 a 5).
  • Si el propio foro exige una etiqueta, Petto la pide aunque la configuración no lo haga.
La tarjeta Etiquetas: etiqueta obligatoria apagada, dos etiquetas por publicación, Resuelto como etiqueta de resuelto y las casillas Error, Pregunta y Cuenta marcadas, Resuelto y Moderación sin marcar

Dashboard → Comunidad → Foros: qué etiquetas pueden elegir los miembros, cuántas puede tener una publicación y la etiqueta que significa resuelto.

Límites y bloqueos

Cada rechazo se muestra solo al miembro, en su idioma, con el motivo.
Bajo el panel, un mensaje que solo ve el miembro: Ya tienes 3 publicaciones abiertas (el máximo es 3), con enlaces a ellas, y Cierra o resuelve una antes de abrir otra

En Discord: un miembro que ya tiene tres publicaciones abiertas es rechazado, y solo él lo ve.

La tarjeta Quién puede hacer qué con los roles de staff Moderadores y Ayudantes, el rol bloqueado Silenciado, tres publicaciones abiertas por miembro, 30 segundos entre publicaciones y los tres interruptores del autor activados

Dashboard → Comunidad → Foros: los roles del staff, quién puede abrir publicaciones, los límites y lo que puede hacer el autor.

Comandos

Dentro de una publicación de foro funcionan las herramientas de abajo. Cada una responde con una tarjeta verde pequeña, por ejemplo @staff: Se bloqueó #publicación correctamente, con una mención silenciosa.
chu escribe !tl con un motivo y Petto responde con la tarjeta verde: chu, Bloqueada la publicación con éxito, y el motivo en letra pequeña

En Discord: !tl con un motivo bloquea la publicación.

chu escribe !tul y Petto responde con la tarjeta verde: desbloqueada la publicación con éxito

En Discord: !tul deja que los miembros escriban otra vez.

enderwolf escribe !forum close con un motivo y Petto responde con la tarjeta verde de publicación cerrada con éxito y el motivo

En Discord: el autor cierra su propia publicación; la tarjeta es el último mensaje.

kira escribe !forum reopen en una publicación cerrada y Petto responde con la tarjeta verde de publicación abierta otra vez con éxito

En Discord: una publicación cerrada se abre otra vez.

Después de que kira ayuda, enderwolf escribe !forum solved y Petto responde con la tarjeta verde de publicación marcada como resuelta y una nota de que se cerrará mañana

En Discord: el autor marca la publicación como resuelta; la tarjeta dice cuándo se cerrará.

enderwolf pide reabrir el tema y escribe !forum unsolved; Petto responde con la tarjeta verde que dice que la publicación ya no está resuelta

En Discord: la etiqueta Resuelto se quita.

enderwolf escribe !forum rename con un título nuevo y Petto responde con la tarjeta verde: el título de la publicación ahora es el nuevo, en negrita

En Discord: el autor cambia el título de su publicación.

shi escribe !forum tag add Error y luego !forum tag remove Pregunta; Petto responde a cada uno con una tarjeta verde

En Discord: se añade una etiqueta y se quita otra.

enderwolf escribe !forum tag list y Petto responde con una tarjeta que lista Error, Pregunta, Cuenta, Resuelto y Moderación (solo staff), con Pregunta en negrita porque la publicación la tiene

En Discord: las etiquetas del foro, con las de la publicación en negrita.

kira escribe !forum claim y Petto responde Se encarga kira; más tarde kira escribe !forum unclaim y Petto responde que ya no atiende la publicación

En Discord: un miembro del staff dice que se encarga de la publicación y luego la suelta.

kira escribe !forum list y Petto responde con la tarjeta Publicaciones del foro, mostrando Abiertas: cinco publicaciones con enlace, autor, estado y hora, y un menú para ver los otros estados

En Discord: las publicaciones abiertas de los foros, con su autor, estado y quién las atiende.

Con más de una configuración, añade --setup <nombre> a los comandos de configuración (también se encuentran por el foro en el que los escribes).

Quién puede usar las herramientas

  • El autor de una publicación puede cerrarla, marcarla como resuelta y cambiarle el título, solo en su propia publicación. Puedes apagar cada una (author-close, author-solve, author-rename).
  • Los roles de staff de la configuración y los miembros con Gestionar hilos pueden usar todas las herramientas en cualquier publicación.
  • Un miembro del staff que solo tiene un rol de staff no puede actuar sobre la publicación de un miembro cuyo rol más alto esté por encima del suyo (la misma regla que los comandos de moderación). Gestionar hilos no se frena por ella.
  • En un foro sin configuración, solo los miembros con Gestionar hilos pueden usar las herramientas, así que !tl funciona en cualquier foro para los moderadores.
  • Fuera de una publicación de foro, las herramientas responden que no es una publicación de foro. Petto comprueba sus propios permisos y dice cuál le falta.
enderwolf escribe !tl en su propia publicación y Petto responde con una tarjeta amarilla: Solo el staff de este foro puede hacer eso

En Discord: un miembro que no es staff no puede bloquear una publicación.

Mover un mensaje al foro

Responde a un mensaje (o indica su enlace o ID) y escribe !forum move. Petto crea una publicación en el foro con la tarjeta Mensaje original (lo que decía y quién lo escribió) y una nota de quién lo movió, y deja una respuesta bajo el mensaje que apunta a la publicación y menciona a su autor. El mensaje original no se borra. Añade el foro y un título si hace falta: !forum move #soporte No puedo entrar.
Nova pregunta por su tarjeta de nivel en #general, kira le responde con !forum move y un título, y Petto contesta bajo el mensaje que lo movió a la nueva publicación

En Discord: kira responde a un mensaje con !forum move; Petto contesta bajo el mensaje con el enlace a la nueva publicación.

La nueva publicación en el foro: el mensaje original de Nova, luego la tarjeta Mensaje original con quién lo escribió y dónde, la cita y quién lo movió

En Discord: la nueva publicación, con la tarjeta Mensaje original.

Ajustes de !forum set

max-open, cooldown, slowmode, require-tag, max-tags, images, adopt, tag-wait, inactive-days, inactive-action (lock o close), solved-action (none, lock o 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 o card), panel-title, panel-text, panel-footer, panel-image, panel-color, panel-design, button-label, button-emoji, button-style, modal-title, title-label y description-label. Usa none para borrar un texto o una lista. Las preguntas extra del formulario y los eventos del registro se configuran en el panel web.

Automatización

Un trabajo se ejecuta cada minuto y solo lee un índice de las publicaciones que toca, así que cuesta casi nada. Todo es opcional y está apagado por defecto.
  • Publicaciones sin actividad: inactive-days bloquea o cierra una publicación en la que nadie escribió durante esos días.
  • Publicaciones resueltas: solved-action y solved-delay bloquean o cierran una publicación pasado ese tiempo desde que se marcó como resuelta.
  • Publicaciones hechas a mano: con adopt activado, una publicación hecha en el foro sin el panel se guarda, recibe las normas y la mención al staff y puede usar las herramientas. Si require-tag está activado y la publicación no tiene etiqueta, Petto pide a su autor que elija una y cierra la publicación cuando pasan tag-wait minutos.
Un mensaje en una publicación guarda su última actividad como mucho una vez cada 5 minutos.
La tarjeta Automatización con las publicaciones sin actividad cerradas a los 7 días, las resueltas cerradas 24 horas después y el interruptor para conservar las hechas a mano con 10 minutos para elegir una etiqueta

Dashboard → Comunidad → Foros: publicaciones sin actividad, publicaciones resueltas y publicaciones hechas a mano.

Registro

La categoría de registro forums (!logs add #canal forums) avisa cuando se abre, bloquea, cierra o resuelve una publicación, quién lo hizo (o que lo hizo Petto solo) y por qué. Cada uno de los cuatro se puede apagar en el panel web, para cada configuración. Mira Registros.
La tarjeta Registro con los cuatro eventos marcados: publicaciones abiertas, bloqueadas, cerradas y resueltas

Dashboard → Comunidad → Foros: qué se cuenta en el registro de cada configuración.

Permisos que necesita Petto

En el canal de foro: Ver canal, Enviar mensajes (para crear publicaciones), Enviar mensajes en hilos y Gestionar hilos (para bloquear, cerrar y etiquetar). Crear hilos públicos, Adjuntar archivos (copiar las imágenes del formulario) y Gestionar canales (crear la etiqueta Resuelto) son opcionales. En el canal del panel: Ver canal y Enviar mensajes. !forum status lista lo que falta.

Solución de problemas

Da a Petto los permisos de arriba en el canal de foro (o en su categoría) y ejecuta !forum status otra vez.
Un foro tiene 20 etiquetas como máximo y Petto necesita Gestionar canales para añadir una. Añade tú una etiqueta llamada Resuelto, o elige otra etiqueta en el panel web.
El panel pertenece a una configuración que se apagó o se quitó, o el foro se borró. Ejecuta !forum status y luego !forum panel para publicarlo otra vez.
Úsalo dentro de una publicación de un foro. En un foro sin configuración necesitas Gestionar hilos.
chu escribe !tl en #general y Petto responde con una tarjeta amarilla: Esto no es una publicación de foro. Úsalo dentro de una publicación de un foro

En Discord: !tl escrito en un canal normal.

Mira inactive-days, solved-action y tag-wait en !forum status. La categoría de registro forums dice qué regla lo hizo.