diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/modules/tickets.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/modules/tickets.mdx new file mode 100644 index 00000000..fca31117 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/modules/tickets.mdx @@ -0,0 +1,130 @@ +--- +sidebar_position: 18 +title: チケット +description: ProBotのチケットシステムのセットアップと管理方法（チケットパネル、カテゴリー、ロール、自動化、フォーム、メッセージ、トランスクリプト、クレーム、チケットログなど）について学びます。 +keywords: + [ + ProBot, + Tickets, + Support, + Ticket Panels, + Ticket Logs, + Discord tickets, + チケット, + サポート, + ] +--- + +# チケット (Tickets) + +ProBotのチケットシステムを使用すると、Discordサーバーにフル機能のサポートチケットシステムを作成できます。メンバーはボタンやドロップダウンからチケットを開くことができ、スタッフチームはダッシュボードからチケットの管理、担当（クレーム）、クローズを行うことができます。 + +:::info + +ここで説明する設定はダッシュボードで管理されます。 + +1. ダッシュボードにアクセスしてログインします。 +2. 左側のメニューからサーバーを選択します。 +3. モジュールを選択し、有効になっていることを確認します。 + +::: + +## 概要 (Overview) + +「概要 (Overview)」タブでは、選択した期間（例: 30日間）のチケット活動の簡単なサマリーを確認できます。以下が表示されます： + +- **総チケット数 (Total Tickets)** — 作成されたチケットの合計数。 +- **オープン中のチケット (Opened Tickets)** — 現在開いているチケット。 +- **クローズ済みのチケット (Closed Tickets)** — すでに閉じられたチケット。 +- **応答時間 (Response Time)** — スタッフの平均応答時間。 + +また、パネルごとの内訳を示す **パネル別チケット (Tickets by Panel)** や、時間の経過に伴うチケット数を示す **日別アクティビティ (Daily Activity)** チャートも表示されます。 + +## チケットパネル (Ticket Panels) + +チケットパネルはチケットシステムの中核です。各パネルでは、ユーザーがどのようにチケットを作成し、そのチケットがどのように処理されるかを定義します。目的に応じて複数のパネルを作成できます（例: 「一般サポート」、「バグ報告」など）。 + +パネルを作成するには、**Create Panel (パネルを作成)** ボタンをクリックします。各パネルには **Edit (編集)** ボタンと、**Duplicate (複製)** または **Delete (削除)** を行うための3点リーダーメニューがあります。 + +### 基本設定 (Basic Settings) + +| 設定 (Setting) | 説明 (Description) | +| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- | +| **パネル名 (Panel Name)** | チケットパネルの名前（例: "チケット"）。 | +| **命名規則 (Naming Scheme)** | チケットチャンネルの命名方法。`{number}` を使用すると、自動的に連番が振られます（例: `ticket-{number}`）。 | +| **ユーザーチケット上限 (User Ticket Limit)** | 1人のユーザーが同時に開くことができるチケットの最大数。 | +| **クールダウン（秒） (Cooldown)** | ユーザーが次のチケットを開けるようになるまでの待機時間。 | +| **パネルの連携 (Attached Panels)** | 他のパネルをリンクさせ、同じメッセージ内に表示されるようにします。 | +| **パネルの有効化/無効化 (Enable/Disable Panel)** | パネルのオン/オフを切り替えます。 | + +### 外観 (Appearance) + +ユーザーがチケットパネルを操作する方法を選択します： + +- **ボタン (Button)** — ユーザーはボタンをクリックしてチケットを作成します。 + - **絵文字 (Emoji)** — ボタンに表示する絵文字（任意）。 + - **ボタンスタイル (Button Style)** — カラースタイルを選択します（例: プライマリブルー）。 + - **ボタンラベル (Button Label)** — ボタン上のテキスト（例: "チケットを作成"）。 + +- **ドロップダウン (Dropdown)** — ユーザーはドロップダウンメニューから選択します。 + - **ドロップダウンプレースホルダー (Dropdown Placeholder)** — ドロップダウンに表示されるプレースホルダーテキスト。 + - **ドロップダウンオプション (Dropdown Options)** — 各オプションには **絵文字 (Emoji)**、**ラベル (Label)**、**説明 (Description)** があります。 + +### カテゴリー (Categories) + +チケットをDiscordチャンネルのカテゴリーに整理します： + +| 設定 (Setting) | 説明 (Description) | +| -------------------------------------------------------- | ---------------------------------------------------------------- | +| **チケットオープンカテゴリー (Ticket Open Category)** | 新規/オープン中のチケットチャンネルが作成されるカテゴリー。 | +| **チケットクローズカテゴリー (Ticket Closed Category)** | クローズされたチケットチャンネルが移動されるカテゴリー。 | +| **チケットクレームカテゴリー (Ticket Claimed Category)** | 担当者が割り当てられたチケットチャンネルが移動されるカテゴリー。 | + +### 権限とロール (Permission & Roles) + +チケットにアクセスおよび管理できるユーザーを制御します： + +| ロール (Role) | 説明 (Description) | +| -------------------------------------------- | ---------------------------------------------------------------- | +| **スタッフロール (Staff Roles)** | チケットを閲覧し、対応できるロール。 | +| **管理者ロール (Admin Roles)** | チケットに対する完全な管理権限を持つロール。 | +| **ブラックリストロール (Blacklisted Roles)** | チケットの作成を禁止されているロール。 | +| **ホワイトリストロール (Whitelisted Roles)** | 制限（クールダウンなど）をバイパスできるロール。 | +| **メンションロール (Ping Roles)** | 新しいチケットが作成されたときにメンション（Ping）されるロール。 | + +### 自動化 (Automation) + +一般的なチケット操作を自動化します： + +| 設定 (Setting) | 説明 (Description) | +| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | +| **自動クローズ（時間） (Auto-close After)** | 指定した時間、非アクティブなチケットを自動的にクローズします。無効にするには `0` に設定します。 | +| **自動削除（時間） (Auto-delete After)** | 指定した時間経過後にクローズされたチケットを自動的に削除します。無効にするには `0` に設定します。 | +| **最初のメッセージを自動ピン留め (Auto-pin First Message)** | チケットチャンネルの最初のメッセージを自動的にピン留めします。 | +| **トピックの必須化 (Require Topic)** | チケットを開く際に、ユーザーにトピックの入力を義務付けます。 | + +### フォーム設定 (Form Settings) + +チケット作成時にユーザーにフォームへの入力を必須にすることができます： + +- **フォームの必須化 (Require Form)** — フォームの有効/無効を切り替えます。 +- **フォームタイトル (Form Title)** — フォームの上部に表示されるタイトル。 + +#### フォームフィールド (Form Fields) + +各フォームフィールドには以下のオプションがあります： + +| オプション (Option) | 説明 (Description) | +| ------------------------------------ | ------------------------------------------------------------------------------------------------- | +| **ラベル (Label)** | フィールドの名前（例: "どのような問題ですか？"）。 | +| **フィールドスタイル (Field Style)** | **短いテキスト（1行）(Short Text)** または **長いテキスト（複数行）(Long Text)** から選択します。 | +| **プレースホルダー (Placeholder)** | フィールド内に表示されるプレースホルダーテキスト（任意）。 | +| **最小文字数 (Min Length)** | 回答の最小文字数。 | +| **最大文字数 (Max Length)** | 回答の最大文字数。 | +| **必須 (Required)** | このフィールドへの入力が必須かどうか。 | + +**+ Add Field (+ フィールドを追加)** をクリックして複数のフィールドを追加でき、削除ボタンを使用してフィールドを削除できます。 + +### パネルメッセージ (Panel Messages) + +チケットのライフサイクルのさまざまなイベントで送信されるメッセージをカスタマイズします。各メッセージは、プレーンテキスト、または色、作成者、タイトル、説明、画像を含む \*\*