Guía de Tawqeet

Todo lo que necesita para dominar el bot, desde la primera configuración hasta las funciones más detalladas. Una explicación breve que le basta, con los detalles esperándole cuando los necesite.

Referencia rápida de comandos

1.Introducción e inicio rápido

En resumen
Tawqeet es un bot para gestionar la asistencia y las salidas en Discord. Para empezar: añada el bot, ejecute /setup configure una vez para definir los canales y roles, y cree el panel de asistencia con /attendance para que su equipo empiece a registrar con un solo botón. Todo lo demás está disponible desde los comandos o desde el panel en la web.

Esta guía está organizada por tarea: cada sección reúne todo lo relacionado con una tarea (comandos + ajustes del panel juntos). Empiece desde arriba si es nuevo, o salte directamente a la sección que le interese desde la lista de secciones.

Primeros pasos de configuración

  1. Añada el bot a su servidor y concédale los permisos necesarios (gestionar roles y canales).
  2. Ejecute /setup configure y defina: el canal de registros, el canal de informes, el rol de administración y el rol de miembros.
  3. Cree el panel de asistencia en un canal adecuado mediante /attendance.
  4. (Opcional) Active la alerta, el descanso y los puntos desde los ajustes según necesite.

Consejo

Puede gestionar todos los ajustes más tarde, de forma visual, desde el panel en la web en lugar de recordar las opciones del comando — abra /dashboard para obtener el enlace directo a su servidor.

2.Seguimiento de asistencia

En resumen
El administrador crea un panel de botones con /attendance. El miembro pulsa Entrada para iniciar su tiempo y Salida para detenerlo, y cada sesión se registra automáticamente en el canal de registros. El administrador ve quién está presente en tiempo real con /activesessions, e interviene manualmente con /forcecheckin y /forcecheckout. Para los descansos hay un botón AFK opcional, y una alerta que recuerda a quien olvidó registrar su salida.

Este es el corazón del bot. La idea es simple: una sesión comienza al fichar la entrada y termina al fichar la salida, y su duración es el tiempo contabilizado del miembro. Todo lo que sigue gira en torno a crear y gestionar estas sesiones.

Panel de asistencia (para miembros)

El administrador lo crea una vez en un canal que los miembros puedan ver. Tiene botones que el miembro pulsa directamente sin escribir ningún comando:

⏰ Panel de asistencia

Use los botones de abajo para registrar su entrada o salida:

Entrada

Empiece a registrar su tiempo

Salida

Detenga el registro de su tiempo

Ver mis horas

Sus horas de hoy y la duración de su sesión

Descanso (AFK) 💤

Inicie o finalice su descanso

Una simulación del panel de asistencia tal como aparece en Discord tras el comando /attendance

  • 📝 Entrada: inicia una nueva sesión. No se pueden tener dos sesiones abiertas a la vez.
  • 👋 Salida: finaliza la sesión actual y cuenta su duración (y otorga puntos si el sistema está activado).
  • ⏱️ Ver mis horas: muestra al miembro un resumen de sus horas de hoy y la duración de su sesión actual si está activa.
  • 💤 Descanso (AFK): aparece solo si activó la función de descanso — pausa el conteo del tiempo temporalmente.
/attendanceAdministrador

Crea el panel de botones de asistencia en el canal actual. Normalmente se usa una vez.

Uso/attendance
Ejemplo/attendance

Nota

Cada entrada o salida se registra automáticamente en el canal de registros que definió en la configuración — con el nombre del miembro, las horas de entrada y salida, la duración total, y la duración de los descansos y los puntos si los hay.

Seguimiento en vivo de presentes (para administradores)

El comando /activesessions muestra una lista actualizada de todos los que han fichado y aún no han salido, con la duración de presencia de cada persona y un botón de actualización:

🟢 Lista de administradores presentes

Administradores presentes: 3

Última actualización ⏰: 14:14

1. Khalid @khalid

🕓 entrada: 10:02

⏱️ tiempo presente: 3h 12m

2. Sara @sara_a

🕓 entrada: 10:18

⏱️ tiempo presente: 2h 56m

3. Ahmed @ahmed 💤 en descanso (12m)

🕓 entrada: 11:30

⏱️ tiempo presente: 1h 44m

Una simulación de la lista de asistencia en directo del comando /activesessions

/activesessionsAdministrador

Muestra la lista de miembros presentes actualmente con la duración de presencia de cada uno. Los que están en descanso (AFK) aparecen al final de la lista con una etiqueta que indica la duración de su descanso.

Uso/activesessions [style?]
Ejemplo/activesessions

Intervención manual (para administradores)

A veces un miembro olvida fichar, o necesita corregir una sesión. Estos comandos le dan control total:

/forcecheckinAdministrador

Fuerza una entrada para un miembro que olvidó pulsar el botón.

Uso/forcecheckin [member] [reason?]
/forcecheckoutAdministrador

Fuerza una salida para un miembro concreto, o para todos a la vez.

