Logo de ZynxFoxZynxFox

Tickets

El módulo de tickets permite abrir canales privados de soporte dentro del servidor, asignar roles de atención, enviar un panel público de apertura y registrar eventos importantes del flujo.

Qué hace este módulo

Cuando está configurado, ZynxFox publica un menú con botón de apertura y crea un ticket privado cuando un usuario lo usa. Desde ahí el staff puede atender el caso y, si así lo definiste, registrar eventos de creación, reclamo, cierre o eliminación.

Qué conviene definir primero

Antes de enviar el menú, deja cerrados estos puntos:

  1. Canal donde irá el menú de tickets.
  2. Categoría donde se crearán los tickets.
  3. Roles de soporte que tendrán acceso.
  4. Canal de logs si quieres registrar eventos del sistema.
  5. Si usarás recordatorios para tickets inactivos y cada cuántas horas.

Ruta de configuración

La configuración parte desde /config. Dentro del módulo de tickets, el bot ya separa la gestión en bloques claros:

  • Estado: activar o desactivar el sistema.
  • Mensajes: mensaje del panel de apertura y mensaje de bienvenida dentro del ticket.
  • Menú: canal del panel, categoría de tickets y roles de soporte.
  • Registros: canal de logs y eventos a registrar.
  • Notificaciones: recordatorios para tickets inactivos.

Paso a paso recomendado

  1. Activa el módulo de tickets.
  2. Define el canal donde se publicará el menú.
  3. Selecciona la categoría donde se crearán los canales de soporte.
  4. Configura los roles de soporte que deben ver y atender tickets.
  5. Personaliza el mensaje del panel y el mensaje de bienvenida.
  6. Si quieres trazabilidad, define el canal de logs y marca los eventos que quieres guardar.
  7. Envía el menú de tickets y prueba la apertura con una cuenta real.

Eventos de logs disponibles

El sistema puede registrar estos eventos cuando el canal de logs está configurado:

  • Creación del ticket.
  • Reclamo por parte del staff.
  • Cierre.
  • Eliminación con transcripción.

Importante

Si activas logs de eliminación, el sistema puede generar transcripciones del ticket. No uses este módulo para compartir información sensible que no deba quedar registrada en Discord o en los registros del servidor.

Recordatorios de inactividad

Los recordatorios son opcionales. Si los activas, puedes definir un intervalo entre 1 y 168 horas. Esto sirve para no dejar tickets olvidados cuando el staff tarda en responder o cerrar un caso.

Errores comunes

  • El menú se envía, pero nadie puede abrir tickets porque el sistema sigue desactivado.
  • El ticket se crea sin visibilidad para el staff porque faltan roles de soporte.
  • El panel no se puede enviar porque el bot no tiene permisos para escribir o insertar enlaces en el canal.
  • Los logs no llegan porque no se definió un canal o no se marcaron eventos.
  • Los recordatorios no funcionan como esperabas porque el sistema o los recordatorios siguen desactivados.

Uso recomendado

Monta primero la estructura mínima: estado, canal, categoría y roles. Después ajusta mensajes, logs y recordatorios. Así confirmas rápido que el flujo principal ya está funcionando antes de pulir detalles.

Siguiente paso

Si ya dejaste tickets funcionando, lo normal es continuar con Moderación o volver al resumen de módulos para activar el siguiente sistema importante del servidor.