Guide Tawqeet

Tout ce qu'il vous faut pour maîtriser le bot — de la première configuration aux fonctionnalités les plus fines. Une explication brève qui vous suffit, avec les détails qui vous attendent dès que vous en avez besoin.

Référence rapide des commandes

1.Introduction et démarrage rapide

En bref
Tawqeet est un bot pour gérer la présence et les sorties sur Discord. Pour commencer : ajoutez le bot, exécutez /setup configure une fois pour définir les canaux et les rôles, puis créez le panneau de présence avec /attendance pour que votre équipe commence à pointer d'un seul bouton. Tout le reste est disponible depuis les commandes ou depuis le tableau de bord sur le web.

Ce guide est organisé par tâche : chaque section regroupe tout ce qui concerne une tâche (commandes + paramètres du tableau de bord ensemble). Commencez par le haut si vous êtes nouveau, ou passez directement à la section qui vous intéresse depuis la liste des sections.

Premières étapes de configuration

  1. Ajoutez le bot à votre serveur et accordez-lui les permissions requises (gestion des rôles et des canaux).
  2. Exécutez /setup configure et définissez : le canal des journaux, le canal des rapports, le rôle d'administration et le rôle des membres.
  3. Créez le panneau de présence dans un canal approprié via /attendance.
  4. (Facultatif) Activez l'alerte, la pause et les points depuis les paramètres selon vos besoins.

Conseil

Vous pouvez gérer tous les paramètres plus tard, visuellement, depuis le tableau de bord sur le web au lieu de mémoriser les options de la commande — ouvrez /dashboard pour obtenir le lien direct vers votre serveur.

2.Suivi de présence

En bref
L'administrateur crée un panneau de boutons via /attendance. Le membre clique sur Pointer pour démarrer son temps et Sortir pour l'arrêter — et chaque session est enregistrée automatiquement dans le canal des journaux. L'administrateur voit qui est présent en temps réel avec /activesessions, et intervient manuellement avec /forcecheckin et /forcecheckout. Pour les pauses, il y a un bouton AFK facultatif, et une alerte qui rappelle à celui qui a oublié de pointer sa sortie.

C'est le cœur du bot. L'idée est simple : une session commence au pointage d'entrée et se termine au pointage de sortie, et sa durée est le temps comptabilisé du membre. Tout ce qui suit tourne autour de la création et de la gestion de ces sessions.

Panneau de présence (pour les membres)

L'administrateur le crée une fois dans un canal que les membres peuvent voir. Il contient des boutons que le membre clique directement sans taper aucune commande :

⏰ Panneau de présence

Utilisez les boutons ci-dessous pour pointer votre entrée ou votre sortie :

Pointer

Commencez à enregistrer votre temps

Sortir

Arrêtez l'enregistrement de votre temps

Voir mes heures

Vos heures du jour et la durée de votre session

Pause (AFK) 💤

Commencez ou terminez votre pause

Une simulation du panneau de présence tel qu'il apparaît dans Discord après la commande /attendance

  • 📝 Pointer : démarre une nouvelle session. Vous ne pouvez pas avoir deux sessions ouvertes en même temps.
  • 👋 Sortir : termine la session en cours et comptabilise sa durée (et attribue des points si le système est activé).
  • ⏱️ Voir mes heures : affiche au membre un résumé de ses heures du jour et la durée de sa session en cours si elle est active.
  • 💤 Pause (AFK) : n'apparaît que si vous avez activé la fonction de pause — elle met en pause le comptage du temps temporairement.
/attendanceAdmin

Crée le panneau de boutons de présence dans le canal actuel. Utilisé une seule fois en général.

Utilisation/attendance
Exemple/attendance

Note

Chaque entrée ou sortie est enregistrée automatiquement dans le canal des journaux que vous avez défini lors de la configuration — avec le nom du membre, les heures d'entrée et de sortie, la durée totale, et la durée des pauses et les points le cas échéant.

Suivi en direct des présents (pour les administrateurs)

