Discordボットを作成する

Discordからメッセージをコピーするには、自分のアカウントを使えます。 **元のサーバーにボットを招待する必要はありません。サーバーを所有したり、管理者になったりする必要もありません。**自分のアカウントから、コピーしたいチャンネルにアクセスできれば十分です。アカウントを使う場合はDiscordアカウントを接続するをご覧ください。

Discordボットは、コピーしたテキストや画像、動画、ファイルなどの対応メディアをDiscordサーバーに送信できます。Discordの送信元からはDiscord埋め込みも転送できます。転送オプションでメッセージの種類を選びます。送信先サーバーのアップロード上限は引き続き適用されます。アカウントの代わりにボットを使い、元のメッセージを読み取ることもできます。

• **アカウントで読み取り、ボットで配信する場合：**コピーを受け取るサーバーだけにボットを招待します。
• **ボットでも読み取る場合：**元のサーバーにもボットを招待し、コピーするチャンネルへのアクセス権を付与します。

**コードを書く必要も、ボットをホストする必要もありません。**ForwardMsgがボットを実行します。

Discordでボットを作成する

1. Discord Developer Portalを開きます。
2. New Applicationを選択します。
3. Community Forwarderなど、識別しやすい名前を入力します。
4. Createを選択します。
5. アプリケーションの左側メニューでBotを開きます。

Discordでは、ボットの設定をapplicationとして管理します。Botページで名前、画像、ログイントークンを設定します。

ボットトークンをコピーする

ボットトークンはボット用のパスワードです。個人のDiscordアカウントのトークンとは別のものです。

1. BotページでTokenを探します。
2. Reset Tokenを選んで、コピー可能なトークンを生成します。
3. Discordの確認を完了します。
4. トークンをコピーし、非公開にしてください。

以下の2つのセクションでは、招待する前に設定を確認／変更する場所を説明します。

メッセージ本文を読み取れるようにする

Discordでは、これらのスイッチをintentsと呼びます。ForwardMsgでは、以下の2つを有効にします。ボットがコピーを送信するだけ、メッセージを読み取る、または両方を行う場合の推奨設定です。インテントは、チャンネルで閲覧や投稿を可能にする権限とは別のものです。

1. Developer PortalでBotを開きます。
2. Privileged Gateway Intentsを探します。
3. Server Members IntentとMessage Content Intentをオンにします。
4. Discordに保存ボタンが表示された場合は変更を保存します。

必要な権限を選ぶ

以下は、ボットを招待するときに既定でリクエストされる権限です。招待リンクを使う前に設定または確認してください。

1. Developer PortalでInstallationを開きます。
2. Installation ContextsでGuild Installを有効にします。GuildはDiscordでサーバーを指す言葉です。
3. Default Install SettingsにあるGuild Install設定を探します。
4. サーバーにボットを追加するためのbotスコープを含めます。ForwardMsgの転送でスラッシュコマンドは使いません。コマンドを設定する必要はありません。
5. 下記の権限を確認します。ForwardMsgの標準招待リンクでは、以下すべてをリクエストします。
6. Portalで求められた場合は保存します。

標準招待に含まれる権限

選択した転送機能をすぐ使えるよう、既定の権限を選択したままにします。下記には任意機能だけに必要な権限もありますが、機能を有効にしないまま選択しておけます。

動作に応じた任意の権限

これらの権限も標準招待に含まれます。対応する機能を使う場合のみ必要です。

ボットにAdministratorを付与する必要はありません。インストール後、実際のサーバーとチャンネルで権限を確認してください。Discordの権限リファレンスで各設定を説明しています。

すでにサーバーに参加しているボットの場合、Portalで既定値を変更しても既存のサーバーアクセスは更新されません。DiscordでServer Settings → Rolesを開き、ボットのロールを選択してPermissionsを確認します。特定のチャンネルでは、Edit Channel → Permissionsを開き、ボットのロールまたは個別のエントリを確認します。サーバーロールで許可されていても、カテゴリやチャンネルのルールで拒否される場合があります。

サーバーにボットをインストールする

**メッセージ配信には、コピーを受け取るサーバーにボットを追加してください。**アカウントで元のメッセージを読み取る場合、ボットを元のサーバーに参加させる必要はありません。ボットにも読み取りをさせる場合だけ、元のサーバーに追加します。

ForwardMsgでDiscordボットを追加を行う際、送信先サーバーに追加から招待ページを開きます。受信サーバー、または読み取り用ボットを設定する場合は元のサーバーを選択します。Discordで認証し、ForwardMsgに戻って完了を選択します。すでに正しいサーバーにいる場合は、再招待せずに完了を選べます。

Developer Portalから招待することもできます。

1. Developer PortalでInstallationを開きます。
2. Install LinkでDiscord Provided Linkを選択します。
3. リンクをコピーし、Discordにサインインした状態でブラウザーから開きます。
4. Add to serverを選び、対象のサーバーを選択します。
5. Authorizeを選択し、Discordの確認を完了します。
6. そのサーバーのメンバー一覧にボットが表示されることを確認します。

サーバーの所有者、管理者、またはManage Server権限のある人が招待できます。該当しない場合は、サーバー管理者に招待を依頼してください。自分のアカウントでメッセージをコピーする場合、元のサーバーでこの権限は必要ありません。

Developer Portalのレイアウトが変わった場合は、Discordのインストールガイドをご覧ください。

メッセージ読み取りのために接続する

