Finesse Bot
自動出席送信システム — v1.0
使い方ガイド
本Botはスラッシュコマンド（/コマンド）で操作します。コマンドはサーバにBotが追加され、applications.commands スコープが有効である必要があります。
/register
ポータル情報の登録
/register <学籍ID> <パスワード>
/delete
登録情報の削除
/delete
/timetable
今日の時間割表示
/timetable
/timetable_week
今週の時間割表示
/timetable_week
/attend
手動出席処理（結果をDMで受け取る）
/attend
仕様と制限
出席処理のタイミング
授業開始前後の時間帯に自動処理を実行。手動で/attendを実行する場合は、授業開始の5分前〜終了時刻までに実行するのが安全です。
時間割取得の更新頻度
時間割の自動更新は通常24時間以内に1回程度行われます。頻繁に時間割を更新するとAPI負荷が上がるため、適切な間隔を保っています。
手動実行の頻度制限
同一ユーザーが短時間に何度も/attendを実行すると失敗する可能性があります。5分以上の間隔を空けてください。
操作の注意点
- 登録時の注意:
/registerで登録した学籍IDやパスワードはDiscordアカウントと紐づけされて保存されます。共有PCや他人とアカウントを共有しているアカウントでは登録を避けてください。 - DMの受信設定:
/attendの結果はDMで届きます。DMを受け取れない設定にしていると結果を受け取れないので、BotからのDMを許可してください。 - コマンドのエラー時: 登録時にエラーメッセージが表示されたら、まず学籍IDとパスワードを再確認してください。それでもダメな場合は管理者に問い合わせてください。
よくある質問（FAQ）
"管理者の許可が必要" と出ます。どうすれば良い？
すべてのコマンドはホワイトリスト登録が必要です。管理者にあなたのDiscord IDを通知し、ホワイトリストに追加してもらってください。
登録情報はどれくらい保存されますか？
管理者が削除するまで保存されます。不要になったら/deleteを実行してください。
どの時間に自動出席が行われますか？
サーバ側でスケジュール設定されていますが、通常は授業開始後の開始直後～数分に自動で処理するようになっています。
出席に失敗したときはどうしたら良いですか？
失敗理由によって異なります。まずDMのエラーメッセージを確認し、学籍IDやパスワードが正しいかを確認してください。サイト側の障害であれば時間をおいて再試行してください。必要なら管理者にエラー文とともに問い合わせてください。
利用ルールとサポート
迷惑行為と利用ルール
他人になりすます（他人の学籍IDで登録する）、Botを過負荷にする目的で連続実行する等の迷惑行為は禁止します。発覚した場合、ホワイトリストからの除外や管理者側の対応を受ける可能性があります。
トラブル時の連絡手順
-
01
情報収集
Botから届くDMのメッセージをスクリーンショットまたはコピー。
-
02
管理者へ連絡
サーバの管理者に状況を伝え、必要なら
error.logを確認してもらう。 -
03
対応実施
管理者の指示に従って再登録や再試行を行ってください。