La commande /activesessions affiche une liste à jour de tous ceux qui ont pointé et ne sont pas encore partis, avec la durée de présence de chacun et un bouton d'actualisation :

🟢 Liste des administrateurs présents

Administrateurs présents : 3

Dernière mise à jour ⏰ : 14:14

1. Khalid @khalid

🕓 entrée : 10:02

⏱️ temps de présence : 3h 12m

2. Sara @sara_a

🕓 entrée : 10:18

⏱️ temps de présence : 2h 56m

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

🕓 entrée : 11:30

⏱️ temps de présence : 1h 44m

Une simulation de la liste de présence en direct de la commande /activesessions

/activesessionsAdmin

Affiche la liste des membres actuellement présents avec la durée de présence de chacun. Ceux en pause (AFK) apparaissent en bas de la liste avec une étiquette indiquant la durée de leur pause.

Utilisation/activesessions [style?]
Exemple/activesessions

Intervention manuelle (pour les administrateurs)

Parfois un membre oublie de pointer, ou vous devez corriger une session. Ces commandes vous donnent un contrôle total :

/forcecheckinAdmin

Force un pointage d'entrée pour un membre qui a oublié d'appuyer sur le bouton.

Utilisation/forcecheckin [member] [reason?]
/forcecheckoutAdmin

Force un pointage de sortie pour un membre précis, ou pour tout le monde d'un coup.

Utilisation/forcecheckout [member?]

Conseil

Pour ajuster la durée d'une session précédente (ajouter/retirer du temps) au lieu d'ouvrir une nouvelle session, utilisez /modifytime — vous trouverez son explication complète dans la section « Administration avancée ».

Pause (AFK) et alerte

Deux fonctions facultatives activées depuis la configuration pour rendre le comptage du temps plus équitable :

  • Pause (AFK) : le membre appuie sur le bouton de pause, le comptage de son temps est alors mis en pause temporairement, et il appuie à nouveau pour reprendre. Si la pause dépasse le maximum (par défaut 15 minutes), il est pointé en sortie automatiquement.
  • L'alerte : rappelle à celui dont la session dépasse une durée définie (par défaut 12 heures) par un message dans le canal des journaux et un rappel privé au membre — au cas où il aurait oublié de pointer sa sortie.

Conseil

Activer l'alerte et la pause et régler leurs durées est disponible visuellement depuis la page Paramètres du tableau de bord (les sections « Système d'alertes » et « Système de pause AFK ») — avec des interrupteurs et des champs de durée, sans commandes.

À vérifier

Les valeurs par défaut ci-dessus (pause 15 minutes, alerte 12 heures) sont tirées des paramètres actuels du bot, et toutes sont modifiables depuis /setup configure ou depuis le tableau de bord.

Depuis le tableau de bord

Tout ce qui précède est aussi disponible depuis le tableau de bord sur le web sans commandes. Depuis la page Paramètres, vous pouvez définir le canal d'affichage de la liste des sessions actives en direct et le style de son message (texte ou Embed) — et le bot publie alors un message qui se met à jour automatiquement avec qui est présent maintenant :

Tableau de bord — Paramètres
# présence-en-direct

Le canal où la liste des sessions en direct apparaîtra et se mettra à jour automatiquement.

Style du message des sessions actives

Message texteEmbed

La section « Canal des sessions actives » dans la page Paramètres du tableau de bord

Conseil

Après avoir choisi le canal et enregistré, le bot publie le message immédiatement et le met à jour automatiquement. Si le message est supprimé manuellement de Discord, il suffit d'enregistrer à nouveau les paramètres pour le republier.

3.Points et motivation

En bref
Un système facultatif qui convertit les heures de présence en points incitatifs. Activez-le avec /points setup, après quoi les membres gagnent des points automatiquement à chaque sortie. Le membre voit son solde avec /points balance et le classement avec /points leaderboard. Et l'administrateur a un contrôle total : paliers, multiplicateur d'heures de pointe et gestion manuelle — depuis la commande ou depuis le tableau de bord.

