Tawqeet guide

Everything you need to master the bot — from first setup to the finest features. A brief explanation that's enough for you, with details waiting whenever you need them.

Quick command reference

1.Introduction & quick start

In short
Tawqeet is a bot for managing attendance and check-out in Discord. To start: add the bot, run /setup configure once to define the channels and roles, then create the attendance panel with /attendance so your team can start logging with one button. Everything after that is available from the commands or from the dashboard on the web.

This guide is organized by task: each section gathers everything related to one task (commands + dashboard settings together). Start from the top if you're new, or jump straight to the section that matters to you from the sections list.

First setup steps

  1. Add the bot to your server and grant it the required permissions (managing roles and channels).
  2. Run /setup configure and define: the log channel, the reports channel, the admin role, and the member role.
  3. Create the attendance panel in a suitable channel via /attendance.
  4. (Optional) Enable the alert, the break, and points from the settings as you need.

Tip

You can manage all settings later, visually, from the dashboard on the web instead of remembering command options — open /dashboard to get the direct link to your server.

2.Attendance tracking

In short
The admin creates a button panel via /attendance. A member clicks Check in to start their time and Check out to stop it — and every session is logged in the log channel automatically. The admin sees who's present in real time with /activesessions, and intervenes manually with /forcecheckin and /forcecheckout. For breaks there's an optional AFK button, and an alert that reminds anyone who forgot to check out.

This is the heart of the bot. The idea is simple: a session starts at check-in and ends at check-out, and its duration is the member's counted time. Everything that follows revolves around creating and managing these sessions.

Attendance panel (for members)

The admin creates it once in a channel members can see. It has buttons a member clicks directly without typing any command:

⏰ Attendance panel

Use the buttons below to check in or check out:

Check in

Start tracking your time

Check out

Stop tracking your time

View my hours

Your hours today and your session duration

Break (AFK) 💤

Start or end your break

A simulation of the attendance panel as it appears in Discord after the /attendance command

  • 📝 Check in: starts a new session. You can't have two sessions open at once.
  • 👋 Check out: ends the current session and counts its duration (and awards points if the system is enabled).
  • ⏱️ View my hours: shows the member a summary of their hours today and their current session's duration if active.
  • 💤 Break (AFK): appears only if you enabled the break feature — it pauses time counting temporarily.
/attendanceAdmin

Creates the attendance button panel in the current channel. Usually used once.

Usage/attendance
Example/attendance

Note

Every check-in or check-out is logged automatically in the log channel you set during setup — with the member's name, check-in and check-out times, total duration, and break durations and points if any.

Live presence monitoring (for admins)

The /activesessions command shows an updated list of everyone who has checked in and not yet left, with each person's presence duration and a refresh button:

🟢 List of present admins

Admins present: 3

Last updated ⏰: 2:14 PM

1. Khalid @khalid

🕓 checked in: 10:02 AM

⏱️ presence time: 3h 12m

2. Sara @sara_a

🕓 checked in: 10:18 AM

⏱️ presence time: 2h 56m

3. Ahmed @ahmed 💤 on break (12m)

🕓 checked in: 11:30 AM

⏱️ presence time: 1h 44m

A simulation of the live attendance list from the /activesessions command

/activesessionsAdmin

Shows the list of members currently present with each one's presence duration. Those on break (AFK) appear at the bottom of the list with a tag showing their break duration.

Usage/activesessions [style?]
Example/activesessions

Manual intervention (for admins)

Sometimes a member forgets to check in, or you need to correct a session. These commands give you full control:

/forcecheckinAdmin

Forces a check-in for a member who forgot to press the button.

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

Forces a check-out for a specific member, or for everyone at once.

Usage/forcecheckout [member?]

Tip

To adjust the duration of a previous session (add/subtract time) instead of opening a new session, use /modifytime — you'll find its full explanation in the «Advanced administration» section.

Break (AFK) and the alert

Two optional features enabled from setup to make time counting fairer:

  • Break (AFK): the member presses the break button so their time counting pauses temporarily, and presses it again to resume. If the break exceeds the maximum (by default 15 minutes) they're checked out automatically.
  • The alert: reminds anyone whose session exceeds a set duration (by default 12 hours) with a message in the log channel and a private reminder to the member — in case they forgot to check out.

Tip

Enabling the alert and the break and setting their durations is available visually from the Settings page in the dashboard (the «Alerts system» and «AFK break system» sections) — with toggles and duration fields, no commands.

To review

The default values above (break 15 minutes, alert 12 hours) are taken from the bot's current settings, and they're all changeable from /setup configure or from the dashboard.

From the dashboard

Everything above is also available from the dashboard on the web without commands. From the Settings page you can set the channel to display the live active sessions list and its message style (text or Embed) — and then the bot posts a message that updates automatically with who's present now:

Dashboard — Settings
# live-attendance

The channel where the live sessions list will appear and update automatically.

Active sessions message style

Text messageEmbed

The «Active sessions channel» section in the Settings page of the dashboard

Tip

After choosing the channel and saving, the bot posts the message immediately and updates it automatically. If the message is deleted manually from Discord, just save the settings again to repost it.

3.Points & motivation

In short
An optional system that turns attendance hours into incentive points. Enable it with /points setup, after which members earn points automatically at every check-out. A member sees their balance with /points balance and the leaderboard with /points leaderboard. And the admin has full control: tiers, a peak-time multiplier, and manual management — from the command or from the dashboard.