1. メッセージの読み取りにDiscordボットを使う自動化を開き、送信元で追加 Discordボットを選びます。
2. ボットトークンを貼り付けて追加を選択します。
3. ForwardMsgで表示名をそのまま使うか変更し、続行を選択します。
4. まだ参加していない場合は、送信先サーバーに追加から読み取り対象のサーバーに招待し、Discordで認証します。
5. ForwardMsgに戻って完了を選択します。
6. 送信元でボットが選択されていることを確認します。
7. 設定を更新を選択します。
8. 開始を選択し、実行中になるまで待ちます。
9. 読み取り対象のサーバーとチャンネルを追加します。

送信元は元のメッセージがある場所です。監視したいチャンネルだけを選びます。

メッセージ送信のために接続する

ボットがすでに保存されている場合は、トークンを再入力せず選択し、受信チャンネルを選ぶ手順に進みます。

1. エディターの左側の一覧で、送信元チャット／チャンネルをクリックして設定を開きます。
2. ルーティングを開きます。
3. 送信先を追加を選択します。
4. ボットがまだ保存されていない場合は追加 Discordボットを選択します。
5. トークンを貼り付けて追加を選択します。
6. ForwardMsgで表示名をそのまま使うか変更し、続行を選択します。
7. 必要に応じて送信先サーバーに追加から受信サーバーに招待し、Discordで認証します。
8. ForwardMsgに戻って完了を選択します。
9. ボットと、コピーの受信先チャンネルを選択します。
10. 送信先ダイアログを完了します。
11. 変更を保存を選択します。

送信先はコピーの受信場所です。ボットが各チャンネルにアクセスできれば、同じボットから複数のチャンネルへ送信できます。

**転送ルート間で同じボットを再利用してください。**ほかのルーティング送信先や自動化で保存済みボットを選べばよく、チャットやルートごとにボットを作り直す必要はありません。各受信サーバーにボットを招待し、該当するチャンネルへのアクセス権を付与します。

自動化経由で新しいテキストメッセージを送って結果を確認します。1つのチャンネルだけ失敗する場合は、そのチャンネルでのボットの権限を確認してください。

ForwardMsgによる自動設定を確認する

Discordボットを追加からトークンを保存すると、ForwardMsgは対応するインテント、Guild Install、メッセージの読み取りと送信に必要なインストールの既定値を設定します。

1. Developer Portalに戻り、ページを再読み込みします。
2. Bot → Privileged Gateway Intentsを開き、Message ContentとServer Membersを確認します。
3. Installationを開き、Guild Installと既定の権限を確認します。
4. まだ招待していない場合はボットを招待し、ForwardMsgで受信チャンネルを選択します。

各Portalの項目を手動で変更しなくても、この方法を使えます。設定が更新されていない場合は、上記の手動手順に従ってください。

ボットは接続するが、メッセージを送信できない

接続済みとは、ForwardMsgがボットとしてログインできたという意味です。すべての受信チャンネルでボットに投稿が許可されているとは限りません。

• サーバーとチャンネルを確認する：受信サーバーにボットがいて、対象チャンネルでチャンネルを見るとメッセージを送信が許可されている必要があります。スレッドではスレッドでメッセージを送信も必要です。
• 認証／ゲートキーパーボットを確認する：VerifiedやMemberなどのロールを得るまでチャンネルを表示しないサーバーがあります。新しく招待されたボットにロールが自動付与されない場合があります。管理者に適切なロールを付与してもらうか、受信チャンネルでボットを明示的に許可してもらってください。たとえば、#newsに投稿できるのがVerifiedロールのメンバーだけなら、ボットにも同じアクセス権が必要です。
• コンテンツの種類を確認する：アップロードにはファイルを添付、埋め込みにはリンクを埋め込むを許可します。Webhookを有効にする場合はWebhookの管理も許可します。
• **トークンを確認する：**トークンをリセットまたは無効にした場合は、新しいトークンでボットを追加し、使用中の保存済み接続を置き換えます。

アクセスを修正した後、ルーティングで変更を保存を選びます。必要であれば自動化を再起動し、送信元チャットから新しいメッセージを送って送信先に届くことを確認します。プライベートテストチャットも使えます。

追加の確認項目は配信と権限をご覧ください。

作成者名、返信、ピン留め

通常、ボットメッセージはボット自身の名前とプロフィール画像で表示されます。たとえば、MayaからコピーしたメッセージはCommunity Forwarderというボットの投稿になります。メッセージ形式を使って、本文にMayaの名前を含めることはできます。

Discordの投稿自体にMayaの名前とアバターを表示するには、Webhookで配信します。コピーごとに元の作成者の情報を使えるため、すべての投稿が同じボットプロフィールになることはありません。

接続済みボットに次の処理を自動で行わせることもできます。

1. 受信チャンネルでWebhookの管理権限を付与します。
2. ForwardMsgで、左側の一覧から送信元チャットをクリックして設定を開くか、継承するすべての場所に適用する場合は全体設定をクリックします。
3. 詳細 → 作成者名とアバター写真を使用して送信を開きます。
4. Webhookを有効にするをオンにします。
5. 変更を保存を選び、自動化から新しいメッセージを送り、Discordで名前と画像を確認します。

ボットは配信のためにWebhookを作成／管理します。この設定では、受信チャンネルごとに手動でWebhookを作成する必要はありません。

返信やピン留めが必要なルートでは、Webhookを有効にするをオフにします。メッセージ操作の同期と詳細設定をご覧ください。

トークンを非公開にする