Comment les points sont calculés

La base est simple : un taux de base par heure de présence (par défaut un point par heure). Au-dessus, deux couches facultatives :

  • Paliers (Tiers) : des taux différents selon le total des heures — pour récompenser les plus présents.
  • Multiplicateur d'heures de pointe (Bonus) : multiplier les points pendant une période donnée pour encourager la présence à ce moment-là.

Note

Les points sont calculés automatiquement au pointage de sortie selon la durée de la session. Si le système n'est pas activé, aucun point n'est attribué et le suivi de présence n'est pas affecté.

Commandes des membres

🏆 Classement des points

1. Khalid: 1240.00 💎

2. Sara: 980.00 💎

3. Ahmed: 845.00 💎

4. Noura: 612.00 💎

Une simulation du classement des points de la commande /points leaderboard

/points balance

Affiche votre solde de points (ou celui d'un autre membre si vous le précisez).

Utilisation/points balance [user?]
/points leaderboard

Affiche le classement des points du serveur.

Utilisation/points leaderboard

Gestion des points (administrateurs)

/points setupAdmin

Active le système de points avec les paramètres par défaut (un point par heure).

Utilisation/points setup
/points configureAdmin

Panneau de contrôle avancé : les paliers, le multiplicateur et le taux de base.

Utilisation/points configure
/points manageAdmin

Ajouter ou retirer des points manuellement à un membre précis.

Utilisation/points manage [action] [user] [amount]
/points resetAdmin

Réinitialiser les points d'un membre précis ou de tous les membres.

Utilisation/points reset [target] [user?]

Depuis le tableau de bord

Vous pouvez gérer tous les paramètres de points visuellement depuis la page Paramètres : activer le système, régler le taux de base, ajouter des paliers et définir la période du multiplicateur de pointe — sans enregistrer aucune syntaxe de commande.

Tableau de bord — Paramètres
Activer le système de points
1.0

Palier : +40 heures

Taux multiplié : ×1.5 point par heure

La section « Système de points » dans la page Paramètres du tableau de bord

4.Rapports et analyses

En bref
Vous extrayez des rapports de présence quotidiens, hebdomadaires et mensuels et par membre, avec la possibilité de les exporter vers Excel. Et vous pouvez programmer des rapports automatiques par rôle avec /autoreport. Quant au tableau de bord, il vous offre des analyses visuelles : heures de pointe, tendances et comparaison des membres.

Rapports à la demande

Chaque rapport est envoyé au canal des rapports et accepte une option export pour l'exporter sous forme de fichier Excel formaté avec un graphique :

/dailyreportAdmin

Rapport de présence quotidien. Permet de choisir un jour parmi les 7 derniers jours et de filtrer par rôle.

Utilisation/dailyreport [role?] [date?] [export?]
/weeklyreportAdmin

Rapport de présence hebdomadaire avec un résumé statistique.

Utilisation/weeklyreport [role?] [week?] [export?]
/monthlyreportAdmin

Rapport de présence mensuel complet.

Utilisation/monthlyreport [role?] [month?] [export?]
/memberreportAdmin

Rapport détaillé pour un seul membre sur une période donnée.

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

Conseil

/leaderboard affiche le classement des membres par total d'heures de présence, avec une ligne de résumé (nombre, total, moyenne) et la possibilité de l'exporter vers Excel.

Rapports automatiques

Au lieu d'extraire le rapport manuellement chaque jour, liez un rôle à un canal et son rapport quotidien est envoyé automatiquement à minuit (dans le fuseau horaire de votre serveur) :

/autoreport addAdmin

Activer un rapport quotidien automatique pour un rôle précis dans un canal choisi.

Utilisation/autoreport add [role] [channel]
/autoreport listAdmin

Afficher tous les rapports automatiques activés, et supprimer ceux que vous voulez.

Utilisation/autoreport list

Analyses et comparaison (tableau de bord)

La page Analyses transforme vos données en visuels : heures totales et moyennes, heures de pointe et la tendance de présence au fil du temps. Et la page Comparaison place plusieurs membres côte à côte :

Tableau de bord — Analyses
1,284
Heures totales
32.1
Moyenne par membre
18
Pic le plus élevé

Une capture illustrative de la page Analyses du tableau de bord

5.Administration avancée

En bref
Des outils pour les cas particuliers : /modifytime pour ajuster les heures d'un membre (ajouter/retirer), /reset pour réinitialiser les enregistrements, et des commandes pour gérer les rôles d'administration qui déterminent qui peut utiliser les commandes d'administrateur. Et vous pouvez changer l'apparence du bot lui-même avec /editbotprofile. L'ajustement du temps et la réinitialisation sont aussi disponibles visuellement depuis le tableau de bord.

Ajustement du temps et réinitialisation

Pour corriger les heures d'un membre sans ouvrir de session, ou pour réinitialiser ses enregistrements :

/modifytimeAdmin

Ajoute ou retire du temps des heures d'un membre, avec le motif enregistré.

Utilisation/modifytime [member] [duration] [reason?]
Exemple/modifytime member:@Ahmed duration:+2h30m
/resetAdmin

Réinitialise les heures d'un membre précis ou de tous les membres.

Utilisation/reset [member?]

Les deux mêmes opérations sont disponibles visuellement depuis la page Ajustement du temps du tableau de bord :

Tableau de bord — Ajustement du temps
🔍 Recherchez un membre par nom ou surnom…
+ Ajouter du temps− Retirer du temps
2
heures
30
minutes

La page « Ajustement du temps » du tableau de bord — recherchez un membre puis ajoutez/retirez

Rôles d'administration

Définit quels rôles sont autorisés à utiliser les commandes d'administrateur (en plus du rôle de base dans la configuration). Ceux qui ont la permission Administrator ou le propriétaire du serveur ont toujours un accès complet.

/addadminroleAdmin

Ajouter un rôle d'administration.

Utilisation/addadminrole [role]
/removeadminroleAdmin

Retirer un rôle d'administration.

Utilisation/removeadminrole [role]
/listadminrolesAdmin

Afficher les rôles d'administration ajoutés.

Utilisation/listadminroles

Conseil

Les rôles d'administration (de base et supplémentaires), en plus du fuseau horaire et de la couleur d'accent du panneau, se règlent aussi depuis la page Paramètres du tableau de bord.

Personnalisation du bot

/editbotprofileAdmin

Changez le nom et l'avatar du bot dans votre serveur pour correspondre à son identité. Cela peut aussi se faire depuis la page « Personnalisation du bot » du tableau de bord.

Utilisation/editbotprofile

6.Assistant IA

En bref
Un assistant propulsé par l'IA qui répond à vos questions sur la présence de votre équipe en langage naturel — « Qui a été le plus présent cette semaine ? » — analyse les données et vous donne la réponse. Disponible depuis la page Assistant IA du tableau de bord.

Ce qu'il fait

Au lieu d'extraire un rapport et de le lire manuellement, vous posez à l'assistant une question directe et il lit les données de présence de votre serveur et répond : résumés, comparaisons, heures de pointe, prévisions, et qui était absent ou en retard. Toutes les réponses sont basées sur vos données réelles.

Comment l'utiliser

Tableau de bord — Assistant IA
Qui sont les trois membres les plus présents cette semaine ?
✦Les plus élevés cette semaine : Khalid (28 heures), Sara (24), puis Ahmed (21).

Une capture illustrative de la page Assistant IA du tableau de bord

Note

L'assistant est un outil analytique d'aide — pour les chiffres officiels et précis, référez-vous toujours aux rapports. Il y a aussi une limite d'utilisation quotidienne par utilisateur.

Vous êtes arrivé à la fin 🎉

Pour une référence rapide de chaque commande, consultez la page des commandes. Et pour toute question, l'équipe de support est prête sur Discord.