Uso/forcecheckout [member?]

Consejo

Para ajustar la duración de una sesión anterior (añadir/restar tiempo) en lugar de abrir una nueva sesión, use /modifytime — encontrará su explicación completa en la sección «Administración avanzada».

Descanso (AFK) y la alerta

Dos funciones opcionales que se activan desde la configuración para que el conteo del tiempo sea más justo:

  • Descanso (AFK): el miembro pulsa el botón de descanso y el conteo de su tiempo se pausa temporalmente, y lo pulsa de nuevo para reanudarlo. Si el descanso supera el máximo (por defecto 15 minutos) se le ficha la salida automáticamente.
  • La alerta: recuerda a quien su sesión supera una duración determinada (por defecto 12 horas) con un mensaje en el canal de registros y un recordatorio privado al miembro — por si olvidó fichar la salida.

Consejo

Activar la alerta y el descanso y ajustar sus duraciones está disponible visualmente desde la página de Ajustes del panel (las secciones «Sistema de alertas» y «Sistema de descanso AFK») — con interruptores y campos de duración, sin comandos.

Para revisar

Los valores por defecto anteriores (descanso 15 minutos, alerta 12 horas) están tomados de la configuración actual del bot, y todos son modificables desde /setup configure o desde el panel.

Desde el panel

Todo lo anterior también está disponible desde el panel en la web sin comandos. Desde la página de Ajustes puede definir el canal donde se muestra la lista de sesiones activas en directo y el estilo de su mensaje (texto o Embed) — y entonces el bot publica un mensaje que se actualiza automáticamente con quién está presente ahora:

Panel — Ajustes
# asistencia-en-directo

El canal donde aparecerá la lista de sesiones en directo y se actualizará automáticamente.

Estilo del mensaje de sesiones activas

Mensaje de textoEmbed

La sección «Canal de sesiones activas» en la página de Ajustes del panel

Consejo

Tras elegir el canal y guardar, el bot publica el mensaje de inmediato y lo actualiza automáticamente. Si el mensaje se elimina manualmente de Discord, basta con guardar los ajustes de nuevo para volver a publicarlo.

3.Puntos y motivación

En resumen
Un sistema opcional que convierte las horas de asistencia en puntos de incentivo. Actívelo con /points setup, y después los miembros ganan puntos automáticamente en cada salida. El miembro ve su saldo con /points balance y la clasificación con /points leaderboard. Y el administrador tiene control total: tramos, un multiplicador de horas pico y gestión manual — desde el comando o desde el panel.

Cómo se calculan los puntos

La base es simple: una tarifa base por hora de asistencia (por defecto un punto por hora). Encima, dos capas opcionales:

  • Tramos (Tiers): tarifas diferentes según el total de horas — para premiar a los más presentes.
  • Multiplicador de horas pico (Bonus): multiplicar los puntos durante un periodo determinado para fomentar la asistencia en él.

Nota

Los puntos se calculan automáticamente al fichar la salida según la duración de la sesión. Si el sistema no está activado, no se otorgan puntos y el control de asistencia no se ve afectado.

Comandos de los miembros

🏆 Clasificación de puntos

1. Khalid: 1240.00 💎

2. Sara: 980.00 💎

3. Ahmed: 845.00 💎

4. Noura: 612.00 💎

Una simulación de la clasificación de puntos del comando /points leaderboard

/points balance

Muestra su saldo de puntos (o el de otro miembro si lo indica).

Uso/points balance [user?]
/points leaderboard

Muestra la clasificación de puntos del servidor.

Uso/points leaderboard

Gestión de puntos (administradores)

/points setupAdministrador

Activa el sistema de puntos con los ajustes por defecto (un punto por hora).

Uso/points setup
/points configureAdministrador

Panel de control avanzado: los tramos, el multiplicador y la tarifa base.

Uso/points configure
/points manageAdministrador

Añadir o restar puntos manualmente a un miembro concreto.

Uso/points manage [action] [user] [amount]
/points resetAdministrador

Restablecer los puntos de un miembro concreto o de todos.

Uso/points reset [target] [user?]

Desde el panel

Puede gestionar todos los ajustes de puntos visualmente desde la página de Ajustes: activar el sistema, definir la tarifa base, añadir tramos y definir el periodo del multiplicador pico — sin guardar ninguna sintaxis de comando.

Panel — Ajustes
Activar el sistema de puntos
1.0

Tramo: +40 horas

Tarifa multiplicada: ×1.5 puntos por hora

La sección «Sistema de puntos» en la página de Ajustes del panel

4.Informes y análisis

En resumen
Extrae informes de asistencia diarios, semanales y mensuales y por miembro, con la opción de exportarlos a Excel. Y puede programar informes automáticos por rol con /autoreport. En cuanto al panel, le ofrece análisis visuales: horas pico, tendencias y comparación de miembros.

Informes bajo demanda

Cada informe se envía al canal de informes y acepta una opción export para exportarlo como un archivo Excel con formato y un gráfico:

/dailyreportAdministrador

Informe de asistencia diario. Acepta elegir un día de los últimos 7 días y filtrar por rol.

Uso/dailyreport [role?] [date?] [export?]
/weeklyreportAdministrador

Informe de asistencia semanal con un resumen estadístico.

Uso/weeklyreport [role?] [week?] [export?]
/monthlyreportAdministrador

Informe de asistencia mensual completo.

Uso/monthlyreport [role?] [month?] [export?]
/memberreportAdministrador

Informe detallado de un solo miembro durante un periodo determinado.

Uso/memberreport [member] [period] [export?]

Consejo

/leaderboard muestra la clasificación de los miembros por horas totales de asistencia, con una línea de resumen (recuento, total, promedio) y la opción de exportarla a Excel.

Informes automáticos

En lugar de extraer el informe manualmente cada día, vincule un rol a un canal y su informe diario se enviará automáticamente a medianoche (en la zona horaria de su servidor):

/autoreport addAdministrador

Activar un informe diario automático para un rol concreto en un canal elegido.

Uso/autoreport add [role] [channel]
/autoreport listAdministrador

Mostrar todos los informes automáticos activados, y eliminar los que desee.

Uso/autoreport list

Análisis y comparación (panel)

La página de Análisis convierte sus datos en elementos visuales: horas totales y promedios, horas pico y la tendencia de asistencia a lo largo del tiempo. Y la página de Comparación pone a varios miembros uno al lado del otro:

Panel — Análisis
1,284
Horas totales
32.1
Promedio por miembro
18
Pico más alto

Una captura ilustrativa de la página de Análisis del panel

5.Administración avanzada

En resumen
Herramientas para casos especiales: /modifytime para ajustar las horas de un miembro (añadir/restar), /reset para restablecer los registros, y comandos para gestionar los roles de administración que determinan quién puede usar los comandos de administrador. Y puede cambiar la apariencia del propio bot con /editbotprofile. El ajuste de tiempo y el restablecimiento también están disponibles visualmente desde el panel.

Ajuste de tiempo y reinicio

Para corregir las horas de un miembro sin abrir una sesión, o para restablecer sus registros:

/modifytimeAdministrador

Añade o resta tiempo de las horas de un miembro, con el motivo registrado.

Uso/modifytime [member] [duration] [reason?]
Ejemplo/modifytime member:@Ahmed duration:+2h30m
/resetAdministrador

Restablece las horas de un miembro concreto o de todos los miembros.

Uso/reset [member?]

Las mismas dos operaciones están disponibles visualmente desde la página de Ajuste de tiempo del panel:

Panel — Ajuste de tiempo
🔍 Busque un miembro por nombre o apodo…
+ Añadir tiempo− Restar tiempo
2
horas
30
minutos

La página «Ajuste de tiempo» del panel — busque un miembro y luego añada/reste

Roles de administración

Define qué roles pueden usar los comandos de administrador (además del rol base de la configuración). Quienes tienen el permiso Administrator o el propietario del servidor siempre tienen acceso completo.

/addadminroleAdministrador

Añadir un rol de administración.

Uso/addadminrole [role]
/removeadminroleAdministrador

Quitar un rol de administración.

Uso/removeadminrole [role]
/listadminrolesAdministrador

Mostrar los roles de administración añadidos.

Uso/listadminroles

Consejo

Los roles de administración (base y adicionales), además de la zona horaria y el color de acento del panel, también se configuran desde la página de Ajustes del panel.

Personalización del bot

/editbotprofileAdministrador

Cambie el nombre y el avatar del bot dentro de su servidor para que coincidan con su identidad. Esto también puede hacerse desde la página «Personalización del bot» del panel.

Uso/editbotprofile

6.Asistente inteligente

En resumen
Un asistente impulsado por IA que responde a sus preguntas sobre la asistencia de su equipo en lenguaje natural — «¿Quién asistió más esta semana?» — analiza los datos y le da la respuesta. Disponible desde la página del Asistente inteligente del panel.

Qué hace

En lugar de extraer un informe y leerlo manualmente, le hace al asistente una pregunta directa y este lee los datos de asistencia de su servidor y responde: resúmenes, comparaciones, horas pico, previsiones y quién faltó o llegó tarde. Todas las respuestas se basan en sus datos reales.

Cómo usarlo

Panel — Asistente inteligente
¿Quiénes son los tres miembros con más asistencia esta semana?
✦Los más altos esta semana: Khalid (28 horas), Sara (24), luego Ahmed (21).

Una captura ilustrativa de la página del Asistente inteligente del panel

Nota

El asistente es una herramienta analítica de ayuda — para cifras oficiales y precisas, consulte siempre los informes. También hay un límite de uso diario por usuario.

Llegó al final 🎉

Para una referencia rápida de cada comando, visite la página de comandos. Y para cualquier pregunta, el equipo de soporte está listo en Discord.