How points are calculated

The basics are simple: a base rate per attendance hour (by default one point per hour). On top of it, two optional layers:

  • Tiers: different rates based on total hours — to reward the most present.
  • Peak-time multiplier (Bonus): multiplying points during a set time window to encourage attendance then.

Note

Points are calculated automatically at check-out based on the session's duration. If the system isn't enabled, no points are awarded and attendance tracking isn't affected.

Member commands

🏆 Points leaderboard

1. Khalid: 1240.00 💎

2. Sara: 980.00 💎

3. Ahmed: 845.00 💎

4. Noura: 612.00 💎

A simulation of the points leaderboard from the /points leaderboard command

/points balance

Shows your points balance (or another member's if you specify them).

Usage/points balance [user?]
/points leaderboard

Shows the server's points leaderboard.

Usage/points leaderboard

Managing points (for admins)

/points setupAdmin

Enable the points system with the default settings (one point per hour).

Usage/points setup
/points configureAdmin

Advanced control panel: tiers, the multiplier, and the base rate.

Usage/points configure
/points manageAdmin

Add or subtract points manually for a specific member.

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

Reset the points of a specific member or all members.

Usage/points reset [target] [user?]

From the dashboard

You can manage all points settings visually from the Settings page: enabling the system, setting the base rate, adding tiers, and defining the peak multiplier window — without saving any command syntax.

Dashboard — Settings
Enable the points system
1.0

Tier: +40 hours

Multiplier rate: ×1.5 points per hour

The «Points system» section in the Settings page of the dashboard

4.Reports & analytics

In short
You extract daily, weekly and monthly attendance reports and per-member ones, with the option to export them to Excel. And you can schedule automatic reports per role with /autoreport. As for the dashboard, it gives you visual analytics: peak times, trends, and member comparison.

On-demand reports

Each report is sent to the reports channel, and accepts an export option to export it as a formatted Excel file with a chart:

/dailyreportAdmin

Daily attendance report. Accepts choosing a day from the last 7 days and filtering by role.

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

Weekly attendance report with a statistical summary.

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

Comprehensive monthly attendance report.

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

Detailed report for a single member over a set period.

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

Tip

/leaderboard shows the ranking of members by total attendance hours, with a summary line (count, total, average) and the option to export it to Excel.

Automatic reports

Instead of extracting the report manually every day, link a role to a channel and its daily report is sent automatically at midnight (in your server's time zone):

/autoreport addAdmin

Enable an automatic daily report for a specific role in a chosen channel.

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

Show all enabled automatic reports, and delete what you want.

Usage/autoreport list

Analytics & comparison (dashboard)

The Analytics page turns your data into visuals: total hours and averages, peak times, and the attendance trend over time. And the Comparison page puts several members side by side:

Dashboard — Analytics
1,284
Total hours
32.1
Member average
18
Highest peak

An illustrative shot of the Analytics page in the dashboard

5.Advanced administration

In short
Tools for special cases: /modifytime to adjust a member's hours (add/subtract), /reset to reset records, and commands to manage the admin roles that determine who can use admin commands. And you can change the bot's own appearance with /editbotprofile. Time adjustment and reset are also available visually from the dashboard.

Time adjustment & reset

To correct a member's hours without opening a session, or to reset their records:

/modifytimeAdmin

Adds or subtracts time from a member's hours, with the reason logged.

Usage/modifytime [member] [duration] [reason?]
Example/modifytime member:@Ahmed duration:+2h30m
/resetAdmin

Resets the hours of a specific member or all members.

Usage/reset [member?]

The same two operations are available visually from the Time adjustment page in the dashboard:

Dashboard — Time adjustment
🔍 Search for a member by name or nickname…
+ Add time− Subtract time
2
hours
30
minutes

The «Time adjustment» page in the dashboard — search for a member then add/subtract

Admin roles

Defines which roles are allowed to use admin commands (in addition to the base role in setup). Those with Administrator permission or the server owner always have full access.

/addadminroleAdmin

Add an admin role.

Usage/addadminrole [role]
/removeadminroleAdmin

Remove an admin role.

Usage/removeadminrole [role]
/listadminrolesAdmin

Show the added admin roles.

Usage/listadminroles

Tip

The admin roles (base and additional), in addition to the time zone and the panel's accent color, are all set from the Settings page in the dashboard too.

Bot customization

/editbotprofileAdmin

Change the bot's name and avatar within your server to match its identity. This can also be done from the «Bot customization» page in the dashboard.

Usage/editbotprofile

6.AI assistant

In short
An AI-powered assistant that answers your questions about your team's attendance in natural language — «Who attended the most this week?» — analyzes the data and gives you the answer. Available from the AI assistant page in the dashboard.

What it does

Instead of extracting a report and reading it manually, you ask the assistant a direct question and it reads your server's attendance data and answers: summaries, comparisons, peak times, forecasts, and who was absent or late. All answers are based on your actual data.

How to use it

Dashboard — AI assistant
Who are the top three members by attendance this week?
✦Top this week: Khalid (28 hours), Sara (24), then Ahmed (21).

An illustrative shot of the AI assistant page in the dashboard

Note

The assistant is a helpful analytical tool — for official, precise numbers always refer to the reports. There's also a daily usage limit per user.

You reached the end 🎉

For a quick reference of every command, visit the commands page. And for any question, the support team is ready on Discord.