> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# チケットボットセットアップガイド

> ライセンスキーから稼働中の Discord チケットボットまで、約 10 分。

EchoAuth Tickets は、あなた用の Discord チケットボットをホスティングします。ライセンスキーでアカウントを作成し、ブラウザ上でボットを設定して、ワンクリックでデプロイします。サーバーも、プログラミングも必要ありません。

> [!NOTE]
>
> **開始前に、以下をご用意ください：**
>
> * SellAuth の請求書に記載されたライセンスキー（`ECHO-XXXXX-XXXXX-XXXXX-XXXXX` のような形式）
> * Discord サーバーの管理者権限
> * [Discord Developer Portal](https://discord.com/developers/applications) でアプリケーションを作成できる Discord アカウント

## 1. アカウントを作成する

**1. 登録ページを開く**

EchoAuth Tickets パネルを開き、ログインフォームの下にある **Create an account** をクリックします。請求書のリンクから開いた場合は、ライセンスキーがすでに入力されています。

**2. ライセンスキーとログイン情報を入力する**

**ライセンスキー**を貼り付け、**ユーザー名**（3〜32 文字：英数字、`.`、`_`、`-`）と、8 文字以上の**パスワード**を設定して、**Create account** をクリックします。

![ライセンスキー、ユーザー名、パスワードの入力欄がある Create your account フォーム](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/register.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=963b556456e896df44c36bf5111ac365)

SellAuth の請求書に記載されたライセンスキーで登録します

**3. ダッシュボードを確認する**

ダッシュボードが表示されます。ライセンスの残り日数、ボットのステータス、**Getting started** チェックリストが表示されます。チェックリストの各項目は、対応する設定を開きます。

![有効なライセンス、未デプロイのボット、スタートチェックリストを表示するダッシュボード](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=afdb4921c1fac548a8e7ea01642dcfdb)

登録直後のダッシュボード。セットアップ進捗は 0/6

## 2. Discord ボットを作成する

チケットボットは、あなた自身の Discord アプリケーション上で動作します。Discord Developer Portal で一度だけ作成します。

**1. アプリケーションを作成する**

[Discord Developer Portal](https://discord.com/developers/applications) を開き、**New Application** をクリックします。名前（例：ショップ名）を付けて作成します。

**2. 特権 intents を有効にする**

**Bot** タブを開きます。**Privileged Gateway Intents** で、3 つすべてをオンにします：

* **Presence Intent**
* **Server Members Intent**
* **Message Content Intent**

**Save Changes** をクリックします。

> [!WARNING]
>
> これらの intents がオフのままだと、ボットが起動しないか、チケット内のメッセージを読めません。

**3. ボットトークンをコピーする**

引き続き **Bot** タブで、**Reset Token** をクリックしてトークンをコピーします。次のセクションで、パネルに貼り付けます。

> [!WARNING]
>
> ボットトークンはパスワードと同じです。共有したり、どこかに投稿したりしないでください。漏えいした場合は、ここでリセットし、新しいトークンをパネルに貼り付けてください。

**4. ボットをサーバーに招待する**

**OAuth2 → URL Generator** を開きます。`bot` と `applications.commands` のスコープを選び、権限として **Administrator** を選択します。生成された URL を開いて、ボットをサーバーに追加します。

**5. Discord で開発者モードを有効にする**

Discord で **User Settings → Advanced** を開き、**Developer Mode** をオンにします。これで、サーバー、チャンネル、カテゴリ、ロールを右クリックして **Copy ID** を選べるようになります。次の手順でこれらの ID が必要です。

## 3. ボットを設定する

サイドバーの **Configuration** をクリックします。設定はタブごとにまとまっています。右側の **Live preview** には、入力に合わせて Discord 上でのメッセージの見え方が表示されます。

何かを変更すると、ページ下部にバーが表示されます。**Save** で変更を保持するか、**Save & Deploy** で保存して直ちに新しい設定でボットを再起動します。

**1. General：トークンとサーバー ID を追加する**

**General** タブで、次を入力します：

* **Bot Token**：Developer Portal で取得したトークン
* **Server ID**：サーバーアイコンを右クリックして **Copy Server ID** を選択
* **Owner User ID**（任意）：あなた自身の Discord ユーザー ID。このユーザーは常に SellAuth の管理コマンドを使えます。
* **Owner Role ID**（任意）：`/refund`、`/remove_password`、`/add_customer_balance`、`/redo_delivery`、`/replace` を使えるロール

![ボットトークン、サーバー ID、オーナーユーザー ID を入力した General 設定タブと、未保存の変更バー](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/general.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=c550d06ff7725d8856d3712e44097982)

トークンとサーバー ID を入力した General タブ。下部に保存バーが表示されます

**2. Ticket Behavior：ログチャンネルを選ぶ**

**Ticket Behavior** タブで **Logs channel ID** を設定します。ボットはここにチケットのログを投稿します。これがないと `/panel` は動作しません。Discord でそのチャンネルを右クリックして **Copy Channel ID** を選択します。

ユーザーごとに同時に開けるチケット数、クールダウン、チケットを閉じられるのをスタッフのみにするか、閉じたチケットを削除ではなくアーカイブするかも設定できます。

![ログチャンネル ID を入力した Ticket Behavior タブ](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-behavior.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=b73fdb6598b4fd49b20c56671d6b65ca)

Ticket Behavior タブ。ログチャンネルは必須です

**3. Categories：チケットを開く場所と返信できるユーザーを設定する**

**Categories** タブで、左側のカテゴリ（例：**General Support**）を選び、次を入力します：

* **Discord category ID**：新しいチケットが作成されるチャンネルカテゴリ。Discord でそのカテゴリを右クリックして **Copy Category ID** を選択します。
* **Support roles**：ロール ID を貼り付けて **Enter** を押します。これらのロールを持つメンバーは、このカテゴリ内のチケットを閲覧し、返信できます。

使用するカテゴリごとに繰り返します。さらにカテゴリを使うには、いずれかを開いて **Enabled** をオンにします。ボタンモードでは最大 5 カテゴリ、ドロップダウンモードでは最大 8 カテゴリが表示されます。**Form** では、チケットが開く前にユーザーが答える質問を最大 5 つ追加できます。

![Discord カテゴリ ID とサポートロールを入力した Categories タブと、横にチケットメッセージのプレビュー](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/categories.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=82fa0f8f57ffe9b5cd68eaf5b5c1b4d3)

カテゴリ 1。Discord カテゴリ ID とサポートロール 1 つを設定

> [!TIP]
>
> フォームフィールドの **Function** を **SellAuth invoice lookup** に設定すると、顧客が請求書 ID を入力したときに、ボットが注文を自動で検索します。

**4. Ticket Panel：メンバーがクリックするメッセージをデザインする**

**Ticket Panel** タブで、パネルのタイトル、メッセージ、色、画像、フッターを編集します。**Use a dropdown menu** をオンにすると、ボタンの代わりにドロップダウンでカテゴリを表示します。プレビューは入力に合わせてリアルタイムに更新されます。

![Ticket Panel タブと、カテゴリのドロップダウンがある Support Center パネルの Discord プレビュー](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-panel.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=8eb97253931ed5ad11efb96f41c8cbba)

Discord のライブプレビュー付き Ticket Panel タブ

**5. SellAuth（任意）：ショップを接続する**

SellAuth コマンド（`/invoice`、`/refund`、`/replace` など）と請求書の検索を使うには、**SellAuth** タブを開き、**API key**（dash.sellauth.com → Account → Developers）、**Shop ID**、**Shop currency**、**Shop domain** を入力します。

![API キー、ショップ ID、通貨、ドメインの入力欄がある SellAuth 連携タブ](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/sellauth.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=27f8ddc2f4a8db61dabb08029b3130cb)

SellAuth タブ

## 4. ボットをデプロイする

**Dashboard** に戻ります。チェックリストの最初の 5 項目にチェックが付いたら、**Deploy** をクリックします。ボットは数秒で起動し、サーバー上でオンラインになります。

![6 つのセットアップ手順のうち 5 つが完了し、Deploy ボタンが表示されたダッシュボード](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard-ready.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=e7426998aad99958eb32136d3d4b948f)

すべての設定が完了。あとはデプロイするだけです

初回のデプロイ後は、Configuration ページの **Save & Deploy** で以降の変更を反映します。

> [!NOTE]
>
> デプロイに失敗した場合は、サイドバーの **Logs** を開いてください。最もよくある原因は、ボットトークンの誤り、または Developer Portal の intents がオフになっていることです。

## 5. Discord でチケットパネルを投稿する

Discord サーバーで、メンバーがチケットを開くチャンネルに移動して、次を実行します：

```text theme={null}
/panel
```

このコマンドの実行には **Administrator** 権限が必要です。ボットがそのチャンネルにパネルを投稿します。メンバーはカテゴリを選び、フォームに回答すると、本人とサポートロール用のプライベートなチケットチャンネルが開かれます。

## ライセンスを更新・延長する

サイドバーの **License & Account** を開きます。**Redeem a license key** に新しいキーを貼り付けて **Redeem** をクリックします。時間は現在の期限日に加算されるため、日数を失うことなく早めに延長できます。このページでパスワードも変更できます。

![ライセンスキーの引き換えフォーム、パスワード変更フォーム、ライセンス履歴がある License and Account ページ](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/account.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=ae5f1857dd2f29e1320e152fe5a2ff17)

License & Account ページ

> [!WARNING]
>
> ライセンスが期限切れになると、ボットは停止します。設定とトランスクリプトは保持されます。新しいキーを引き換えて再デプロイすると、ボットが再びオンラインになります。

## トラブルシューティング

> [accordion] ボットはオンラインだが、スラッシュコマンドが表示されない
>
> ボットの招待時に `applications.commands` スコープを使ったこと、そして **Configuration → General → Commands** の **Slash commands** がオンになっていることを確認してください。新しいコマンドが Discord に表示されるまで数分かかる場合があります。Discord を再起動すると改善することが多いです。

> [accordion] /panel が何も起こらない
>
> **Ticket Behavior** タブの **Logs channel ID** が、サーバー内に実在するチャンネルを指していること、そして自分が Administrator 権限を持っていることを確認してください。

> [accordion] チケットが違う場所に開く、またはスタッフに見えない
>
> **Categories** タブで、そのカテゴリの **Discord category ID** と **Support roles** を確認してください。設定はカテゴリごとに独立しています。また、ボットのロールがそのカテゴリのチャンネルを管理できることも確認してください。

> [accordion] キーでアカウントを作成できない
>
> キーは請求書に表示されているとおりにコピーしてください。各キーは一度しか使えません。すでにアカウントをお持ちの場合は、ログインして **License & Account** でそのキーを引き換えてください。

解決しませんか？ [サポートサーバー](https://discord.echoauth.dev)でチケットを作成してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.